# Hermes Agent: cos’è, come installarlo e configurarlo

> Hermes Agent spiegato in modo semplice: che cos’è questo agente AI, quanto costa, come installarlo su Windows, macOS e Linux, scegliere un modello e collegarlo a Telegram.

Source: https://ailoot.ai/blog/it/hermes-agent-install-setup/
Canonical: https://ailoot.ai/blog/it/hermes-agent-install-setup/
Language: it
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-114
Revision: sha256-7d3e9d94799a9e48834523658721f38167601b2be6e9816dbf77693fceff544a


Claude Code, Codex, Cursor, OpenClaw: ognuno di questi agenti AI ha un ruolo specifico. Se ti serve un agente che viva sul tuo server, si ricordi di te tra una sessione e l’altra e ti risponda su Telegram mentre sei in taxi, Hermes Agent è adatto a questo scopo.

Hermes Agent è un progetto aperto di Nous Research, ed è molto più facile da installare di quanto molti pensino. Ecco cosa vedremo: che cos’è, quanto costa, come installarlo su Windows, macOS o Linux e come collegargli un modello e un bot Telegram. Tutto si basa sulla documentazione ufficiale.

<div class="aside" data-semantic="editorial-reference" role="note" aria-label="Documentazione Ailoot">

[Documentazione Ailoot](https://ailoot.ai/docs/) — materiali di riferimento per usare il servizio.

</div>

## Che cos’è Hermes Agent, spiegato in modo semplice?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Hermes Agent è un agente AI gratuito del team statunitense Nous Research. Funziona sul tuo computer o server: legge e modifica file, esegue comandi, cerca su Internet, si ricorda di te tra una sessione e l’altra e risponde tramite terminale, app desktop o messaggistica. È distribuito gratuitamente con licenza MIT.

</div>

Hermes appartiene alla stessa categoria di Claude Code o Codex: è un agente AI che non si limita a scrivere risposte, ma apre file, esegue comandi nel terminale e usa un browser. La differenza sta nel modo in cui è costruito: Claude Code è legato ai modelli Anthropic, mentre Hermes funziona con qualsiasi provider di modelli, da Claude e GPT ai modelli locali eseguiti sul tuo hardware.

Il progetto è giovane: il suo repository GitHub è stato creato il 22 luglio 2025. Eppure, al 22 agosto 2026, ha più di 234.000 stelle e 47.000 fork, ed è uno dei progetti aperti in più rapida crescita di questa categoria. Il codice è completamente aperto con licenza MIT: puoi leggerlo, modificarlo e usarlo nei tuoi prodotti senza royalty.

<figure>
<blockquote>
<p>Un agente AI auto-migliorante di Nous Research. È l’unico agente con un ciclo integrato di raccolta dell’esperienza: crea competenze a partire dal proprio lavoro, le migliora nel tempo, si ricorda di salvare le conoscenze e cerca risposte nelle sue conversazioni passate.</p>
</blockquote>
<figcaption>— Nous Research, descrizione del progetto su GitHub, https://github.com/NousResearch/hermes-agent</figcaption>
</figure>

Due meccanismi specifici sono alla base di questo «auto-miglioramento»: competenze e memoria. Le competenze sono procedure che l’agente mette per iscritto dopo attività complesse e applica la volta successiva. La memoria è un file con informazioni su di te e sul tuo ambiente, caricato in ogni nuova conversazione. Entrambi i meccanismi sono trattati qui sotto in una sezione dedicata.

## In cosa Hermes Agent è diverso da Claude Code e Codex?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Le differenze principali sono quattro: Hermes funziona con qualsiasi modello di venti provider, scrive le proprie competenze e conserva la memoria tra una sessione e l’altra, può rispondere su Telegram e in oltre venti altre app di messaggistica e dispone di un’app desktop. Claude Code e Codex sono più strettamente legati ai rispettivi modelli e si usano soprattutto nel terminale e nell’editor.

</div>

Le differenze principali sono riassunte in questa tabella:

| Funzionalità | Hermes Agent | Claude Code | Codex |
|----|----|----|----|
| Modelli | Qualsiasi: Claude, GPT, Gemini, Qwen, DeepSeek, modelli locali | Solo Claude | Solo modelli OpenAI |
| Codice | Aperto, MIT | Chiuso | Aperto, Apache |
| Prezzo dello strumento | Gratuito | Abbonamento o pagamento a token | Abbonamento ChatGPT |
| Memoria tra sessioni | Integrata, file MEMORY.md e USER.md | Tramite un file CLAUDE.md | Limitata |
| Competenze scritte dall’agente | Sì, competenze conformi allo standard agentskills.io | Le competenze si scrivono a mano | No |
| App di messaggistica | Telegram, Discord, Slack, WhatsApp e altre 17+ | No | No |
| App desktop | Disponibile: macOS, Windows, Linux | Nessuna app separata | Nessuna app separata |
| Attività programmate | Pianificatore integrato | No | No |

La tabella chiarisce il punto principale. Claude Code è adatto alle attività che richiedono il modello più potente e si svolgono in un repository: Anthropic offre ancora la combinazione migliore di modello e strumenti. Hermes è pensato per quando ti serve un agente «sempre attivo»: funziona su un server, svolge attività ogni mattina secondo una pianificazione, ti risponde su Telegram e ricorda la conversazione del giorno prima.

Se stai confrontando gli strumenti di base, ci sono guide separate su [come installare Claude Code](https://ailoot.ai/blog/it/install-claude-code/), [che cos’è Codex di OpenAI](https://ailoot.ai/blog/it/openai-codex-install/) e [il panorama degli strumenti di programmazione AI nel 2026](https://ailoot.ai/blog/it/ai-coding-tools/).

## Quanto costa Hermes Agent nel 2026?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Hermes Agent è gratuito: è codice open source con licenza MIT. Devi pagare soltanto il modello che elabora le richieste. Ci sono quattro possibilità: un abbonamento Nous Portal a partire da $20, l’accesso tramite un abbonamento ChatGPT, Claude Max, Grok o GitHub Copilot già esistente, le chiavi API di qualsiasi provider oppure un modello locale che non costa nulla.

</div>

L’opzione più semplice è Nous Portal, l’abbonamento nativo degli sviluppatori di Hermes. Include più di trecento modelli e anche servizi pronti all’uso: ricerca sul Web, generazione di immagini, sintesi vocale e un browser cloud. Al 22 agosto 2026, i piani sono:

| Piano | Prezzo mensile | Contenuto |
|----|----|----|
| Gratuito | \$0 | Accesso e periodo di prova senza limite mensile di spesa |
| Plus | \$20 | \$22 di utilizzo dei modelli, con un massimo di \$10 riportabile al mese successivo |
| Super | \$100 | \$110 di utilizzo dei modelli, con un massimo di \$50 riportabile |
| Ultra | \$200 | \$220 di utilizzo dei modelli, con un massimo di \$100 riportabile |

La seconda opzione, spesso trascurata, è che non devi necessariamente sottoscrivere un nuovo abbonamento. Hermes può accedere tramite OAuth, cioè usando un account che possiedi già. Sono supportati gli abbonamenti ChatGPT e Codex, Claude Max, SuperGrok di xAI, Qwen, MiniMax e GitHub Copilot. Scegli un provider durante la configurazione, conferma l’accesso nel browser e pagherai esattamente quanto pagavi prima.

La terza opzione è usare le tue chiavi API. Anthropic, OpenAI, Google, DeepSeek, Z.AI, Kimi, Alibaba e circa una dozzina di altri provider: inserisci una chiave e l’utilizzo viene addebitato direttamente sul relativo account.

La quarta opzione non costa denaro, ma richiede hardware: un modello locale tramite Ollama o LM Studio. È una soluzione adatta se hai un computer potente e non vuoi inviare dati all’esterno. C’è una condizione: il modello deve avere una finestra di contesto di almeno 64.000 token, altrimenti Hermes si rifiuta di avviarsi con quel modello: l’agente ha bisogno di sufficiente memoria di lavoro per le attività lunghe.

Qui non trattiamo le condizioni di pagamento per i servizi stranieri: è un argomento a parte con regole proprie, affrontato in [questa guida con Claude Code come esempio](https://ailoot.ai/blog/it/claude-code-plans-cost/).





## Come installare Hermes Agent su Windows

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Su Windows ci sono due modi per installarlo. Il più semplice è scaricare il programma di installazione di Hermes Desktop dal sito ufficiale e avviarlo come qualsiasi altro programma. Per usare la riga di comando, apri PowerShell ed esegui una riga: iex (irm <https://hermes-agent.nousresearch.com/install.ps1>). Entrambi i metodi sono gratuiti e richiedono un paio di minuti.

</div>

Se non hai dimestichezza con il terminale, inizia dal programma di installazione. Il sito hermes-agent.nousresearch.com offre i pulsanti di download per macOS 12+, Windows 10/11 e Linux. Il file scaricato installa entrambe le app: la riga di comando `hermes` e Hermes Desktop, una normale finestra con chat, file e impostazioni.

Se hai familiarità con i comandi, installalo tramite PowerShell:

1.  ### Apri PowerShell

    Premi Win, digita PowerShell e aprilo. Non sono necessari i privilegi di amministratore.

2.  ### Esegui il programma di installazione

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

    Lo script scarica tutto ciò che serve: Python 3.11, Node.js 22, il gestore di pacchetti uv, ripgrep e ffmpeg. Se non hai Git, installa la propria versione isolata di MinGit, conservata separatamente e senza modificare i programmi di sistema.

3.  ### Riavvia il terminale e verifica

    ```powershell
    hermes doctor
    ```

    Il comando mostra cosa è installato, cosa manca e come risolvere il problema. Se vedi segni di spunta verdi, l’installazione è completa.

Con questo metodo, i file vengono archiviati in `%LOCALAPPDATA%\hermes`. Se usi WSL2, funziona anche il comando Linux della sezione successiva: scegli il metodo più comodo.

## Come installare Hermes Agent su macOS e Linux

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Su macOS e Linux, installalo con un comando nel terminale: curl -fsSL <https://hermes-agent.nousresearch.com/install.sh> \| bash. Prima serve soltanto Git; il programma di installazione si occupa di Python, Node.js, ripgrep e ffmpeg. Su macOS puoi anche scaricare il programma di installazione dell’app dal sito, senza usare il comando.

</div>

Hermes si installa con un comando, su un portatile o su un server. Ecco l’intero processo:

1.  ### Verifica che Git sia installato

    ```bash
    git --version
    ```

    Se il comando restituisce un numero di versione, continua. Su Linux verifica anche la presenza di curl e xz-utils: su Debian e Ubuntu, installali con `sudo apt install curl xz-utils`.

2.  ### Esegui il programma di installazione

    ```bash
    curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
    ```

    Lo script clona il repository in `~/.hermes/hermes-agent`, crea un ambiente virtuale e installa il comando `hermes` in `~/.local/bin`. Per un server senza interfaccia grafica e automazione del browser, è disponibile un’opzione leggera: aggiungi `bash -s -- --skip-browser` alla fine.

3.  ### Ricarica la shell e avvia

    ```bash
    source ~/.zshrc   # su macOS; più spesso su Linux: source ~/.bashrc
    hermes
    ```

Se installi come root, i file vengono salvati nei percorsi di sistema ` /usr/local/lib/hermes-agent` e `/usr/local/bin/hermes`, una soluzione comoda per un server usato da più account. Impostazioni, chiavi e memoria restano nella cartella personale `~/.hermes` di ciascun utente.

Una nota su Hermes Desktop per Linux: per compilare l’app su Debian e Ubuntu servono i compilatori inclusi nel pacchetto build-essential (`sudo apt install build-essential`). Se hai installato Hermes con il comando, non ti serve un programma di installazione separato: esegui `hermes desktop` e l’app si avvierà con le impostazioni, le sessioni e le competenze già esistenti.

## Come collegare un modello a Hermes Agent

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Dopo l’installazione, esegui hermes model per aprire il selettore interattivo di provider e modelli. L’opzione più rapida è hermes setup --portal: con un solo comando accedi a Nous Portal, selezioni un modello e attivi i servizi di ricerca e immagini. Imposta le tue chiavi API con hermes config set.

</div>

Il modello è il motore di Hermes: l’agente non pensa da solo, ma contatta il modello che hai scelto. Perciò, il primo passo dopo l’installazione è scegliere a cosa si connetterà:

```bash
hermes model
```

La procedura guidata ti chiederà un provider, un metodo di accesso e un modello. Ci sono molte opzioni; le principali sono:

| Provider | Che cos’è | Come collegarlo |
|----|----|----|
| Nous Portal | Abbonamento degli sviluppatori, con 300+ modelli e servizi | Accedi tramite browser, senza bisogno di chiavi |
| Anthropic | Accesso diretto ai modelli Claude | OAuth tramite Claude Max o una chiave API |
| OpenAI Codex | Modelli OpenAI | Accedi tramite un abbonamento ChatGPT o Codex |
| Ollama / LM Studio | Modelli locali sul tuo hardware | Inserisci l’indirizzo del server locale |

Se scegli Nous Portal, un solo comando esegue tutte le operazioni:

```bash
hermes setup --portal
```

Si aprirà una pagina di accesso nel browser. Dopo la conferma, imposterà Nous come provider e attiverà Tool Gateway: ricerca sul Web, generazione di immagini e sintesi vocale senza chiavi separate per ogni servizio.

<div class="aside" data-semantic="callout" role="note" aria-label="Nota">

Nota

Il modello deve avere una finestra di contesto di almeno 64.000 token: è un requisito tassativo di Hermes. Tutti i modelli cloud elencati sopra lo soddisfano. Per un modello locale, imposta manualmente la dimensione del contesto: in Ollama usa il parametro `-c 65536`; in llama.cpp usa `--ctx-size 65536`.

</div>

Hermes conserva chiavi e impostazioni separatamente, ed è importante capirlo fin dall’inizio. I segreti, cioè chiavi API e token, sono salvati in `~/.hermes/.env`. Le impostazioni normali si trovano in `~/.hermes/config.yaml`. Non serve modificare manualmente questi file: `hermes config set` inserisce automaticamente ogni valore nel file corretto:

[Trova guide agli strumenti nella documentazione di Ailoot](https://ailoot.ai/docs/)

La procedura guidata completa è `hermes setup`. Ha tre modalità: configurazione rapida tramite Nous Portal, configurazione completa in cui scegli personalmente ogni provider e strumento, e Blank Slate, un’installazione pulita in cui tutto è disattivato tranne gli elementi essenziali, così puoi attivare solo quello che ti serve.

## Come verificare che Hermes Agent funzioni

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Esegui hermes e guarda il messaggio di benvenuto: dovrebbe mostrare il tuo modello e l’elenco degli strumenti. Fai una domanda semplice con una risposta verificabile, poi esci e torna con hermes -c: la sessione dovrebbe continuare. Se qualcosa non va, il primo strumento diagnostico è hermes doctor.

</div>

Dopo aver scelto un modello, avvia una conversazione:

```bash
hermes          # interfaccia classica
hermes --tui    # interfaccia moderna, con supporto del mouse e finestre pop-up
```

Il messaggio di benvenuto mostra il modello selezionato, gli strumenti attivati e le competenze. Poi non chiedere «ciao, chi sei?»: assegnagli un’attività con un risultato osservabile: «mostrami le cinque cartelle più grandi del disco» oppure «guarda la cartella corrente e dimmi qual è il file principale del progetto». Se l’agente esegue un comando nel terminale e restituisce una risposta significativa, la configurazione di base funziona.

L’ultima verifica riguarda le sessioni. Esci dalla conversazione e rientra:

```bash
hermes --continue   # oppure, in breve: hermes -c
```

Dovresti ritrovarti nella stessa conversazione. Questo verifica che la memoria della sessione venga salvata su disco: in seguito ne dipenderanno il bot e le attività programmate.

<figure>
<blockquote>
<p>Se Hermes non riesce a completare una normale conversazione, non aggiungere ancora nuove funzionalità. Prima fai funzionare una conversazione senza problemi e solo dopo collega gateway, pianificazioni, competenze, voce e routing.</p>
</blockquote>
<figcaption>— Documentazione di Hermes Agent, guida rapida, https://hermes-agent.nousresearch.com/docs/getting-started/quickstart</figcaption>
</figure>

Se qualcosa non funziona, segui questo ordine: `hermes doctor` (diagnostica generale), `hermes model` (verifica di nuovo modello e accesso), `hermes setup` (ricrea la configurazione), `hermes sessions list` e `hermes --continue` (verifica le sessioni), `hermes gateway status` (stato del gateway). In un paio di minuti questa sequenza può portarti da «non funziona niente» a una situazione chiara.

## Cosa sono le competenze e la memoria in Hermes Agent?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Le competenze sono procedure pronte all’uso: documenti con istruzioni passo per passo che l’agente carica solo quando servono. La memoria consiste in due file con informazioni su di te e sul tuo ambiente, aggiunti a ogni nuova conversazione. L’agente non si limita a leggere entrambi: li scrive anche.

</div>

Una competenza di Hermes è un file `SKILL.md` con un nome, una descrizione e una procedura passo per passo: per esempio, come assemblare un documento, aprire una pull request o preparare una campagna e-mail. L’agente legge le brevi descrizioni di tutte le competenze, poi carica il testo completo solo quando l’attività corrisponde: così cento competenze installate non appesantiscono ogni richiesta. Lo standard è aperto, [agentskills.io](https://agentskills.io), e gli stessi file funzionano anche con altri agenti.

Le competenze si trovano nella cartella `~/.hermes/skills/`. Si installano in tre modi: un set di base viene incluso nell’app, le competenze pronte all’uso si aggiungono dal catalogo con `hermes skills install` e, dopo le attività complesse, l’agente ne scrive di nuove per sé. Ogni competenza diventa automaticamente un comando slash: installa la competenza gif-search e `/gif-search` funzionerà in qualsiasi chat. L’installazione dal catalogo prevede un controllo di sicurezza, per evitare che le procedure di qualcun altro includano comandi dannosi.

La memoria è ancora più semplice. Ci sono due file in `~/.hermes/memories/`: `MEMORY.md`, gli appunti dell’agente sul suo ambiente e le sue conclusioni, fino a 2.200 caratteri, e `USER.md`, il tuo profilo: come risponderti, cosa ti piace e cosa non ti piace, fino a 1.375 caratteri. All’inizio di ogni conversazione, entrambi i file vengono aggiunti al prompt di sistema, così l’agente inizia già sapendo alcune cose di te. I limiti sono volutamente rigorosi: la memoria non si dilunga e l’agente decide cosa conservare e cosa eliminare.

Questi due elementi, competenze e memoria, costituiscono il Second Brain: un agente che ricorda il contesto e accumula procedure, lavorando ogni settimana molto meglio rispetto al giorno dell’installazione. Per indicazioni su come scegliere queste competenze ed evitare che l’agente diventi un deposito disordinato, consulta [questa guida con Claude Code come esempio](https://ailoot.ai/blog/it/choose-claude-code-skills/): i principi sono gli stessi.

## Come collegare Hermes Agent a Telegram

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Crea un bot con @BotFather e recupera il suo token, trova il tuo ID numerico di Telegram, per esempio 123456789, esegui hermes gateway setup e seleziona Telegram, poi avvia hermes gateway. Il bot sarà online in un minuto e risponderà solo agli utenti inclusi nell’elenco di accesso. Nelle chat di gruppo, configura separatamente la modalità privacy.

</div>

Telegram è il canale più popolare di Hermes e l’integrazione è ben sviluppata: testo, messaggi vocali con trascrizione, immagini e file, oltre alle risposte nei gruppi. Ecco la procedura:

1.  ### Crea un bot con BotFather

    Apri @BotFather su Telegram, invia `/newbot`, scegli un nome e un nome utente univoco che termini con bot. Riceverai un token simile a `123456789:ABCdef...`: è la chiave del tuo bot, quindi conservala come una password. Se il token viene divulgato, revocalo inviando `/revoke` allo stesso BotFather.

2.  ### Trova il tuo ID utente

    Trova il tuo ID numerico di Telegram, per esempio 123456789. È il numero del tuo account; non confonderlo con il nome utente. Ti servirà per l’elenco di accesso.

3.  ### Avvia la procedura guidata di configurazione del gateway

    ```bash
    hermes gateway setup
    ```

    Seleziona Telegram e incolla il token e l’ID. La procedura guidata salverà le impostazioni. Puoi fare lo stesso manualmente con due righe in `~/.hermes/.env`: `TELEGRAM_BOT_TOKEN=...` e `TELEGRAM_ALLOWED_USERS=123456789`.

4.  ### Avvia il gateway

    ```bash
    hermes gateway
    ```

    Il bot sarà online in pochi secondi. Scrivigli e verifica la risposta.

L’accesso è chiuso per impostazione predefinita: il bot risponde soltanto agli ID presenti nell’elenco. Puoi fornire a una nuova persona un codice di associazione, valido per un’ora e poi in scadenza. Puoi consultare l’elenco degli utenti in attesa e approvati con `hermes pairing list`.

C’è una particolarità delle chat di gruppo che spesso si dimentica. Per impostazione predefinita, la modalità privacy dei bot Telegram è attiva: nei gruppi, un bot vede solo i comandi e le risposte ai propri messaggi. Per permettergli di leggere tutto, disattiva la modalità con @BotFather (Bot Settings - Group Privacy) oppure, più semplicemente, rendi il bot amministratore del gruppo.

<figure>
<blockquote>
<p>Dopo aver modificato l’impostazione privacy del bot, rimuovilo dal gruppo e aggiungilo di nuovo. Telegram conserva l’impostazione privacy presente quando il bot viene aggiunto e non la aggiorna finché non lo aggiungi nuovamente.</p>
</blockquote>
<figcaption>— Documentazione di Hermes Agent, sezione Telegram, https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram</figcaption>
</figure>

Per impostazione predefinita, il gateway interroga autonomamente i server di Telegram: va bene per un computer di casa o un server sempre acceso. Per le piattaforme cloud che mettono a riposo la macchina quando non c’è traffico in entrata, è disponibile la modalità webhook, in cui Telegram invia i messaggi al tuo indirizzo.

## Cos’altro può fare Hermes Agent dopo l’installazione?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Dopo la configurazione di base, puoi aggiungere il livello successivo: attività programmate che inviano automaticamente i risultati a un’app di messaggistica, subagenti per attività parallele, un pannello Web di gestione, la modalità vocale e l’uso da un editor di codice. Attiva queste funzioni una alla volta, quando la conversazione principale è stabile.

</div>

Ecco cosa attivare, nell’ordine:

1.  **Attività programmate.** Il gateway ha un pianificatore integrato: «Ogni mattina alle 8, prepara una rassegna di notizie sui miei argomenti e mandamela su Telegram.» Imposta la pianificazione con una frase normale e i risultati arriveranno nella stessa chat.
2.  **Hermes Desktop.** Il comando `hermes desktop` apre l’app per macOS, Windows e Linux con lo stesso agente: risposte in streaming, anteprime dei file accanto alla chat, trascinamento dei documenti e un contatore del contesto. Le sessioni sono condivise: puoi iniziare nel terminale e continuare nella finestra.
3.  **Pannello Web.** `hermes dashboard` apre nel browser un pannello per canali, memoria, webhook e profili. È utile quando Hermes funziona su un server.
4.  **Subagenti.** Puoi delegare un’attività complessa ad agenti ausiliari isolati: ognuno ha la propria conversazione e il proprio terminale, quindi non consuma il tuo contesto.
5.  **Voce.** La modalità vocale funziona nel terminale, su Telegram e su Discord: puoi dettare un’attività e ricevere una risposta a voce.
6.  **Editor di codice.** Tramite il protocollo ACP, Hermes si collega a VS Code, Zed e JetBrains come agente integrato direttamente nell’editor.

Puoi attivare e disattivare gli strumenti uno alla volta con `hermes tools`, così l’agente non deve portarseli tutti dietro. Quando è il momento di passare a un altro computer, `hermes backup` raccoglie l’intera installazione in un archivio e `hermes import` lo estrae nella nuova posizione.

## A chi è adatto Hermes Agent e chi dovrebbe aspettare?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Hermes Agent è una buona scelta se vuoi un agente compatibile con qualsiasi modello, che si ricordi di te, funzioni sul tuo hardware e risponda tramite un’app di messaggistica. È presto per provarlo se non vuoi aprire un terminale nemmeno per incollare un singolo comando o se ti serve un servizio browser già pronto, senza alcuna configurazione.

</div>

Ha senso installare Hermes quando hai capito cosa vuoi far fare a un agente: organizzare documenti, creare un prototipo, gestire la corrispondenza o preparare rassegne mattutine. Lo strumento in sé non è la cosa importante: contano le attività che gli assegni. Su questo argomento c’è una [guida alle attività per un agente AI](https://ailoot.ai/blog/it/business-tasks-for-ai-agents/).

Potrebbe non fare al caso tuo in due situazioni. Primo, se ti aspetti di «registrarti e iniziare a usarlo»: Hermes va installato e collegato a un modello. Basta un comando, ma devi comunque aprire il terminale. Secondo, se non hai un modello adatto e non vuoi informarti su un abbonamento o sulle chiavi API.

Tutti gli altri possono iniziare in piccolo: installarlo, scegliere un modello, avere una conversazione senza problemi, poi aggiungere un bot Telegram e solo dopo le pianificazioni e i subagenti.

## Cos’altro chiedono le persone su Hermes Agent?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Risposte rapide alle domande più comuni su installazione e configurazione: Hermes Agent è gratuito come strumento; puoi parlargli nella lingua che preferisci se il modello selezionato la supporta; serve un server solo per mantenere il bot sempre attivo; i comandi pericolosi richiedono la tua conferma; e un confronto dettagliato con OpenClaw è disponibile in [OpenClaw o Hermes Agent: quale scegliere?](https://ailoot.ai/blog/it/openclaw-vs-hermes-agent/).

</div>

<div class="section">

### Domande frequenti

Hermes Agent è gratuito?

Sì. L’agente è codice open source con licenza MIT e non devi pagare per usarlo su un computer o su un server. L’unico costo possibile è il modello a cui lo colleghi: un abbonamento Nous Portal, chiavi API oppure nulla, se accedi tramite un abbonamento ChatGPT, Claude Max, Grok, Qwen, MiniMax o GitHub Copilot già esistente, oppure usi un modello locale tramite Ollama.

In che lingua posso parlare con Hermes Agent?

L’interfaccia, la documentazione e i comandi sono in inglese. Puoi parlare all’agente nella lingua che preferisci se il modello selezionato la supporta. Non serve scrivere i prompt tramite un traduttore.

Mi serve un server per usare Hermes Agent?

No, per uso personale basta un portatile: Windows, macOS o Linux. Un server serve solo in un caso: se vuoi che l’agente funzioni 24 ore su 24, risponda su Telegram quando il computer è spento ed esegua attività programmate. La documentazione dice esplicitamente che Hermes funziona bene su un VPS da $5.

È sicuro dare a un agente accesso al terminale?

Per impostazione predefinita, Hermes chiede conferma prima di eseguire comandi pericolosi. Esiste una modalità YOLO che disattiva le conferme: la attivi tu, consapevolmente. Un container può ridurre l’accesso se configurato con cura, ma non offre isolamento completo. Non montare directory sensibili dell’host o il socket Docker, non concedere modalità privilegiata o capacità superflue e non fornire credenziali di produzione. Limita anche la rete: il container può raggiungere i servizi accessibili. Una macchina separata richiede a sua volta percorsi di rete e credenziali limitati; la sola separazione fisica non elimina l’accesso remoto. Verifica l’accesso effettivo dell’agente prima di usare dati reali. Consulta le [indicazioni di sicurezza di Docker](https://docs.docker.com/engine/security/).

In cosa Hermes Agent è diverso da OpenClaw?

Entrambi sono agenti aperti orientati alle app di messaggistica e vengono spesso confrontati nei risultati di ricerca. Hermes punta sulle competenze scritte autonomamente, sulla memoria tra sessioni e sulla compatibilità con qualsiasi modello. Per un confronto dettagliato punto per punto, consulta la guida dedicata OpenClaw o Hermes Agent: quale scegliere?

</div>

<div class="section" role="doc-bibliography" aria-label="Fonti">

### Fonti

- [Hermes Agent, sito ufficiale](https://hermes-agent.nousresearch.com/)
- [Hermes Agent, documentazione](https://hermes-agent.nousresearch.com/docs/)
- [Hermes Agent, installazione](https://hermes-agent.nousresearch.com/docs/getting-started/installation)
- [Hermes Agent, guida rapida](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart)
- [Hermes Desktop, descrizione dell’app](https://hermes-agent.nousresearch.com/docs/user-guide/desktop)
- [Hermes Agent, sistema di competenze](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills)
- [Hermes Agent, memoria persistente](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory)
- [Hermes Agent, gateway di messaggistica](https://hermes-agent.nousresearch.com/docs/user-guide/messaging)
- [Hermes Agent, configurazione di Telegram](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram)
- [Repository Hermes Agent su GitHub](https://github.com/NousResearch/hermes-agent)
- [Nous Portal, piani e modelli](https://portal.nousresearch.com/)
- [agentskills.io, standard aperto per le competenze](https://agentskills.io)
- [Repository di Codex di OpenAI su GitHub](https://github.com/openai/codex)

</div>





Altre risorse sono disponibili su [Ailoot](https://ailoot.ai/).

## Domande frequenti

### Eseguire Hermes in Docker garantisce l’isolamento dal computer?

No. Directory host montate, socket Docker, privilegi, percorsi di rete e credenziali fornite determinano ciò che può raggiungere. Limita ciascuno di questi elementi e verifica l’accesso effettivo; anche una macchina separata richiede restrizioni di rete e credenziali.

### Cosa deve funzionare prima di aggiungere Telegram o attività pianificate?

Completa prima una conversazione ordinaria con il modello scelto e verifica di poter continuare la sessione. Se non riesce, usa la diagnostica di base e la configurazione del modello prima di aggiungere gateway, pianificazioni o altri strumenti.


## Ailoot · L’azienda e il suo portafoglio di progetti

Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.
