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

Lo script fa diverse cose in background:

1. Crea un utente di sistema hermes
2. Clona il repo Hermes in /opt/hermes
3. Installa Python 3.11 e le dipendenze tramite un ambiente virtuale gestito
4. Configura SQLite per il negozio di competenze
5. Registra hermes.service come unità systemd
6. Chiede la configurazione del tuo endpoint per il modello

La richiesta di configurazione dell’endpoint domanda un URL compatibile con OpenAI e una API key. Per OpenAI diretto: https://api.openai.com/v1 e la tua chiave. Per Anthropic tramite proxy: l’URL del proxy. Per Ollama locale: http://localhost:11434/v1.

Passo 3: Verifica l’Installazione

Controlla che il servizio sia attivo:

sudo systemctl status hermes

Dovresti vedere active (running). Se no, la causa più comune è la configurazione dell’endpoint. Controlla i log:

sudo journalctl -u hermes -n 50

Errori comuni in questa fase:

• 401 Unauthorized: API key sbagliata, modifica /etc/hermes/config.toml
• Connection refused: endpoint del modello sbagliato, specialmente per setup Ollama locali
• Permission denied on /opt/hermes/skills.db: problema di permessi sul file SQLite, risolvi con sudo chown hermes:hermes /opt/hermes/skills.db

Passo 4: Aggiungi un Gateway di Messaggistica

Telegram è il primo più semplice da integrare. Crea un bot tramite @BotFather su Telegram e prendi il token. Poi:

sudo nano /etc/hermes/gateways/telegram.toml

Aggiungi:

[telegram]
token = "TUO_TOKEN_BOT"
allowed_users = ["TUO_ID_TELEGRAM"]

La lista allowed_users è importante. Senza questa, chiunque su Telegram che trovi il tuo bot può parlare con Hermes e far aumentare i costi della API del modello. Ottieni il tuo ID Telegram inviando un messaggio a @userinfobot.

Ricarica Hermes:

sudo systemctl restart hermes

Invia un messaggio al tuo bot. Hermes risponde in pochi secondi. Il primo messaggio richiede più tempo perché l’agente carica il contesto.

Passo 5: Testa l’Auto-Miglioramento GEPA

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

Dopo che Hermes completa il compito, controlla il negozio di competenze:

ls /opt/hermes/skills/

Dovresti vedere un nuovo file di competenza generato. Questo è GEPA in azione, Hermes ha scritto una procedura riutilizzabile per sé stesso. La prossima volta che poni una domanda simile, utilizza la competenza memorizzata invece di ragionare da zero. Dopo 20-30 compiti riusciti, noterai un miglioramento significativo nella velocità su lavori ripetuti.

Passo 6: Configura Backup Automatici

Il negozio di competenze è la parte più critica della tua installazione Hermes. Fatti dei backup regolari:

sudo crontab -e

Aggiungi:

0 3 * * * tar -czf /backup/hermes-$(date +\%Y\%m\%d).tar.gz /opt/hermes/skills.db /opt/hermes/skills/ && 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.