Hermes Agent è un agente IA open source di Nous Research che funziona dal terminale, si connette a diversi provider di modelli, conserva il contesto utile tra una sessione e l'altra e può essere esteso con strumenti, skill, gateway di messaggistica e automazione. Questa guida spiega come installare Hermes. Per l'installazione standard su macOS o Windows non è necessario installare manualmente Python o Node.js, perché l'installer ufficiale gestisce le principali dipendenze.
Prima di installare Hermes Agent
Hermes Agent è un software pensato per il terminale, quindi va installato dalla riga di comando. Scegli la sezione corrispondente al tuo computer:
macOS: apri Terminale da Applicazioni > Utility > Terminale oppure premi Comando + 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 visualizzi git: command not found, installa prima Git:
Se non hai Homebrew su macOS, installa Git dagli Strumenti da riga di comando Apple eseguendo:
Passaggio 1: installa Hermes Agent su macOS o Windows
Nel terminale, copia e incolla il comando dell'installer ufficiale:
L'installer scarica Hermes Agent, prepara il suo ambiente Python, installa le dipendenze necessarie e aggiunge il comando hermes al percorso della shell. In una normale installazione utente, i dati di Hermes vengono memorizzati in ~/.hermes/.
Al termine del comando, ricarica la shell:
Se usi Zsh, comune su macOS, esegui:
Risultato previsto:
Ora verifica che il comando Hermes Agent sia disponibile:
Risultato previsto:
Il numero di versione esatto può cambiare con gli aggiornamenti di Hermes Agent.
Passaggio 2: configura il provider di modelli
Hermes Agent necessita di un provider di modelli prima di poter rispondere o usare gli strumenti. Per iniziare, la configurazione interattiva è la più semplice:
La procedura guidata consente 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 K3 è l'ultimo modello di punta di Kimi; se ti interessa soprattutto la programmazione, kimi-k2.7-code è la scelta migliore.
Se conosci già il valore da impostare, puoi usare hermes config set. Ad esempio:
Se non hai una chiave API, Kimi potrebbe essere una buona scelta.
Passaggio 1: attiva la tua Kimi API
Prima di usare Kimi API con Hermes Agent, attiva la tua chiave API Kimi nella Kimi Platform. Consigliamo di aggiungere almeno $20 per sbloccare l'accesso al Livello 2, che riduce la latenza e offre prestazioni più stabili per attività complesse in più passaggi
Passaggio 2: crea la tua chiave API Kimi
Vai alla sezione API Keys in Kimi Platform e fai clic su Create API Key. Ricorda di copiare la tua chiave API e conservarla in modo sicuro, poiché viene mostrata una sola volta al momento della creazione.
Passaggio 3: inserisci la tua chiave API
Incolla la tua chiave API Kimi e connetti Hermes Agent.
Passaggio 3: avvia Hermes Agent
Dopo aver configurato il modello, avvia la CLI classica:
Oppure prova la nuova interfaccia utente del terminale:
Dovresti vedere una schermata di benvenuto o un prompt che mostra il provider/modello selezionato. Provalo con una richiesta semplice:
Ecco come si presenta un'installazione riuscita:
Se Hermes Agent si apre ma restituisce errori relativi al modello o all'autenticazione, esegui:
Quindi seleziona di nuovo il provider e verifica la chiave API o l'accesso OAuth.
Passaggio 4: trasforma Hermes Agent in un bot
Come OpenClaw, anche Hermes Agent può fungere da bot e connettersi alle tue app di chat:
Dopo la configurazione, controlla lo stato del gateway:
Usa il gateway solo dopo aver verificato che il provider del modello funzioni nel terminale. Se la CLI non riesce a completare una chat di base, il bot di solito non funzionerà per lo stesso motivo.
Problemi comuni nell'installazione di Hermes Agent
hermes: comando non trovato
Causa: il terminale non ha ancora ricaricato la modifica al PATH.
Soluzione:
Oppure:
Quindi prova:
git: comando non trovato
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 sono configurati né una chiave del provider né un accesso.
Soluzione:
Oppure imposta manualmente una chiave:
hermes doctor segnala una configurazione mancante o obsoleta
Causa: dopo un aggiornamento, il file di configurazione potrebbe essere incompleto.
Soluzione:
L'endpoint personalizzato si connette ma fornisce risposte errate
Causa: l'URL di base, il nome del modello o la lunghezza del contesto non sono corretti.
Soluzione: verifica 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 il programma di installazione ufficiale in un'unica riga, ricaricare la shell, eseguire hermes model e verificare la configurazione con una chat reale e hermes doctor. Mantieni semplice la prima configurazione: una macchina, un provider, una conversazione funzionante. Quando l'assistente Hermes Agent di base sarà stabile, potrai ampliarlo in sicurezza con l'isolamento Docker, i bot gateway, le skill, le automazioni pianificate e i provider di modelli personalizzati.
Domande frequenti
~/.hermes/ e può essere estesa con skill, memoria, processi pianificati e gateway di messaggistica.iex (irm https://hermes-agent.nousresearch.com/install.ps1) in PowerShell oppure usare il pacchetto desktop MSIX. WSL2 resta un'alternativa facoltativa.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à.