Vai al contenuto
glowfish

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.

  1. 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.
  2. Inserire la chiave in ~/.hermes/.env:
    GLOWFISH_MCP_TOKEN=IHR-SCHLUESSEL
  3. 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}"
  4. 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

Noleggiare un vServer per Hermes