Come installare Hermes Agent su Saplo (agente AI nelle chat)

Prima di iniziare, una cosa subito: Hermes Agent non ha un pannello web. Non c'è una schermata di login, non c'è una dashboard con grafici, non c'è niente che apparirebbe nel browser dopo aver visitato il dominio. Tutta la configurazione, dalla chiave del modello linguistico alla connessione del bot a Telegram, avviene nel terminale. Se stai cercando un chatbot pronto all'uso con un'interfaccia cliccabile, questa non è l'applicazione giusta; nel catalogo Saplo troverai altri strumenti più adatti. Hermes Agent è per qualcun altro: per uno sviluppatore o un'agenzia che desidera avere il proprio agente AI connesso ai messenger, senza dover scrivere integrazioni dall'API del modello da zero e senza pagare un abbonamento mensile per una piattaforma SaaS che, in fondo, fa la stessa cosa. Se questo descrive la tua situazione, ecco passo dopo passo come installare Hermes Agent su Saplo.

A chi è rivolto Hermes Agent

Prima di installarlo, verifica se questo strumento è adatto a ciò che vuoi fare:

• stai creando un bot che risponderà per te su Telegram, Discord o Slack - Hermes Agent si connette al comunicatore scelto e parla con gli utenti a tuo nome, utilizzando il modello linguistico che indicherai tu stesso,
• non vuoi scrivere la tua integrazione con l'API del modello - la gestione dei webhook, la coda dei messaggi e il mantenimento della connessione con il comunicatore sono già inclusi nell'immagine Docker, tu devi solo fornire le chiavi,
• preferisci pagare una volta per il Box piuttosto che mensilmente per una piattaforma SaaS - Hermes Agent è open source, non ha un abbonamento separato, paghi solo per il Box su cui è ospitato,
• non ti dispiace la configurazione tramite terminale - se ti aspetti un'interfaccia guidata nel browser, questa applicazione ti deluderà, qui tutto avviene via SSH.

Se cerchi un chatbot pronto per il servizio clienti con un pannello di amministrazione, consulta le altre voci nel catalogo delle applicazioni, lì troverai strumenti con un'interfaccia web.

Requisiti

Per configurare Hermes Agent su Saplo, hai bisogno di:

• Un Box nel piano L o superiore, perché la prima configurazione richiede l'accesso SSH tramite Terminale Online, e i piani inferiori non lo includono.
• Minimo 1,5 GB di RAM libera e 8 GB di spazio su disco.
• Un Dominio o sottodominio *.saploapp.pl incluso nel prezzo di ogni piano, sotto il quale verrà ospitata la pagina informativa (Hermes è headless, quindi sotto il Dominio vedrai solo le istruzioni, non un pannello).
• Una chiave API per il modello linguistico, che fornirai durante la configurazione nel terminale, e un token bot per il messenger a cui Hermes deve connettersi.
• NON hai bisogno di un database separato; tutta la configurazione e la cronologia delle conversazioni sono conservate in un volume Docker denominato.

Installazione passo dopo passo

1. Nel Pannello Saplo, vai su Catalogo delle applicazioni e seleziona Hermes Agent (categoria "Applicazioni AI").
2. Indica un Box nel piano L o superiore con almeno 1,5 GB di RAM libera e il Dominio o sottodominio dove sarà ospitata la pagina informativa.
3. Conferma l'installazione. Il motore installa Docker CE, se non è già presente sul Box, scarica l'immagine ufficiale nousresearch/hermes-agent (circa 900 MB) e avvia il container senza esporre una porta HTTP; tutto il traffico rimane all'interno del container.
4. Dopo l'avvio, il motore verifica che il container sia effettivamente in esecuzione e non sia entrato in un loop di riavvii, invece di limitarsi a un semplice docker compose up senza verifica.
5. Sotto il Dominio specificato, appare una pagina statica con le istruzioni di configurazione, poiché Hermes non espone la propria interfaccia web.

Prima configurazione

1. Nel Pannello Saplo, vai su Terminale Online per il Box su cui è installato Hermes (richiede un piano L o superiore).
2. Avvia la procedura guidata di configurazione con il comando docker exec -it hermes-<slug> hermes setup, dove <slug> è il nome della tua installazione visibile nel pannello.
3. Nella procedura guidata interattiva, inserisci la chiave API per il modello linguistico e il token del bot per il messenger selezionato (Telegram, Discord o Slack).
4. Una volta completata la procedura guidata, l'agente si connette automaticamente al messenger, senza bisogno di riavviare il container.
5. Puoi visualizzare lo stato dell'agente in tempo reale con il comando docker logs -f hermes-<slug> nello stesso Terminale Online.

Hermes Agent su Saplo vs. alternative

Domande frequenti

Hermes Agent ha un pannello web? No, l'applicazione è headless. Sotto il dominio che indicherai durante l'installazione, vedrai solo una pagina statica con le istruzioni di configurazione. L'agente stesso funziona in un container Docker e non espone alcuna interfaccia nel browser.

Perché l'installazione richiede il piano Box L e non uno inferiore? Perché la prima configurazione avviene tramite il Terminale Online, ovvero l'accesso SSH al container, e questo è disponibile solo a partire dal piano L in su. Con i piani inferiori puoi creare il container, ma non configurare l'agente.

Quale modello linguistico può utilizzare Hermes Agent? Durante la configurazione nel wizard hermes setup, fornisci la tua chiave API, quindi la scelta del modello dipende dal fornitore a cui hai accesso. Saplo non impone un fornitore specifico e non addebita costi per le query al modello.

Dove viene conservata la cronologia delle conversazioni dell'agente? In un volume Docker denominato sul tuo Box, lo stesso volume sopravvive alla pulizia della directory delle applicazioni, quindi la configurazione e la cronologia non scompaiono durante le normali operazioni sul Box.

Posso collegare Hermes Agent a più di un messenger contemporaneamente? Il wizard hermes setup ti guida passo dopo passo nella configurazione del messenger, quindi se vuoi gestire più di un canale, esegui nuovamente il wizard e aggiungi un'altra connessione nello stesso container.

Se vuoi avere il tuo agente AI su Telegram, Discord o Slack senza scrivere integrazioni da zero e senza un abbonamento SaaS, e il terminale non ti spaventa, puoi installare Hermes Agent su Saplo in pochi minuti. Scrivici se hai bisogno di aiuto con la prima configurazione.