Come eseguire Hermes Agent 24/7: VPS o ospitato

In breve. Hermes Agent risponde su Telegram e Discord e esegue i suoi lavori programmati solo finché il suo processo gateway è in esecuzione, quindi un agente attivo 24/7 ha bisogno di una macchina che non va mai in pausa. Sul tuo VPS: un server Linux con almeno 2 GB di RAM e lo script di installazione di Nous Research, lanciato come utente normale via SSH (avvia la procedura guidata e installa il gateway come servizio), poi sudo loginctl enable-linger $USER perché il servizio parta all'avvio; tocca a te lanciare hermes update e mantenere il server sicuro. Oppure affitta un server che esegue Hermes Agent per te: il pannello si occupa di installazione, aggiornamenti e riavvii, e tu incolli solo una chiave e un token del bot.

Verificato il 7 novembre 2026, valido per Hermes Agent v0.23.0.

Questa guida usa la documentazione di Hermes Agent (hermes-agent.nousresearch.com/docs) e ciò che abbiamo misurato eseguendo la v0.23.0 sui nostri server. Per passare subito alla soluzione ospitata, vai all'Opzione 3.

Perché un portatile non basta

Il gateway di messaggistica di Hermes Agent è un unico processo sempre in esecuzione che serve tutte le app di chat e il suo scheduler. Quando il portatile va in stop, si riavvia o perde la rete, l'agente smette di rispondere e i lavori programmati non partono. Per un server senza schermo, la documentazione di Hermes Agent descrive un servizio che parte all'avvio e sopravvive al logout.

Che cosa ti serve

Ti serve anche una chiave API di un provider IA (vedi quale chiave di un provider IA usare) e un'app di chat con cui parlargli, per esempio un bot Telegram o Discord. Più dettagli sulla memoria in quanta memoria serve a Hermes Agent.

Opzione 1: il tuo VPS con lo script di installazione

1. Crea il server con Ubuntu e almeno 2 GB di RAM, e collegati via SSH. La pagina Docker di Hermes Agent avverte che la console nel browser di alcuni provider rovina i caratteri incollati come : e @; con SSH il problema non esiste.
2. Usa un utente normale, non root. La documentazione di Hermes Agent dice di lanciare l'installer con l'utente che eseguirà il servizio. Lo strumento terminale dell'agente esegue comandi su questa macchina con quell'utente, quindi tieni quell'account per l'agente.
3. Installa. L'installer installa l'ultima versione stabile:

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

   Per tenere l'installazione più piccola, la sua opzione --skip-browser esclude il suo Chromium, quindi l'automazione del browser locale resta disattivata finché non lanci hermes pm install chromium.
4. Configura. Se lanciato via SSH, l'installer avvia da solo la procedura guidata: chiede la tua chiave IA, i token dei bot e gli ID utente autorizzati a scrivere all'agente. Vedi Telegram e Discord. Più tardi puoi rilanciarla con hermes setup, oppure passo per passo con hermes model e hermes gateway setup.
5. Eseguilo come servizio. Alla fine l'installer installa il gateway come servizio utente, se la procedura guidata non l'ha già fatto; se hai saltato quel passaggio, lancia hermes gateway install. Poi, una volta sola, fallo partire all'avvio e tienilo attivo dopo il logout:

   sudo loginctl enable-linger $USER
   hermes gateway status
   journalctl --user -u hermes-gateway -f

   La documentazione di Hermes Agent consiglia questo servizio utente con linger per un server senza schermo: parte all'avvio e gli aggiornamenti possono riavviarlo senza root. L'unit che Hermes Agent scrive riavvia il gateway quando si ferma in modo inatteso e dopo un /restart dato in chat. La documentazione descrive anche un servizio di sistema (hermes gateway install --system), ma in quel caso ogni riavvio richiede root, e sconsiglia di tenere installati entrambi i tipi.
6. Aggiorna con hermes update. Segue le versioni stabili, mette in pausa il servizio, aggiorna e lo riavvia. Le versioni sono frequenti (v0.22.5 il 23 ottobre, v0.22.6 il 2 novembre, v0.22.7 il 3 novembre e v0.23.0 il 5 novembre 2026), e nel nostro test un aggiornamento ha richiesto più memoria dell'installazione.

Opzione 2: il tuo server con Docker

Hermes Agent pubblica un'immagine ufficiale, nousresearch/hermes-agent, con tutti i dati in una sola cartella da montare su /opt/data. Lancia una volta la procedura guidata, poi il gateway in background:

mkdir -p ~/.hermes
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup
docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data nousresearch/hermes-agent gateway run

La documentazione pubblica anche la porta 8642, per il server API e il controllo di stato di Hermes Agent; dice che è facoltativa se usi solo app di chat come Telegram e Discord. Le installazioni Docker non supportano hermes update: si aggiorna scaricando una nuova immagine e ricreando il container. Dentro l'immagine un supervisore di processi riavvia il gateway se va in crash.

Come tenere al sicuro un agente self-hosted

• Autorizza solo te stesso. Senza lista di utenti autorizzati Hermes Agent nega tutti, ed è la scelta sicura. Non impostare mai GATEWAY_ALLOW_ALL_USERS=true su un agente che può eseguire comandi.
• Tieni la dashboard fuori da internet. La documentazione di Hermes Agent dice che il suo accesso con nome utente e password è "not suitable for direct public-internet exposure" (non adatto all'esposizione diretta su internet pubblico); per le installazioni pubbliche offre l'accesso con Nous Portal o OpenID Connect. Sul tuo VPS, la cosa più semplice è raggiungerla con un tunnel SSH.
• Lascia spento il server API se non ti serve. È spento per impostazione predefinita e, quando è acceso, ascolta su 127.0.0.1.
• Sappi che cosa può toccare l'agente. Con il terminale locale predefinito, i comandi girano sul server stesso, con l'utente che esegue Hermes Agent. Controlla i comandi in base a un elenco di schemi pericolosi e, nella modalità predefinita "smart", chiede a un modello di valutarli; quelli incerti arrivano a te in chat per l'approvazione. La checklist di produzione di Hermes Agent consiglia invece di eseguire i suoi comandi in un container (terminal.backend: docker in config.yaml).
• Fai il backup di ~/.hermes: contiene impostazioni, chiavi, memoria, skill e sessioni.

Opzione 3: un server che lo esegue per te

Un server Hermes Agent di PlayNHost fa per te i passaggi sopra:

• Installazione: il primo avvio lancia l'installer di Nous Research, senza gli strumenti del browser; nei nostri test ha richiesto circa da 2,5 a 4 minuti.
• Aggiornamenti: a ogni avvio controlla se c'è una nuova versione stabile e la installa per prima (circa 20 secondi quando non c'è nulla di nuovo). Se un aggiornamento fallisce, parte la versione che hai come prima. Puoi disattivarlo con Aggiorna Hermes Agent a ogni avvio sotto Codice, Impostazioni.
• Riavvii: un riavvio o un aggiornamento chiesto in chat viene fatto ripartire per te, e se l'agente si ferma da solo il pannello lo riavvia entro circa un minuto. Sotto Riavvii puoi anche programmare un riavvio giornaliero.
• Sicurezza: solo gli ID utente indicati nella pagina Agente possono scrivere all'agente; nulla sul server è in ascolto su internet; WhatsApp è rifiutato; l'agente viene fermato se apre una porta o lascia entrare qualcun altro.
• Il tuo compito: incolla una chiave di un provider IA e un token del bot Telegram o Discord nella scheda Agente, aggiungi il tuo ID utente e premi Avvia. Chiavi e token sono conservati cifrati e non vengono più mostrati.

Che cosa perdi rispetto a un tuo VPS: niente riga di comando (niente comandi hermes, niente accesso con Nous Portal, niente approvazioni di abbinamento), niente dashboard web, niente automazione del browser, solo Telegram e Discord, e un agente per server (i profili di Hermes Agent sono rifiutati). Puoi comunque modificare i file dell'agente in Files, e il suo log è .hermes/logs/gateway.log.

VPS o ospitato: quale scegliere

Il nostro giudizio: scegli un VPS se vuoi ogni funzione di Hermes Agent o se gestisci già dei server; scegli la soluzione ospitata se vuoi un agente su Telegram o Discord senza la manutenzione. Hermes Agent in sé è gratuito e con licenza MIT in entrambi i casi; la documentazione di Nous Research avverte che nessuno di serio ti chiede di pagare per l'agente in sé. Un host fa pagare il server, non l'agente. Prossimo passo: crea un server Hermes Agent.

PlayNHost non è affiliato a Nous Research. Hermes Agent è un software open source con licenza MIT.