Home · Assistenza · Installare Hermes Agent
Installare Hermes Agent su un vServer
Hermes Agent è un agente IA open source di Nous Research (licenza MIT). Esegue compiti nel terminale, conserva le conoscenze tra una sessione e l'altra, crea propri skill per i compiti ricorrenti e si gestisce tramite Telegram, Discord, Slack, WhatsApp o Signal. Su un vServer funziona 24 ore su 24, anche quando il vostro computer è spento.
Quale server è adatto
Il modello linguistico gira presso il fornitore, per esempio Anthropic, OpenAI, OpenRouter o Nous Portal. Sul server gira solo l'agente stesso: un processo Python che invia richieste all'interfaccia del fornitore ed elabora le risposte. In funzionamento continuo con Telegram, secondo la nostra misurazione, richiede circa 450 MB di RAM e quasi nessun tempo di calcolo.
- Adatto: vServer XS con 1 vCPU, 2 GB di RAM e 40 GB NVMe, come container con Debian 13 o Ubuntu.
- Richiedono più memoria il controllo del browser con Chromium (qualche centinaio di MB in più mentre è attivo) e i servizi di memoria in self-hosting con database proprio.
- Non sono pensati per un vServer i modelli linguistici locali. Richiedono una scheda grafica con almeno 8 GB di memoria. Questa guida usa quindi l'interfaccia di un fornitore.
1. Preparare il server
Come root, aggiornare, installare i prerequisiti e creare un utente dedicato per l'agente. L'agente esegue comandi. Con un utente proprio senza diritti di amministratore, il resto del server resta protetto.
apt update && apt full-upgrade
apt install git curl libatomic1
adduser hermes
loginctl enable-linger hermes
loginctl enable-linger fa sì che i servizi dell'utente continuino a funzionare dopo il logout e dopo un riavvio.
2. Installare Hermes
Accedere come utente hermes, per esempio via SSH o con su - hermes, ed eseguire lo script di installazione ufficiale:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
Lo script porta con sé Python, Node.js e gli altri strumenti e salva tutto in ~/.hermes. Chi non ha bisogno del controllo del browser risparmia spazio con:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
3. Configurare il fornitore del modello
hermes setup
La procedura guidata chiede fornitore, modello e chiave di accesso. Hermes salva chiavi e token in ~/.hermes/.env, tutte le altre impostazioni in ~/.hermes/config.yaml. Il fornitore si cambia in seguito con hermes model. hermes avvia una chat nel terminale, utile per verificare subito la configurazione.
4. Gestire tramite Telegram e funzionamento continuo
Il gateway collega Hermes a Telegram e agli altri servizi di messaggistica. La configurazione chiede l'accesso: per Telegram è il token del bot di @BotFather. Poi install configura il gateway come servizio systemd:
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
Il log si visualizza con journalctl --user -u hermes-gateway -f.
5. Collegare il vostro account cliente Glowfish
Tramite l'interfaccia IA (MCP) Hermes lavora con il vostro account cliente: stato dei server, web hosting, domini, caselle di posta, server di gioco, fatture e ticket di supporto. L'interfaccia è gratuita per i clienti.
- Nel portale clienti, in Applicazioni IA, creare una chiave. Scegliere denominazione, diritti e validità e in Solo da indirizzi IP inserire l'indirizzo del vostro vServer. La chiave viene mostrata una sola volta.
- Inserire la chiave in
~/.hermes/.env:GLOWFISH_MCP_TOKEN=IHR-SCHLUESSEL - Aggiungere il server in
~/.hermes/config.yaml. Hermes inserisce da sé il valore dal file.env, così la chiave non compare nella configurazione:mcp_servers: glowfish: url: "https://mcp.glowfish.de/mcp" headers: Authorization: "Bearer ${GLOWFISH_MCP_TOKEN}" - Verificare la connessione:
hermes mcp test glowfish
Un gateway in esecuzione adotta da sé la configurazione modificata dopo circa un minuto. In una chat aperta, /reload-mcp ricarica subito i server.
Esempi
- «Come stanno i miei server?»
- «Quali fatture sono aperte?»
- «Configura info@mio-dominio.it.»
- «Riavvia il server Valheim.»
- «Mandami ogni mattina alle 8 lo stato dei miei server.»
Le azioni che modificano qualcosa le confermate nella chat. Gli ordini passano solo con un codice SMS, le password mai tramite la chat. Ogni azione è registrata in Applicazioni IA, dove potete scollegare la connessione in qualsiasi momento.
Aggiornare
hermes update
Il comando scarica l'ultima versione stabile e riavvia il gateway.
Domande frequenti
- Quanto costa il funzionamento?
- Il vServer XS costa 6,00 € al mese. A questo si aggiungono i costi del fornitore del modello, a consumo o in abbonamento.
- Container o KVM?
- Il container è sufficiente. KVM serve solo per moduli del kernel propri, per esempio per una VPN.
- Hermes può anche configurare da solo il mio vServer presso Glowfish?
- Sul proprio server Hermes lavora direttamente nel terminale. Tramite l'interfaccia IA può inoltre eseguire comandi su altri server, se li abilitate a questo scopo nel portale clienti.
Continua: Collegare assistenti IA a Glowfish I primi passi sul suo vServer Configurare un server Debian