Hermes Agent è l'agente IA auto-migliorante sviluppato da Nous Research, caratterizzato da un ciclo di apprendimento integrato unico nel suo genere. Progettato per essere flessibile, leggero ed economico, questo strumento è in grado di creare nuove competenze dall'esperienza, ottimizzarsi durante l'uso ed essere eseguito sia su hardware locale sia su server cloud a bassissimo costo.
Presentazione di Hermes Agent
A differenza degli assistenti tradizionali, Hermes Agent integra un ciclo chiuso di auto-apprendimento: analizza le conversazioni passate, estrae skill procedurali da attività complesse e modella la conoscenza dell'utente per migliorare l'efficacia nel tempo. Può essere ospitato su una VPS (Virtual Private Server, un server virtuale privato in cloud) da 5 $, su cluster di GPU (Graphics Processing Unit, i processori grafici usati per l'elaborazione dell'IA) o su infrastrutture serverless che riducono i consumi a zero quando l'agente è inattivo. La comunicazione non è vincolata al computer locale: è possibile interagire con l'agente direttamente via Telegram o altre piattaforme di messaggistica mentre questo esegue i compiti in cloud.
Hermes garantisce la massima libertà nella scelta del modello linguistico (LLM - Large Language Model). Tramite il comando hermes model, è possibile passare istantaneamente da un provider all'altro senza modificare il codice. Tra i servizi compatibili figurano Nous Portal, OpenRouter (con oltre 200 modelli), NovitaAI (cloud incentrato su API per modelli, Sandbox per agenti e GPU cloud), NVIDIA NIM (Nemotron), Xiaomi MiMo, z.ai/GLM, Kimi/Moonshot, MiniMax, Hugging Face, OpenAI o qualsiasi endpoint proprietario.
Caratteristiche principali del sistema
| Caratteristica | Dettagli Tecnici e Funzionali |
|---|---|
| Interfaccia terminale reale | TUI (Terminal User Interface, interfaccia grafica testuale) completa di editing multi-riga, autocompletamento dei comandi con barra "/", cronologia delle sessioni, interruzione/reindirizzamento dei flussi e output in tempo reale dei tool eseguiti. |
| Integrazione multi-piattaforma | Supporto per Telegram, Discord, Slack, WhatsApp, Signal ed email tramite un unico processo gateway. Include la trascrizione dei memo vocali e garantisce la continuità della conversazione tra diversi dispositivi. |
| Ciclo di apprendimento chiuso | Memoria curata autonomamente con promemoria periodici. Generazione di nuove competenze dopo l'esecuzione di compiti complessi. Ricerca delle sessioni tramite FTS5 (sistema di ricerca testuale di SQLite) con riassunti generati dall'LLM. Modellazione dialettica dell'utente tramite Honcho e compatibilità con lo standard aperto agentskills.io. |
| Automazioni pianificate | Pianificatore in stile cron integrato per inviare report giornalieri, backup notturni o audit settimanali su qualsiasi piattaforma, usando istruzioni in linguaggio naturale. |
| Delega e parallelizzazione | Generazione di sub-agenti isolati per flussi di lavoro paralleli. Possibilità di scrivere script Python che richiamano strumenti tramite RPC (Remote Procedure Call, chiamate di procedure su server remoti) per ridurre al minimo i costi dei token di contesto. |
| Flessibilità di hosting | Sei backend terminali diversi: locale, Docker, SSH, Singularity, Modal e Daytona. Con Daytona e Modal, l'ambiente dell'agente va in ibernazione se inutilizzato e si riattiva su richiesta, azzerando i costi di inattività. |
| Predisposizione alla ricerca | Generazione di traiettorie batch e compressione dei passaggi decisionali per l'addestramento di futuri modelli specializzati nel richiamo di strumenti (tool-calling). |
Guida all'installazione rapida
Il processo di installazione di Hermes è automatizzato ed è compatibile con i principali sistemi operativi desktop e mobile.
Come installare e avviare Hermes Agent
- 1Esecuzione dello scriptApri il terminale del tuo sistema operativo ed esegui il comando di installazione automatica.
- 2Ricarica dell’ambienteAggiorna i file di configurazione della shell per rendere disponibile il comando hermes.
- 3Avvio di HermesEsegui il comando di inizializzazione per iniziare a configurare i modelli o avviare la chat.
Linux, macOS, WSL2 e Termux
Su sistemi Unix-like e su WSL2 (Windows Subsystem for Linux), digita il seguente comando nel terminale:
bashcurl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows (PowerShell nativa)
Hermes funziona in ambiente Windows nativo senza richiedere obbligatoriamente WSL2. L'interfaccia a riga di comando (CLI - Command Line Interface), la TUI e tutti gli strumenti sono pienamente supportati.
Apri PowerShell ed esegui:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)Se utilizzi Android tramite l'emulatore di terminale Termux, fai riferimento alla guida specifica per evitare incompatibilità con le dipendenze vocali, poiché Termux richiede l'installazione del pacchetto ridotto .[termux] anziché di quello completo.
Una volta completata l'installazione, ricarica la shell e avvia l'interfaccia:
bashsource ~/.bashrc # Usa source ~/.zshrc se utilizzi zsh
hermes # Avvia la chat interattiva
Configurazione iniziale
Hermes dispone di una suite di comandi di gestione per personalizzare l'esperienza d'uso e configurare i componenti dell'agente:
bashhermes # Avvia la conversazione interattiva nella CLI
hermes model # Seleziona il provider LLM e il modello desiderato
hermes tools # Abilita o disabilita gli strumenti disponibili
hermes config set # Modifica singoli valori di configurazione
hermes gateway # Avvia il gateway di messaggistica per Telegram, Discord, ecc.
hermes setup # Avvia l'assistente di configurazione guidata globale
hermes claw migrate # Esegue la migrazione delle impostazioni da OpenClaw
hermes update # Aggiorna Hermes Agent all'ultima versione rilanciata
hermes doctor # Analizza il sistema per diagnosticare eventuali problemi
Semplificare la gestione con Nous Portal
Se si preferisce evitare la gestione manuale di chiavi API separate per il modello linguistico, la ricerca web, la generazione di immagini, la sintesi vocale (TTS - Text-to-Speech) e il browser in cloud, è possibile affidarsi a Nous Portal. Questo servizio centralizza le funzionalità in un unico abbonamento:
- Oltre 300 modelli pronti all'uso, selezionabili rapidamente con il comando
/model <nome>. - Tool Gateway integrato per gestire la ricerca sul web (tramite Firecrawl), la generazione di immagini (tramite FAL), il text-to-speech (tramite OpenAI) e l'interazione con browser in cloud (tramite Browser Use).
Per configurare automaticamente l'agente con Nous Portal dopo una nuova installazione, esegui:
bashhermes setup --portal
Questo comando avvia l'autenticazione tramite OAuth, imposta Nous come provider predefinito e attiva il Tool Gateway. Puoi verificare lo stato dei servizi collegati in qualsiasi momento digitando hermes portal info.
- ✓Ciclo di apprendimento integrato che crea nuove skill autonomamente
- ✓Deploy economico con supporto serverless (Modal e Daytona) per azzerare i costi di inattività
- ✓Accesso centralizzato a centinaia di modelli e tool tramite Nous Portal
- ✓Integrazione nativa con canali di messaggistica diffusi (Telegram, Discord, Slack)
- ✗La configurazione iniziale del gateway di messaggistica richiede passaggi tecnici manuali
- ✗Alcune dipendenze vocali avanzate richiedono pacchetti specifici su dispositivi Android/Termux
Riferimento rapido dei comandi
Le funzionalità di Hermes sono accessibili sia tramite l'interfaccia a riga di comando sul terminale (CLI), sia attraverso i canali di messaggistica configurati nel gateway. Molti dei comandi speciali (slash commands) sono condivisi.
| Azione richiesta | Comando da Terminale (CLI) | Comando su Piattaforme di Messaggistica |
|---|---|---|
| Avviare l'interazione | Esegui hermes | Configura il bot con hermes gateway setup, avvialo con hermes gateway start e invia un messaggio |
| Iniziare una nuova conversazione | /new oppure /reset | /new oppure /reset |
| Cambiare il modello in uso | /model [provider:modello] | /model [provider:modello] |
| Impostare un profilo di personalità | /personality [nome] | /personality [nome] |
| Annullare o riprovare l'ultimo turno | /retry, /undo | /retry, /undo |
| Comprimere il contesto o verificare i consumi | /compress, /usage, /insights [--days N] | /compress, /usage, /insights [giorni] |
| Visualizzare le abilità attive | /skills oppure /<nome-skill> | /<nome-skill> |
| Interrompere l'elaborazione corrente | Premi Ctrl+C o invia un nuovo messaggio | Invia /stop o invia un nuovo messaggio |
| Verificare lo stato delle piattaforme | /platforms | /status, /sethome |
Migrazione da OpenClaw
Per gli utenti che provengono da OpenClaw, Hermes include un sistema di migrazione automatica in grado di trasferire configurazioni, memorie, abilità e chiavi di accesso.
Durante il primo avvio, l'assistente hermes setup rileva la presenza della cartella ~/.openclaw e propone la migrazione. In alternativa, l'operazione può essere avviata manualmente in qualsiasi momento tramite i seguenti comandi:
bashhermes claw migrate # Migrazione interattiva completa
hermes claw migrate --dry-run # Anteprima dei dati che verranno trasferiti
hermes claw migrate --preset user-data # Migrazione dei soli dati utente (senza chiavi e segreti)
hermes claw migrate --overwrite # Sovrascrive eventuali file in conflitto
Gli elementi importati nel profilo di Hermes includono:
- SOUL.md: Il file contenente la personalità dell'agente.
- Memorie: Le voci storiche memorizzate in
MEMORY.mdeUSER.md. - Skill: Le abilità personalizzate create dall'utente, trasferite nella cartella
~/.hermes/skills/openclaw-imports/. - Lista dei comandi approvati: Le regole per il consenso all'esecuzione dei comandi di sistema.
- Impostazioni di messaggistica: Le configurazioni dei client, gli ID degli utenti abilitati e le cartelle di lavoro.
- Chiavi API: Le credenziali autorizzate (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs).
- Risorse audio: I file vocali utilizzati per la sintesi vocale.
- Istruzioni del workspace: Le direttive definite in
AGENTS.md(utilizzando l'opzione--workspace-target).
Sviluppo e contribuzione al progetto
Gli sviluppatori interessati a estendere Hermes Agent possono configurare un ambiente di sviluppo locale. Il repository ufficiale può essere clonato e inizializzato tramite lo script di configurazione rapida:
bashgit clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
./setup-hermes.sh # Installa uv, configura il venv, installa i pacchetti e crea il symlink hermes
./hermes # Rileva e avvia automaticamente l'ambiente virtuale
Se si preferisce procedere manualmente senza l'ausilio dello script automatizzato:
bashcurl -LsSf https://astral.sh/uv/install.sh | sh
uv venv .venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh
L’Agente IA Open Source più Completo e Autonomo
Hermes Agent di Nous Research rappresenta un passo avanti significativo nello sviluppo di agenti IA autonomi. Grazie al ciclo di apprendimento continuo, all’eccellente flessibilità di hosting e all’integrazione nativa con svariate piattaforme di messaggistica, si attesta come una delle migliori soluzioni open-source per sviluppatori e professionisti dell’automazione.
