Hermes Agent: cos’è, come installarlo e configurarlo

Claude Code, Codex, Cursor, OpenClaw: ognuno di questi agenti AI ha un ruolo specifico. Se ti serve un agente che viva sul tuo server, si ricordi di te tra una sessione e l’altra e ti risponda su Telegram mentre sei in taxi, Hermes Agent è adatto a questo scopo.

Hermes Agent è un progetto aperto di Nous Research, ed è molto più facile da installare di quanto molti pensino. Ecco cosa vedremo: che cos’è, quanto costa, come installarlo su Windows, macOS o Linux e come collegargli un modello e un bot Telegram. Tutto si basa sulla documentazione ufficiale.

Che cos’è Hermes Agent, spiegato in modo semplice?#

Hermes appartiene alla stessa categoria di Claude Code o Codex: è un agente AI che non si limita a scrivere risposte, ma apre file, esegue comandi nel terminale e usa un browser. La differenza sta nel modo in cui è costruito: Claude Code è legato ai modelli Anthropic, mentre Hermes funziona con qualsiasi provider di modelli, da Claude e GPT ai modelli locali eseguiti sul tuo hardware.

Il progetto è giovane: il suo repository GitHub è stato creato il 22 luglio 2025. Eppure, al 22 agosto 2026, ha più di 234.000 stelle e 47.000 fork, ed è uno dei progetti aperti in più rapida crescita di questa categoria. Il codice è completamente aperto con licenza MIT: puoi leggerlo, modificarlo e usarlo nei tuoi prodotti senza royalty.

Due meccanismi specifici sono alla base di questo «auto-miglioramento»: competenze e memoria. Le competenze sono procedure che l’agente mette per iscritto dopo attività complesse e applica la volta successiva. La memoria è un file con informazioni su di te e sul tuo ambiente, caricato in ogni nuova conversazione. Entrambi i meccanismi sono trattati qui sotto in una sezione dedicata.

In cosa Hermes Agent è diverso da Claude Code e Codex?#

Le differenze principali sono riassunte in questa tabella:

La tabella chiarisce il punto principale. Claude Code è adatto alle attività che richiedono il modello più potente e si svolgono in un repository: Anthropic offre ancora la combinazione migliore di modello e strumenti. Hermes è pensato per quando ti serve un agente «sempre attivo»: funziona su un server, svolge attività ogni mattina secondo una pianificazione, ti risponde su Telegram e ricorda la conversazione del giorno prima.

Se stai confrontando gli strumenti di base, ci sono guide separate su come installare Claude Code, che cos’è Codex di OpenAI e il panorama degli strumenti di programmazione AI nel 2026.

Quanto costa Hermes Agent nel 2026?#

L’opzione più semplice è Nous Portal, l’abbonamento nativo degli sviluppatori di Hermes. Include più di trecento modelli e anche servizi pronti all’uso: ricerca sul Web, generazione di immagini, sintesi vocale e un browser cloud. Al 22 agosto 2026, i piani sono:

La seconda opzione, spesso trascurata, è che non devi necessariamente sottoscrivere un nuovo abbonamento. Hermes può accedere tramite OAuth, cioè usando un account che possiedi già. Sono supportati gli abbonamenti ChatGPT e Codex, Claude Max, SuperGrok di xAI, Qwen, MiniMax e GitHub Copilot. Scegli un provider durante la configurazione, conferma l’accesso nel browser e pagherai esattamente quanto pagavi prima.

La terza opzione è usare le tue chiavi API. Anthropic, OpenAI, Google, DeepSeek, Z.AI, Kimi, Alibaba e circa una dozzina di altri provider: inserisci una chiave e l’utilizzo viene addebitato direttamente sul relativo account.

La quarta opzione non costa denaro, ma richiede hardware: un modello locale tramite Ollama o LM Studio. È una soluzione adatta se hai un computer potente e non vuoi inviare dati all’esterno. C’è una condizione: il modello deve avere una finestra di contesto di almeno 64.000 token, altrimenti Hermes si rifiuta di avviarsi con quel modello: l’agente ha bisogno di sufficiente memoria di lavoro per le attività lunghe.

Qui non trattiamo le condizioni di pagamento per i servizi stranieri: è un argomento a parte con regole proprie, affrontato in questa guida con Claude Code come esempio.

Come installare Hermes Agent su Windows#

Se non hai dimestichezza con il terminale, inizia dal programma di installazione. Il sito hermes-agent.nousresearch.com offre i pulsanti di download per macOS 12+, Windows 10/11 e Linux. Il file scaricato installa entrambe le app: la riga di comando hermes e Hermes Desktop, una normale finestra con chat, file e impostazioni.

Se hai familiarità con i comandi, installalo tramite PowerShell:

1. Apri PowerShell

   Premi Win, digita PowerShell e aprilo. Non sono necessari i privilegi di amministratore.

2. Esegui il programma di installazione

   iex (irm https://hermes-agent.nousresearch.com/install.ps1)
   

   Lo script scarica tutto ciò che serve: Python 3.11, Node.js 22, il gestore di pacchetti uv, ripgrep e ffmpeg. Se non hai Git, installa la propria versione isolata di MinGit, conservata separatamente e senza modificare i programmi di sistema.

3. Riavvia il terminale e verifica

   hermes doctor
   

   Il comando mostra cosa è installato, cosa manca e come risolvere il problema. Se vedi segni di spunta verdi, l’installazione è completa.

Con questo metodo, i file vengono archiviati in %LOCALAPPDATA%\hermes. Se usi WSL2, funziona anche il comando Linux della sezione successiva: scegli il metodo più comodo.

Come installare Hermes Agent su macOS e Linux#

Hermes si installa con un comando, su un portatile o su un server. Ecco l’intero processo:

1. Verifica che Git sia installato

   git --version
   

   Se il comando restituisce un numero di versione, continua. Su Linux verifica anche la presenza di curl e xz-utils: su Debian e Ubuntu, installali con sudo apt install curl xz-utils.

2. Esegui il programma di installazione

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
   

   Lo script clona il repository in ~/.hermes/hermes-agent, crea un ambiente virtuale e installa il comando hermes in ~/.local/bin. Per un server senza interfaccia grafica e automazione del browser, è disponibile un’opzione leggera: aggiungi bash -s -- --skip-browser alla fine.

3. Ricarica la shell e avvia

   source ~/.zshrc   # su macOS; più spesso su Linux: source ~/.bashrc
   hermes
   

Se installi come root, i file vengono salvati nei percorsi di sistema /usr/local/lib/hermes-agent e /usr/local/bin/hermes, una soluzione comoda per un server usato da più account. Impostazioni, chiavi e memoria restano nella cartella personale ~/.hermes di ciascun utente.

Una nota su Hermes Desktop per Linux: per compilare l’app su Debian e Ubuntu servono i compilatori inclusi nel pacchetto build-essential (sudo apt install build-essential). Se hai installato Hermes con il comando, non ti serve un programma di installazione separato: esegui hermes desktop e l’app si avvierà con le impostazioni, le sessioni e le competenze già esistenti.

Come collegare un modello a Hermes Agent#

Il modello è il motore di Hermes: l’agente non pensa da solo, ma contatta il modello che hai scelto. Perciò, il primo passo dopo l’installazione è scegliere a cosa si connetterà:

hermes model

La procedura guidata ti chiederà un provider, un metodo di accesso e un modello. Ci sono molte opzioni; le principali sono:

Se scegli Nous Portal, un solo comando esegue tutte le operazioni:

hermes setup --portal

Si aprirà una pagina di accesso nel browser. Dopo la conferma, imposterà Nous come provider e attiverà Tool Gateway: ricerca sul Web, generazione di immagini e sintesi vocale senza chiavi separate per ogni servizio.

Hermes conserva chiavi e impostazioni separatamente, ed è importante capirlo fin dall’inizio. I segreti, cioè chiavi API e token, sono salvati in ~/.hermes/.env. Le impostazioni normali si trovano in ~/.hermes/config.yaml. Non serve modificare manualmente questi file: hermes config set inserisce automaticamente ogni valore nel file corretto:

Trova guide agli strumenti nella documentazione di Ailoot

La procedura guidata completa è hermes setup. Ha tre modalità: configurazione rapida tramite Nous Portal, configurazione completa in cui scegli personalmente ogni provider e strumento, e Blank Slate, un’installazione pulita in cui tutto è disattivato tranne gli elementi essenziali, così puoi attivare solo quello che ti serve.

Come verificare che Hermes Agent funzioni#

Dopo aver scelto un modello, avvia una conversazione:

hermes          # interfaccia classica
hermes --tui    # interfaccia moderna, con supporto del mouse e finestre pop-up

Il messaggio di benvenuto mostra il modello selezionato, gli strumenti attivati e le competenze. Poi non chiedere «ciao, chi sei?»: assegnagli un’attività con un risultato osservabile: «mostrami le cinque cartelle più grandi del disco» oppure «guarda la cartella corrente e dimmi qual è il file principale del progetto». Se l’agente esegue un comando nel terminale e restituisce una risposta significativa, la configurazione di base funziona.

L’ultima verifica riguarda le sessioni. Esci dalla conversazione e rientra:

hermes --continue   # oppure, in breve: hermes -c

Dovresti ritrovarti nella stessa conversazione. Questo verifica che la memoria della sessione venga salvata su disco: in seguito ne dipenderanno il bot e le attività programmate.

Se qualcosa non funziona, segui questo ordine: hermes doctor (diagnostica generale), hermes model (verifica di nuovo modello e accesso), hermes setup (ricrea la configurazione), hermes sessions list e hermes --continue (verifica le sessioni), hermes gateway status (stato del gateway). In un paio di minuti questa sequenza può portarti da «non funziona niente» a una situazione chiara.

Cosa sono le competenze e la memoria in Hermes Agent?#

Una competenza di Hermes è un file SKILL.md con un nome, una descrizione e una procedura passo per passo: per esempio, come assemblare un documento, aprire una pull request o preparare una campagna e-mail. L’agente legge le brevi descrizioni di tutte le competenze, poi carica il testo completo solo quando l’attività corrisponde: così cento competenze installate non appesantiscono ogni richiesta. Lo standard è aperto, agentskills.io, e gli stessi file funzionano anche con altri agenti.

Le competenze si trovano nella cartella ~/.hermes/skills/. Si installano in tre modi: un set di base viene incluso nell’app, le competenze pronte all’uso si aggiungono dal catalogo con hermes skills install e, dopo le attività complesse, l’agente ne scrive di nuove per sé. Ogni competenza diventa automaticamente un comando slash: installa la competenza gif-search e /gif-search funzionerà in qualsiasi chat. L’installazione dal catalogo prevede un controllo di sicurezza, per evitare che le procedure di qualcun altro includano comandi dannosi.

La memoria è ancora più semplice. Ci sono due file in ~/.hermes/memories/: MEMORY.md, gli appunti dell’agente sul suo ambiente e le sue conclusioni, fino a 2.200 caratteri, e USER.md, il tuo profilo: come risponderti, cosa ti piace e cosa non ti piace, fino a 1.375 caratteri. All’inizio di ogni conversazione, entrambi i file vengono aggiunti al prompt di sistema, così l’agente inizia già sapendo alcune cose di te. I limiti sono volutamente rigorosi: la memoria non si dilunga e l’agente decide cosa conservare e cosa eliminare.

Questi due elementi, competenze e memoria, costituiscono il Second Brain: un agente che ricorda il contesto e accumula procedure, lavorando ogni settimana molto meglio rispetto al giorno dell’installazione. Per indicazioni su come scegliere queste competenze ed evitare che l’agente diventi un deposito disordinato, consulta questa guida con Claude Code come esempio: i principi sono gli stessi.

Come collegare Hermes Agent a Telegram#

Telegram è il canale più popolare di Hermes e l’integrazione è ben sviluppata: testo, messaggi vocali con trascrizione, immagini e file, oltre alle risposte nei gruppi. Ecco la procedura:

1. Crea un bot con BotFather

   Apri @BotFather su Telegram, invia /newbot, scegli un nome e un nome utente univoco che termini con bot. Riceverai un token simile a 123456789:ABCdef...: è la chiave del tuo bot, quindi conservala come una password. Se il token viene divulgato, revocalo inviando /revoke allo stesso BotFather.

2. Trova il tuo ID utente

   Trova il tuo ID numerico di Telegram, per esempio 123456789. È il numero del tuo account; non confonderlo con il nome utente. Ti servirà per l’elenco di accesso.

3. Avvia la procedura guidata di configurazione del gateway

   hermes gateway setup
   

   Seleziona Telegram e incolla il token e l’ID. La procedura guidata salverà le impostazioni. Puoi fare lo stesso manualmente con due righe in ~/.hermes/.env: TELEGRAM_BOT_TOKEN=... e TELEGRAM_ALLOWED_USERS=123456789.

4. Avvia il gateway

   hermes gateway
   

   Il bot sarà online in pochi secondi. Scrivigli e verifica la risposta.

L’accesso è chiuso per impostazione predefinita: il bot risponde soltanto agli ID presenti nell’elenco. Puoi fornire a una nuova persona un codice di associazione, valido per un’ora e poi in scadenza. Puoi consultare l’elenco degli utenti in attesa e approvati con hermes pairing list.

C’è una particolarità delle chat di gruppo che spesso si dimentica. Per impostazione predefinita, la modalità privacy dei bot Telegram è attiva: nei gruppi, un bot vede solo i comandi e le risposte ai propri messaggi. Per permettergli di leggere tutto, disattiva la modalità con @BotFather (Bot Settings - Group Privacy) oppure, più semplicemente, rendi il bot amministratore del gruppo.

Per impostazione predefinita, il gateway interroga autonomamente i server di Telegram: va bene per un computer di casa o un server sempre acceso. Per le piattaforme cloud che mettono a riposo la macchina quando non c’è traffico in entrata, è disponibile la modalità webhook, in cui Telegram invia i messaggi al tuo indirizzo.

Cos’altro può fare Hermes Agent dopo l’installazione?#

Ecco cosa attivare, nell’ordine:

1. Attività programmate. Il gateway ha un pianificatore integrato: «Ogni mattina alle 8, prepara una rassegna di notizie sui miei argomenti e mandamela su Telegram.» Imposta la pianificazione con una frase normale e i risultati arriveranno nella stessa chat.
2. Hermes Desktop. Il comando hermes desktop apre l’app per macOS, Windows e Linux con lo stesso agente: risposte in streaming, anteprime dei file accanto alla chat, trascinamento dei documenti e un contatore del contesto. Le sessioni sono condivise: puoi iniziare nel terminale e continuare nella finestra.
3. Pannello Web. hermes dashboard apre nel browser un pannello per canali, memoria, webhook e profili. È utile quando Hermes funziona su un server.
4. Subagenti. Puoi delegare un’attività complessa ad agenti ausiliari isolati: ognuno ha la propria conversazione e il proprio terminale, quindi non consuma il tuo contesto.
5. Voce. La modalità vocale funziona nel terminale, su Telegram e su Discord: puoi dettare un’attività e ricevere una risposta a voce.
6. Editor di codice. Tramite il protocollo ACP, Hermes si collega a VS Code, Zed e JetBrains come agente integrato direttamente nell’editor.

Puoi attivare e disattivare gli strumenti uno alla volta con hermes tools, così l’agente non deve portarseli tutti dietro. Quando è il momento di passare a un altro computer, hermes backup raccoglie l’intera installazione in un archivio e hermes import lo estrae nella nuova posizione.

A chi è adatto Hermes Agent e chi dovrebbe aspettare?#

Ha senso installare Hermes quando hai capito cosa vuoi far fare a un agente: organizzare documenti, creare un prototipo, gestire la corrispondenza o preparare rassegne mattutine. Lo strumento in sé non è la cosa importante: contano le attività che gli assegni. Su questo argomento c’è una guida alle attività per un agente AI.

Potrebbe non fare al caso tuo in due situazioni. Primo, se ti aspetti di «registrarti e iniziare a usarlo»: Hermes va installato e collegato a un modello. Basta un comando, ma devi comunque aprire il terminale. Secondo, se non hai un modello adatto e non vuoi informarti su un abbonamento o sulle chiavi API.

Tutti gli altri possono iniziare in piccolo: installarlo, scegliere un modello, avere una conversazione senza problemi, poi aggiungere un bot Telegram e solo dopo le pianificazioni e i subagenti.

Cos’altro chiedono le persone su Hermes Agent?#

Altre risorse sono disponibili su Ailoot.