Hermes Agent è un agent AI open source di Nous Research che gira dal tuo terminale, si collega a diversi provider di modelli, ricorda il contesto utile tra le sessioni ed è estendibile con strumenti, skill, gateway di messaggistica e automazioni. Questa guida ti aiuta a capire come installare Hermes. Non devi installare manualmente Python o Node.js per l'installer standard su macOS o Windows, perché l'installer ufficiale gestisce per te le dipendenze principali.
Prima di installare Hermes Agent
Hermes Agent è un software pensato prima di tutto per il terminale, quindi lo installerai da riga di comando. Scegli la sezione adatta al tuo computer:
macOS: apri Terminale da Applicazioni > Utility > Terminale, oppure premi Command + Spazio e cerca "Terminale".
Windows: installa prima WSL2, apri il terminale della tua distribuzione Linux, quindi segui il comando per Linux.
Ti serve anche Git. Verifica se Git è installato:
Output previsto:
Se vedi git: command not found, installa prima Git:
Se non hai Homebrew su macOS, installa Git dagli Apple Command Line Tools eseguendo:
Passo 1: installare Hermes Agent su macOS o Windows
Nel terminale, copia e incolla il comando ufficiale di installazione:
L'installer scarica Hermes Agent, prepara il suo ambiente Python, installa le dipendenze necessarie e aggiunge il comando hermes al path della tua shell. In un'installazione normale da utente, i dati di Hermes vengono salvati in ~/.hermes/.
Al termine del comando, ricarica la shell:
Se usi Zsh, comune su macOS, esegui:
Risultato previsto:
Ora verifica che il comando di Hermes Agent sia disponibile:
Risultato previsto:
Il numero esatto di versione può cambiare con gli aggiornamenti di Hermes Agent.
Passo 2: configurare il provider del modello
Hermes Agent ha bisogno di un provider di modelli prima di poter rispondere o usare strumenti. La configurazione più semplice per iniziare è quella interattiva:
La procedura guidata ti permette di scegliere un provider come Kimi/Moonshot. Non configurare routing, fallback, gateway o cron finché una chat di base non funziona.
Seleziona il modello predefinito. kimi-k2.6 è il modello più avanzato di Kimi finora disponibile.
Se conosci già il valore che vuoi impostare, puoi usare hermes config set. Ad esempio:
Se non hai una api-key, Kimi potrebbe essere una scelta interessante.
Passo 1: attivare la tua Kimi API
Prima di usare la Kimi API con Hermes Agent, attiva la tua Kimi API Key nel Kimi Platform. Ti consigliamo almeno 20$ per sbloccare l'accesso Tier 2, che riduce la latenza e garantisce prestazioni più stabili per attività complesse e multi-step
Passo 2: creare la tua Kimi API Key
Vai alla sezione API Keys su Kimi Platform e clicca su Create API Key. Ricordati di copiare la tua API key e conservarla in modo sicuro, perché viene mostrata solo una volta al momento della creazione.
Passo 3: inserire la tua API key
Incolla la tua Kimi API key e collega Hermes Agent.
Passo 3: avviare Hermes Agent
Una volta configurato il modello, avvia la classica CLI:
Oppure prova la nuova interfaccia terminale:
Dovresti vedere una schermata di benvenuto o un prompt che mostra il provider/modello selezionato. Provalo con una semplice richiesta:
Il successo si presenta così:
Se Hermes Agent si apre ma restituisce errori di modello o di autenticazione, esegui:
Poi scegli di nuovo il tuo provider e verifica la chiave API o l'accesso OAuth.
Passaggio 4: trasforma Hermes Agent in un bot
Come OpenClaw, anche Hermes Agent può funzionare come bot e connettersi alle tue app di chat:
Dopo la configurazione, controlla lo stato del gateway:
Usa il gateway solo dopo che il tuo provider di modelli funziona nel terminale. Se la CLI non riesce a completare una chat di base, di solito anche il bot fallirà per lo stesso motivo.
Problemi comuni di installazione di Hermes Agent
hermes: command not found
Causa: il terminale non ha ancora ricaricato la modifica del PATH.
Soluzione:
Oppure:
Poi prova:
git: command not found
Causa: Git non è installato.
Soluzione su Ubuntu, Debian o WSL2:
Soluzione su macOS con Homebrew:
Chiave API non impostata
Causa: Hermes Agent è installato, ma non è configurata alcuna chiave o accesso al provider.
Soluzione:
Oppure imposta una chiave manualmente:
hermes doctor segnala una configurazione mancante o obsoleta
Causa: il file di configurazione potrebbe essere incompleto dopo un aggiornamento.
Soluzione:
L'endpoint personalizzato si connette ma restituisce risposte errate
Causa: l'URL di base, il nome del modello o la lunghezza del contesto sono errati.
Soluzione: testa prima l'endpoint in un client separato, conferma che sia compatibile con OpenAI e assicurati che il modello supporti almeno 64K di contesto per i normali flussi di lavoro di Hermes Agent.
Riferimento rapido ai comandi
Conclusione
Il modo più semplice per installare Hermes Agent è usare l'installer ufficiale a riga singola, ricaricare la shell, eseguire hermes model e verificare la configurazione con una vera chat più hermes doctor. Mantieni semplice la prima configurazione: una macchina, un provider, una conversazione funzionante. Una volta che l'assistente Hermes Agent di base è stabile, puoi ampliarlo tranquillamente con l'isolamento tramite Docker, bot gateway, competenze, automazioni pianificate e provider di modelli personalizzati.
Domande frequenti
~/.hermes/ e può essere esteso con skill, memoria, attività pianificate e gateway di messaggistica.hermes model, scegli un provider, ad esempio Kimi, avvia hermes, prova una normale chat, esegui hermes doctor e verifica che hermes --continue riprenda la sessione. Successivamente, aggiungi isolamento Docker, skill, server MCP, voce, cron o un gateway di messaggistica secondo necessità.