Come Auto-Hostare l'Agente Hermes su un VPS (Configurazione 2026)

L’Agente Hermes fa molte affermazioni insolite per un progetto open-source: ricorda tutto, scrive le proprie competenze, si auto-migliora effettivamente. Dopo tre settimane di utilizzo su un Hetzner CCX13, le affermazioni risultano confermate. Ecco il percorso di installazione che funziona realmente nel 2026, con gli aspetti critici che le guide ufficiali tendono a trascurare.

Cosa Serve Prima di Iniziare

• Un VPS con Ubuntu 24.04 o Debian 12 (Hermes supporta anche macOS e WSL2, questa guida è solo Linux)
• Accesso SSH con sudo o root
• Almeno 4 GB di RAM se si utilizza il proprio modello, 16 GB se si ospita il LLM
• 80 GB di spazio su disco, preferibilmente NVMe
• Un endpoint per il modello (API key di OpenAI, API key di Anthropic, o installazione locale di Ollama)

Le dimensioni del VPS dipendono dal fatto che si ospiti il modello in proprio. Consulta la guida il miglior VPS per Hermes Agent per la shortlist realistica. Per questa guida assumo la configurazione con modello proprio, che è quella che fa l’80% degli utenti.

Passo 1: Provisionare il VPS

SSH su un Hetzner CCX13 fresco o equivalente e aggiorna l’indice dei pacchetti:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git ufw

Configura un firewall di base prima di esporre qualunque cosa su internet:

sudo ufw allow ssh
sudo ufw allow 443/tcp
sudo ufw enable

Salta la porta 80 a meno che non pianifichi di gestire una web UI pubblica. I gateway di messaggistica (Telegram, Slack, Discord) usano tutte connessioni in uscita e non richiedono porte in ingresso aperte.

Passo 2: Esegui lo Script di Installazione di Hermes

L’unico comando ufficiale dal repo Nous Research:

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

Eseguilo con il tuo utente normale, mai come root. È un installer a livello utente, ed ecco cosa fa davvero:

1. Installa uv, il gestore di pacchetti Python di Astral, e un Python 3.11 gestito
2. Scarica Node.js, ripgrep e ffmpeg, da cui dipende il livello degli strumenti
3. Scompatta Hermes in ~/.hermes e mette il binario hermes nel PATH

Niente finisce in /opt, non viene creato alcun utente di sistema e non viene registrato alcun servizio. Quest’ultimo punto conta su un VPS e lo sistemiamo al Passo 6.

Ricarica la shell perché il nuovo PATH abbia effetto:

source ~/.bashrc

Passo 3: Scegli un Provider di Modello

Avvia la procedura guidata:

hermes setup

Ti accompagna nella scelta del provider di modello e degli strumenti da abilitare. Porta la tua chiave OpenAI, Anthropic o OpenRouter: quest’ultima è la scelta pragmatica su un VPS, perché una sola chiave raggiunge oltre 200 modelli, inclusi quelli a pesi aperti. Se preferisci non gestire chiavi separate per ricerca, generazione di immagini e TTS, hermes setup --portal ti autentica su Nous Portal via OAuth e collega tutto a un unico abbonamento.

Per cambiare idea più avanti, hermes model sostituisce il provider e hermes tools attiva o disattiva i singoli strumenti. Verifica che l’installazione sia sana con:

hermes doctor

Poi avvia una conversazione per provare tutta la catena:

hermes

Se la chiamata al modello fallisce qui, quasi sempre è la chiave API o un refuso nell’URL del provider. hermes doctor indica il componente che non va invece di costringerti a leggere i log.

Passo 4: Aggiungi un Gateway di Messaggistica

Il gateway è ciò che rende sensato un VPS: l’agente continua a lavorare mentre il tuo portatile è chiuso. Telegram è il primo canale più semplice. Crea un bot con @BotFather e tieni il token a portata di mano, poi:

hermes gateway setup

La procedura chiede quali piattaforme abilitare e richiede il token. Hermes gestisce Telegram, Discord, Slack, WhatsApp, Signal, e-mail e Home Assistant da questo stesso processo, quindi aggiungi subito tutti i canali che ti servono invece di ripetere la configurazione dopo.

Limita il bot al tuo account durante la configurazione. Un bot Telegram è raggiungibile pubblicamente da chiunque ne trovi il nome, e un bot aperto spende i tuoi crediti per degli sconosciuti. Ricava il tuo ID da @userinfobot.

Avvialo:

hermes gateway start

Manda un messaggio al bot. La prima risposta è più lenta perché l’agente carica il contesto.

Passo 5: Guardalo Scrivere una Skill

Chiedi a Hermes qualcosa di non banale. Un buon primo test: «Cerca su GitHub i repository Python di tendenza questa settimana e riassumi i primi tre.»

Dopo un task complesso l’agente scrive una skill riutilizzabile. Elenca quelle che ha:

ls ~/.hermes/skills/

Oppure, dentro una conversazione, /skills. La volta successiva che chiedi qualcosa di simile eseguirà la procedura salvata invece di ragionare da zero, e la skill continuerà ad affinarsi con l’uso. Le skill seguono lo standard aperto agentskills.io, quindi restano portabili.

A parte questo, Hermes indicizza le conversazioni passate con SQLite FTS5, ed è ciò che gli permette di rispondere a «cosa ti ho detto sul database di staging il mese scorso» senza che tu debba rispiegarlo.

Passo 6: Tienilo Attivo Dopo il Logout

È il passo che ogni quickstart salta, e il motivo per cui molti credono che l’installazione sul VPS sia rotta. hermes gateway start muore quando finisce la sessione SSH. Due comandi risolvono in modo definitivo.

Primo, consenti ai servizi del tuo utente di girare senza un login attivo:

sudo loginctl enable-linger $USER

Poi crea una unit systemd utente in ~/.config/systemd/user/hermes-gateway.service:

[Unit]
Description=Hermes Agent messaging gateway
After=network-online.target

[Service]
ExecStart=%h/.local/bin/hermes gateway start
Restart=always
RestartSec=10

[Install]
WantedBy=default.target

Abilitala e avviala:

systemctl --user daemon-reload
systemctl --user enable --now hermes-gateway

Controllala con systemctl --user status hermes-gateway e leggine l’output con journalctl --user -u hermes-gateway -n 50. Verifica che il percorso di ExecStart corrisponda a dove l’installer ha messo il binario: te lo dice which hermes.

Ora il gateway sopravvive sia al logout sia al riavvio.

Passo 7: Configura Backup Automatici

Tutto ciò che è insostituibile vive in ~/.hermes: le tue skill, la configurazione e l’indice delle conversazioni. Fanne backup regolari:

sudo crontab -e

Aggiungi:

0 3 * * * tar -czf /backup/hermes-$(date +\%Y\%m\%d).tar.gz -C $HOME .hermes && find /backup -name "hermes-*.tar.gz" -mtime +14 -delete

Questo crea backup giornalieri alle 3 di notte e mantiene 14 giorni di backup. Modifica la destinazione dove archivi i backup (S3, Backblaze, un disco separato).

E Dopo?

La prima settimana di utilizzo di Hermes riguarda principalmente l’aggiunta di integrazioni (Slack, Discord, calendario, GitHub) e il caricamento delle competenze. Dopo circa tre settimane, la velocità derivante dalle competenze accumulate diventa evidente. Dopo sei settimane, Hermes sarà più veloce in modo significativo rispetto a un prompt GPT-5 appena installato.

Alcune integrazioni utili da aggiungere successivamente:

• Gateway Slack per uso di team
• Strumento filesystem per lavori documentali
• Integrazione calendario per la pianificazione
• GCP MCP per query di codice sviluppo

Per una visione più ampia di dove si inserisce Hermes nell’ecosistema degli agenti, consulta il confronto il miglior VPS per Hermes Agent. Per altri setup di AI agent, esplora le guide SelfHostVPS.