---
title: "Hermes Agent: Guida completa all'agente IA auto-migliorante"
date: "2026-06-08"
category: "Intelligenza Artificiale"
tags: ["agenti ia", "automazione", "hermes agent", "intelligenza artificiale", "nous research"]
author: "Giuseppe Carruezzo"
description: "Scopri Hermes Agent di Nous Research: l'agente IA flessibile, economico e capace di auto-apprendimento. Guida all'installazione, configurazione e uso."
source: "https://ainsights.it/blog/hermes-agent-guida-agente-ia-auto-migliorante"
---

# Hermes Agent: Guida completa all'agente IA auto-migliorante

![Hermes Agent: Guida completa all'agente IA auto-migliorante](/blogai/backend/uploads/6a273984efc1a.webp)

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.

-   **300+** — Modelli supportati (Accessibili centralmente tramite Nous Portal con una sola sottoscrizione)
-   **40+** — Strumenti pronti all’uso (Tool integrati gestibili direttamente da riga di comando)
-   **5 $** — Costo minimo mensile (Requisito infrastrutturale di una VPS economica per il funzionamento continuo)

## Presentazione di Hermes Agent

![Hermes Agent](/blogai/backend/uploads/6a273985668d0.webp)

Il banner ufficiale di Hermes Agent, l'agente IA sviluppato da Nous Research.

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](https://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). |

```mermaid
flowchart TD
  A[Interazione Utente] --> B[Risoluzione Compito Complesso]
  B --> C[Creazione Autonoma Nuova Skill]
  C --> D[Ottimizzazione della Competenza in Uso]
  D --> E[Salvataggio in Memoria e Profilo Utente]
  E --> A
```

## 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

1.  **Esecuzione dello script**: Apri il terminale del tuo sistema operativo ed esegui il comando di installazione automatica.
2.  **Ricarica dell’ambiente**: Aggiorna i file di configurazione della shell per rendere disponibile il comando hermes.
3.  **Avvio di Hermes**: Esegui 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:

```bash
curl -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:

```powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```

L'installer per Windows gestisce in autonomia l'installazione di uv (gestore di pacchetti Python), Python 3.11, Node.js, ripgrep, ffmpeg e una versione portabile e isolata di Git (MinGit, estratta in `%LOCALAPPDATA%\hermes\git`). Questa installazione non interferisce con eventuali versioni di Git già presenti sul sistema.

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:

```bash
source ~/.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:

```bash
hermes              # 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:

```bash
hermes 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`.

### Pro

-   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)

### Contro

-   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:

```bash
hermes 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.md` e `USER.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:

```bash
git 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:

```bash
curl -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
```

## Punti chiave

-   Hermes Agent introduce un vero e proprio ciclo di apprendimento chiuso, permettendo all’IA di migliorare le proprie abilità in base all’esperienza accumulata nelle sessioni.
-   La compatibilità con strumenti cloud serverless come Modal e Daytona riduce i costi infrastrutturali al minimo, azzerando le spese quando l’agente è inattivo.
-   La transizione da sistemi precedenti come OpenClaw è semplificata grazie a uno strumento di migrazione nativo che preserva chiavi API, memorie e configurazioni di personalità.

### L’Agente IA Open Source più Completo e Autonomo — 4.8/5

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.

## FAQ

### Posso utilizzare Hermes Agent sul mio smartphone Android?

Sì, Hermes è compatibile con Android tramite l’emulatore di terminale Termux. Per l’installazione è consigliato usare il pacchetto extra ridotto per evitare incompatibilità con le librerie vocali tradizionali.

### Cosa si intende per ciclo chiuso di apprendimento?

Significa che l’agente è in grado di analizzare i compiti eseguiti con successo per estrarre e memorizzare nuove procedure (skill). Queste ultime vengono poi perfezionate durante gli utilizzi successivi ed entrano a far parte della memoria a lungo termine.

### Devo pagare un abbonamento per usare Hermes Agent?

No, Hermes Agent è un software open-source distribuito con licenza MIT. Tuttavia, l’utilizzo dei modelli di intelligenza artificiale richiede delle chiavi API personali (a consumo) o, in alternativa, una sottoscrizione opzionale a servizi centralizzati come Nous Portal.

### Come posso proteggere l’esecuzione di comandi sensibili sul mio server?

Hermes dispone di un sistema integrato di approvazione dei comandi e di isolamento all’interno di container, garantendo che le operazioni sul terminale vengano eseguite solo previa conferma dell’utente o entro perimetri sicuri autorizzati.

## Fonti e riferimenti

1.  [Repository GitHub Ufficiale - Hermes Agent](https://github.com/NousResearch/hermes-agent)
2.  [Documentazione Ufficiale di Hermes Agent](https://hermes-agent.nousresearch.com/docs/)
3.  [Nous Portal - Console di Gestione](https://portal.nousresearch.com)
4.  [Sito Ufficiale di Nous Research](https://nousresearch.com)

---

*Fonte: [https://ainsights.it/blog/hermes-agent-guida-agente-ia-auto-migliorante](https://ainsights.it/blog/hermes-agent-guida-agente-ia-auto-migliorante)*
