Guida pratica · non ufficiale

Impara a usare il tuo
Hermes Agent

Questa guida è scritta apposta per la tua installazione: modello xiaomi/mimo-v2.5 via OpenRouter, dashboard su hermes.giuseppebosi.com. Niente teoria astratta: solo spiegazioni chiare e missioni da fare subito, sul serio.

Hermes Agent v0.19.0 Provider: OpenRouter Modello: mimo-v2.5 71 skill · 31 tool disponibili

01 Cos'è Hermes, in pratica

Non è un chatbot. È un assistente che fa le cose: cerca sul web, esegue comandi, tiene la memoria tra una conversazione e l'altra, e impara nuove procedure ("skill") man mano che lavora con te.

🧠 Ricorda

A differenza di ChatGPT nel browser, Hermes tiene due file di memoria persistente (fatti sull'ambiente e tue preferenze) che rilegge a ogni nuova sessione.

🛠️ Agisce

Ha accesso reale a un terminale, alla ricerca web, alla gestione di file, a un browser automatizzato — non deve solo "descriverti" come fare una cosa, la fa.

📚 Impara

Dopo un lavoro complesso (5+ passaggi), può salvare da solo la procedura come "skill" riutilizzabile — la prossima volta è più veloce e affidabile.

02 Come ci accedi

Due strade, usa quella che preferisci — condividono le stesse sessioni, skill e memoria.

🌐 Dashboard web

Vai su hermes.giuseppebosi.com, accedi con utente admin e la password che già conosci. Da qui hai chat, sessioni, skill, cron, tutto a portata di click — anche da telefono.

⌨️ Riga di comando

Se sei connesso al server via SSH: docker exec -it hermes /opt/hermes/bin/hermes chat apre una chat interattiva diretta nel container.

Schermata di login della dashboard Hermes Agent
La schermata di accesso — hermes.giuseppebosi.com

03 Concetti in 5 minuti

Quattro parole che tornano ovunque nella guida. Capirle bene ti fa risparmiare ore.

Sessione Una conversazione, con la sua cronologia Tool Azioni immediate: cerca, esegui, leggi file Memoria Fatti e preferenze che restano nel tempo Skill Una procedura salvata, riusabile come comando Cron job Una skill che parte da sola, a orario

Il flusso tipico: una sessione usa dei tool, che alimentano la memoria; un lavoro riuscito diventa skill; una skill ricorrente diventa un cron job automatico.

ConcettoCos'è davveroDove lo vedi
SessioneUna singola conversazione, con la sua cronologia dei messaggiSidebar "Sessions" nella dashboard
ToolUn'azione che l'agente può eseguire subito: cercare sul web, lanciare un comando, leggere un fileElenco "Available Tools" a inizio chat
SkillIstruzioni salvate per un compito specifico, richiamabili come uno slash-comandoSidebar "Skills" — ne hai già 71
MemoriaDue piccoli file (fatti + preferenze) che l'agente rilegge a ogni nuova sessioneSi aggiorna da sola, o a comando
Cron jobUn compito che si ripete da solo a un orario che scegli tuSidebar "Cron"

04 Le missioni

Sette missioni, in ordine di difficoltà crescente. Falle nell'ordine: ognuna usa quello che hai imparato nella precedente. Aprile dalla dashboardChat, oppure da terminale.

Missione 1⭐ Difficoltà: nessuna

Prima conversazione

Obiettivo: verificare che tutto funzioni e capire come l'agente si presenta.

  1. Apri la dashboard → Chat (o docker exec -it hermes /opt/hermes/bin/hermes chat).
  2. Scrivi:
    Ciao! Rispondi con una frase che confermi chi sei e il modello che stai usando.
  3. Leggi la risposta con attenzione: deve nominare "Hermes Agent" e il modello xiaomi/mimo-v2.5.
Schermata iniziale della chat di Hermes Agent con il banner ASCII e i tool disponibili
La schermata di benvenuto in Chat — nota il conteggio di tool e skill disponibili
Hai vinto se: l'agente risponde in italiano (segue la lingua in cui scrivi) confermando la sua identità e il modello.
Missione 2⭐ Difficoltà: facile

Cerca sul web

Obiettivo: fargli usare un tool vero, non solo "sapere" dalla sua memoria di addestramento.

  1. Nella stessa chat, o in una nuova, scrivi:
    Cerca sul web le ultime notizie sull'intelligenza artificiale e riassumi le prime 3 in 3 righe ciascuna, con link.
  2. Osserva: dovrebbe comparire un'indicazione che sta usando il tool di ricerca web (web_search, plugin web-ddgs — gratuito, nessuna chiave richiesta).
  3. Controlla che i link nella risposta siano reali e recenti — è la prova che ha davvero cercato, non inventato.
Hai vinto se: la risposta contiene notizie con data recente e link verificabili.
Missione 3⭐⭐ Difficoltà: facile

Usa il terminale

Obiettivo: capire che l'agente esegue comandi veri dentro il suo ambiente, non finge di farlo.

hermes chat
 Usa il tool terminal per eseguire 'echo test-tool-ok' e dimmi cosa hai ottenuto.

Ho eseguito `echo test-tool-ok` e il risultato è:
- Output: test-tool-ok
- Exit code: 0 (nessun errore)
- Error: null

Il comando ha funzionato correttamente e restituisce esattamente
"test-tool-ok" come previsto.

Questo è un output reale, catturato durante i test di configurazione di questa istanza.

  1. Prova tu stesso con un comando diverso, ad esempio:
    Usa il terminale per dirmi che versione di Python è installata e da quanto tempo il sistema è acceso.
Hai vinto se: ottieni un output realistico (una versione software, un tempo di uptime) e non una risposta generica.
Missione 4⭐⭐ Difficoltà: media

Insegnagli qualcosa

Obiettivo: capire la memoria persistente — la differenza vera tra Hermes e un chatbot che dimentica tutto.

  1. Dì all'agente qualcosa su di te che vuoi che ricordi, per esempio:
    Ricorda che preferisco risposte brevi e dirette, senza troppe premesse. Ricordalo per le prossime volte.
  2. Chiudi la sessione (torna a "Sessions" o esci dal terminale) e aprine una nuova.
  3. Nella nuova sessione chiedi:
    Cosa ricordi delle mie preferenze?
Nota: la memoria si aggiorna anche da sola — l'agente salva scoperte importanti senza che tu debba chiederlo esplicitamente ogni volta.
Hai vinto se: nella sessione nuova, senza che tu gliela ripeta, l'agente cita la preferenza che avevi indicato prima.
Missione 5⭐⭐⭐ Difficoltà: media

Crea una skill

Obiettivo: trasformare un compito ripetitivo in un comando riutilizzabile — la vera potenza di Hermes.

  1. Dagli un compito con più passaggi, per esempio:
    Controlla lo spazio disco disponibile, elenca le 5 cartelle più grandi in /opt, e scrivimi un riepilogo in markdown.
  2. Una volta soddisfatto del risultato, chiedigli esplicitamente di salvarlo:
    Ottimo lavoro. Salva questa procedura come skill riutilizzabile chiamata "controllo-disco".
  3. Vai nella dashboard su Skills e verifica che compaia nell'elenco.
  4. La prossima volta ti basterà scrivere /controllo-disco per rilanciare l'intera procedura.
Elenco delle skill disponibili nella dashboard Hermes Agent, 71 su 71 abilitate
La libreria skill — questa istanza ne ha già 71 pronte all'uso, la tua sarà la 72ª
Hai vinto se: la nuova skill appare in "Skills" e richiamarla con /controllo-disco ripete il lavoro senza bisogno di riscrivere il prompt.
Missione 6⭐⭐⭐⭐ Difficoltà: avanzata

Automatizza con un cron job

Obiettivo: far lavorare Hermes da solo, a orario, senza che tu debba aprire la chat.

Regola d'oro: il prompt di un cron job deve bastare a se stesso. L'agente parte "a freddo", senza la conversazione precedente — scrivi ogni dettaglio (argomento, quantità, formato) dentro al prompt stesso.
  1. Vai su Cron nella dashboard, oppure scrivi direttamente in chat:
    Crea un cron job che ogni giorno alle 8:00 cerchi le ultime notizie su intelligenza artificiale e mi scriva un riepilogo di 3 punti.
  2. In alternativa, comando diretto: /cron add "0 8 * * *" "Cerca le ultime notizie su AI e riassumi in 3 punti con link"
  3. Verifica che sia stato creato con /cron list o dalla dashboard.
Sezione Cron della dashboard Hermes Agent, ancora vuota
La sezione Cron — qui compariranno i tuoi job pianificati
Attenzione: senza una piattaforma di messaggistica collegata (Telegram, Discord...) il risultato del cron non ti arriva in automatico da nessuna parte — lo trovi comunque nello storico eseguendo cronjob action='list' o dalla dashboard. Per ricevere notifiche vere, serve prima collegare un canale (vedi "Trucchi da veterano").
Hai vinto se: il job compare nella lista e, al primo orario previsto, produce un risultato consultabile.
Missione 7⭐⭐⭐ Difficoltà: bonus / divertimento

Cambia personalità e modello al volo

Obiettivo: scoprire i comandi rapidi che cambiano il comportamento dell'agente senza toccare la configurazione.

hermes chat
 /personality pirate
Personalità cambiata: Captain Hermes, il pirata più esperto di tecnologia
che solchi i mari digitali...

 /model
→ menu di selezione modello/provider

 /tools
→ elenco dei tool attualmente abilitati

Altre personalità pronte: /personality concise, /personality technical, /personality teacher, /personality shakespeare, /personality catgirl — sperimenta pure.

Hai vinto se: riesci a far rispondere l'agente "in stile pirata" e poi tornare a quello normale con /personality helpful.

05 Tour veloce della dashboard

Le sezioni che userai più spesso, con uno screenshot reale di questa istanza.

Sessions — tutte le tue conversazioni

Sezione Sessions della dashboard, con l'elenco delle conversazioni recenti
Ogni sessione mostra il modello usato, quanti messaggi contiene e quando è stata attiva

Models — quale cervello sta usando

Sezione Models della dashboard, con il modello principale mimo-v2.5 e le statistiche d'uso
Qui vedi il modello principale attivo (mimo-v2.5 via OpenRouter) e quante sessioni ha gestito

Plugins — funzionalità extra da attivare

Sezione Plugins della dashboard, con la gestione dei plugin installati
Da qui abiliti plugin già inclusi (come la ricerca web gratuita) o ne installi di nuovi da GitHub

Kanban — per chi vuole orchestrare più lavori

Sezione Kanban della dashboard, con le colonne Triage, Todo, Scheduled, Ready
Una bacheca stile kanban per gestire compiti multipli — utile quando inizi a delegare lavori complessi

06 Cheat sheet — i comandi che userai davvero

Non serve impararli a memoria: tienili qui sott'occhio la prima settimana.

Slash command (dentro la chat)

ComandoCosa fa
/helpElenca tutti i comandi disponibili
/toolsMostra i tool attualmente abilitati
/modelCambia modello o provider al volo
/personality <nome>Cambia tono/persona (pirate, teacher, concise...)
/skillsElenca le skill disponibili
/learn ...Trasforma una conoscenza esistente in una skill
/cron add "<espressione>" "<prompt>"Crea un compito pianificato
/cron listElenca i cron job attivi
/compressRiassume la conversazione per liberare contesto
/verboseCambia quanto dettaglio mostrare sull'uso dei tool
/title <nome>Dà un nome alla sessione corrente, per ritrovarla facilmente
/saveSalva la cronologia della conversazione

Riga di comando (da terminale, dentro il container)

bash
# Chat interattiva
 docker exec -it hermes /opt/hermes/bin/hermes chat

# Una domanda secca, senza aprire una sessione interattiva
 docker exec hermes /opt/hermes/bin/hermes chat -q "che ore sono a Roma?" -Q

# Riprendi l'ultima sessione con tutta la cronologia
 docker exec -it hermes /opt/hermes/bin/hermes chat --continue

# Stato generale del sistema
 docker exec hermes /opt/hermes/bin/hermes status

# Diagnosi approfondita se qualcosa non va
 docker exec hermes /opt/hermes/bin/hermes doctor

Trucchi da tastiera nella chat

TastoEffetto
Alt+Enter / Shift+EnterVai a capo senza inviare il messaggio
Ctrl+C (una volta)Interrompi una risposta lunga in corso
Ctrl+C (due volte, entro 2s)Esci forzatamente
Ctrl+VIncolla un'immagine dagli appunti per farla analizzare
/ + TabSfoglia tutti i comandi e le skill disponibili

07 Trucchi da veterano

Presi dalla documentazione ufficiale e adattati a questa installazione.

🎯 Sii specifico

Invece di "controlla il sistema", scrivi "controlla lo spazio disco su /opt e dimmi se qualche cartella supera i 5GB". Meno ambiguità, meno tentativi.

📄 Usa un AGENTS.md

Se ti ritrovi a ripetere le stesse istruzioni ("rispondi in italiano", "usa nomi di file in minuscolo"...), mettile in un file AGENTS.md — l'agente lo legge da solo a ogni sessione.

🧩 Memoria ≠ Skill

La memoria è per i fatti ("preferisco risposte brevi"). Le skill sono per le procedure ("come pubblico un articolo sul sito"). Non confonderle.

💬 Sessioni parallele

Chiedigli di "fare X e Y in parallelo" per far lavorare due compiti indipendenti contemporaneamente tramite sotto-agenti.

📊 Controlla i costi

OpenRouter fattura a consumo. Usa /usage in chat o la sezione Models della dashboard per tenere d'occhio quanto stai spendendo.

📱 Collega Telegram o Discord

Da dashboard → Channels, oppure hermes gateway setup da terminale: così puoi parlare con Hermes anche fuori dalla dashboard, e ricevere i risultati dei cron job.

08 Sicurezza — cosa sapere prima di dargli più libertà

Approvazione comandi: Hermes controlla ogni comando prima di eseguirlo confrontandolo con una lista di pattern pericolosi, e chiede conferma per le azioni rischiose. Quando ti chiede "sempre" vs "solo questa sessione", pensaci due volte prima di scegliere "sempre".
Segreti mascherati: Hermes offusca automaticamente stringhe che sembrano chiavi API, token o password nei log e nelle risposte, prima che tu (o il modello) le veda.
Bot di messaggistica: se in futuro colleghi Telegram/Discord/WhatsApp, non attivare mai l'opzione che accetta messaggi da chiunque senza allowlist — un bot con accesso al terminale collegato a un canale pubblico è un rischio serio.

09 Problemi comuni su questa installazione

"Non risponde niente / stream vuoto"

Se in futuro provi a cambiare provider verso il bridge Meridian (porta 3456), sappi che al momento non è compatibile con Hermes: Anthropic classifica il traffico di app di terze parti come "Extra Usage" e senza credito la richiesta fallisce silenziosamente. Resta su OpenRouter finché non risolvi quel credito su claude.ai/settings/usage.

Le risposte sono lente

Controlla in Models se stai usando un modello "reasoning" pesante per compiti semplici — per domande veloci puoi cambiare modello al volo con /model.

Ha dimenticato qualcosa che gli avevo detto

La memoria ha una capacità limitata (~2.200 caratteri per i fatti, ~1.375 per le preferenze). Se è piena, le informazioni più vecchie vengono consolidate/perse. Chiedigli esplicitamente "ricorda in modo permanente che..." per le cose davvero importanti.

Un cron job non ha consegnato il risultato

Senza un canale di messaggistica collegato, i cron restano "local-only": il risultato è salvato ma non ti arriva da nessuna parte in automatico. Guardalo dalla dashboard → Cron, o collega un canale (vedi sezione Trucchi).