nousresearch/hermes-agentL'agente che cresce con te
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7225/75e85ef6fecf5a6227985f2082e5b35331fceff4d8db03720c82a7d9ee8b7eea.png" alt="Hermes Agent" width="100%">
</p>
# Hermes Agent ☤
<p align="center">
<a href="https://hermes-agent.nousresearch.com/">Hermes Agent</a> | <a href="https://hermes-agent.nousresearch.com/">Hermes Desktop</a>
</p>
<p align="center">
<a href="https://hermes-agent.nousresearch.com/docs/"><img src="https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge" alt="Documentazione"></a>
<a href="https://discord.gg/NousResearch"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
<a href="https://github.com/NousResearch/hermes-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="Licenza: MIT"></a>
<a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Realizzato da Nous Research"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-%E4%B8%AD%E6%96%87-red?style=for-the-badge" alt="中文"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.ur-pk.md"><img src="https://img.shields.io/badge/Lang-%D8%A7%D8%B1%D8%AF%D9%88-green?style=for-the-badge" alt="اردو"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.es.md"><img src="https://img.shields.io/badge/Lang-Espa%C3%B1ol-orange?style=for-the-badge" alt="Español"></a>
</p>
**L'agente AI auto-migliorante creato da [Nous Research](https://nousresearch.com).** È l'unico agente con un ciclo di apprendimento integrato — crea competenze dall'esperienza, le migliora durante l'uso, si spinge a persistere la conoscenza, cerca nelle proprie conversazioni passate e costruisce un modello sempre più profondo di chi sei attraverso le sessioni. Eseguilo su un VPS da 5 $, su un cluster GPU o su un'infrastruttura serverless che costa quasi nulla quando è inattiva. Non è legato al tuo laptop — parlaci da Telegram mentre lavora su una VM cloud.
Usa qualsiasi modello tu voglia — [Nous Portal](https://portal.nousresearch.com), OpenRouter, OpenAI, il tuo endpoint e [molti altri](https://hermes-agent.nousresearch.com/docs/integrations/providers). Cambia con `hermes model` — nessuna modifica al codice, nessun lock-in.
<table>
<tr><td><b>Una vera interfaccia terminale</b></td><td>TUI completa con modifica multilinea, completamento automatico dei comandi slash, cronologia delle conversazioni, interruzione-e-reindirizzamento e output degli strumenti in streaming.</td></tr>
<tr><td><b>Vive dove vivi tu</b></td><td>Telegram, Discord, Slack, WhatsApp, Signal e CLI — tutto da un unico processo gateway. Trascrizione di memo vocali, continuità delle conversazioni multipiattaforma.</td></tr>
<tr><td><b>Un ciclo di apprendimento chiuso</b></td><td>Memoria curata dall'agente con sollecitazioni periodiche. Creazione autonoma di competenze dopo compiti complessi. Le competenze si auto-migliorano durante l'uso. Ricerca nelle sessioni FTS5 con riepilogo LLM per il richiamo tra sessioni. Modellazione dialettica dell'utente tramite <a href="https://github.com/plastic-labs/honcho">Honcho</a>. Compatibile con lo standard aperto <a href="https://agentskills.io">agentskills.io</a>.</td></tr>
<tr><td><b>Automazioni pianificate</b></td><td>Scheduler cron integrato con consegna su qualsiasi piattaforma. Report giornalieri, backup notturni, audit settimanali — tutto in linguaggio naturale, in esecuzione senza supervisione.</td></tr>
<tr><td><b>Delega e parallelizza</b></td><td>Genera subagenti isolati per flussi di lavoro paralleli. In Desktop, scegli il loro provider, modello e limiti in Impostazioni → Modello → Subagenti, poi applica la route completa. Scrivi script Python che chiamano strumenti via RPC, riducendo pipeline multi-fase in turni a costo di contesto zero.</td></tr>
<tr><td><b>Funziona ovunque, non solo sul tuo laptop</b></td><td>Sette backend terminali — locale, Docker, SSH, Singularity, Modal, Daytona e Vercel Sandbox. Daytona e Modal offrono persistenza serverless — l'ambiente del tuo agente va in ibernazione quando è inattivo e si risveglia su richiesta, costando quasi nulla tra le sessioni. Eseguilo su un VPS da 5 $ o su un cluster GPU.</td></tr>
<tr><td><b>Pronto per la ricerca</b></td><td>Generazione di traiettorie in batch, compressione delle traiettorie per addestrare la prossima generazione di modelli di tool-calling.</td></tr>
</table>
---
## Installazione rapida
### Linux, macOS, WSL2
```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```
### Windows (nativo, PowerShell)
> **Attenzione:** Windows nativo esegue Hermes senza WSL — CLI, gateway, TUI e strumenti funzionano tutti nativamente. Se preferisci usare WSL2, anche il one-liner per Linux/macOS riportato sopra funziona lì. Hai trovato un bug? Per favore [apri una segnalazione](https://github.com/NousResearch/hermes-agent/issues).
Esegui questo comando in PowerShell:
```powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```
L'installer di origine delega Python 3.14, Node.js, npm, ripgrep, FFmpeg e le dipendenze Python a PM. Se Git è assente, colloca l'archivio verificato di Git for Windows nell'archivio degli strumenti di Hermes. Non sostituisce il tuo Git di sistema. Consulta i [metodi di installazione](https://hermes-agent.nousresearch.com/docs/getting-started/installation) per il pacchetto separato MSIX/App Installer e la relativa gestione degli aggiornamenti.
> **Android / Termux:** È disponibile un repository APT firmato per dispositivi aarch64, con un canale `stable` (release con tag) e un canale prerelease `canary`. Il pacchetto include Python, Node.js e la TUI. Usa la [guida Termux](https://hermes-agent.nousresearch.com/docs/getting-started/termux), non lo script di installazione per desktop/server.
>
> **Windows:** Windows nativo è completamente supportato — il one-liner PowerShell sopra installa tutto. Se preferisci usare WSL2, anche il comando Linux funziona lì. L'installazione su Windows nativo risiede in `%LOCALAPPDATA%\hermes`; le installazioni WSL2 risiedono in `~/.hermes` come su Linux.
Dopo l'installazione:
```bash
source ~/.bashrc # reload shell (or: source ~/.zshrc)
hermes # start chatting!
```
### Risoluzione dei problemi
#### Windows Defender o l'antivirus segnala `uv.exe` come malware
Se il tuo antivirus (Bitdefender, Windows Defender, ecc.) mette in quarantena `uv.exe` dalla cartella `bin` di Hermes (`%LOCALAPPDATA%\hermes\bin\uv.exe`), si tratta di un **falso positivo**. Il file è `uv` di Astral — il gestore di pacchetti Python scritto in Rust che Hermes include per gestire il proprio ambiente Python. I motori antivirus basati su ML segnalano comunemente i binari Rust non firmati che scaricano e installano pacchetti.
**Per verificare che la tua copia sia autentica:**
```powershell
# Install GitHub CLI if needed
winget install --id GitHub.cli
# Login to GitHub
gh auth login
# Run verification
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash
```
Se l'attestazione dice "Verification succeeded" e l'ultima riga stampa `True`, sei a posto.
**Per inserire Hermes nella whitelist:**
- **Windows Defender:** Esegui PowerShell come Admin → `Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"`
- **Bitdefender:** Aggiungi un'eccezione nella console di Bitdefender (Protection > Antivirus > Settings > Manage Exceptions)
- Inserisci nella whitelist la **cartella**, non l'hash del file — Hermes aggiorna `uv` e l'hash cambia a ogni versione
Per maggiori contesto, consulta i report upstream di Astral: [astral-sh/uv#13553](https://github.com/astral-sh/uv/issues/13553), [astral-sh/uv#15011](https://github.com/astral-sh/uv/issues/15011), [astral-sh/uv#10079](https://github.com/astral-sh/uv/issues/10079).
---
## Per iniziare
```bash
hermes # Interactive CLI — start a conversation
hermes model # Choose your LLM provider and model
hermes tools # Configure which tools are enabled
hermes config set # Set individual config values
hermes config get # Print individual config values
hermes gateway # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update # Update to the latest version
hermes doctor # Diagnose any issues
```
📖 **[Documentazione completa →](https://hermes-agent.nousresearch.com/docs/)**
---
## Salta la raccolta delle chiavi API — Nous Portal
Hermes funziona con qualsiasi provider tu voglia — questo non cambia. Ma se preferisci non raccogliere cinque chiavi API separate per il modello, la ricerca web, la generazione di immagini, il TTS e un browser cloud, **[Nous Portal](https://portal.nousresearch.com)** li copre tutti con un unico abbonamento:
- **Oltre 300 modelli** — scegline uno qualsiasi con `/model <name>`
- **Tool Gateway** — ricerca web, generazione di immagini (FAL), sintesi vocale (OpenAI), browser cloud (Browser Use), tutto instradato tramite il tuo abbonamento. Nessun account aggiuntivo.
Un solo comando da un'installazione pulita:
```bash
hermes setup --portal
```
Questo ti effettua l'accesso tramite OAuth, imposta Nous come tuo provider e attiva il Tool Gateway. Controlla in qualsiasi momento cosa è configurato con `hermes portal info`. Tutti i dettagli nella [pagina della documentazione del Tool Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/features/tool-gateway).
Puoi comunque usare le tue chiavi per singolo strumento quando vuoi — il gateway è per-backend, non tutto-o-niente.
---
## Riferimento rapido CLI vs Messaggistica
Hermes ha due punti di accesso: avvia l'interfaccia terminale con `hermes`, oppure esegui il gateway e comunicale da Telegram, Discord, Slack, WhatsApp, Signal o Email. Una volta dentro una conversazione, molti comandi slash sono condivisi tra entrambe le interfacce.
| Azione | CLI | Piattaforme di messaggistica |
| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
| Iniziare a chattare | `hermes` | Esegui `hermes gateway setup` + `hermes gateway start`, poi invia un messaggio al bot |
| Iniziare una nuova conversazione | `/new` o `/reset` | `/new` o `/reset` |
| Cambiare modello | `/model [provider:model]` | `/model [provider:model]` |
| Impostare una personalità | `/personality [name]` | `/personality [name]` |
| Ripetere o annullare l'ultimo turno | `/retry`, `/undo` | `/retry`, `/undo` |
| Comprimere il contesto / controllare l'utilizzo | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]` |
| Sfogliare le skill | `/skills` o `/<skill-name>` | `/<skill-name>` |
| Interrompere il lavoro corrente | `Ctrl+C` o invia un nuovo messaggio | `/stop` o invia un nuovo messaggio |
| Stato specifico della piattaforma | `/platforms` | `/status`, `/sethome` |
Per gli elenchi completi dei comandi, consulta la [guida CLI](https://hermes-agent.nousresearch.com/docs/user-guide/cli) e la [guida al Messaging Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging).
---
## Documentazione
Tutta la documentazione è disponibile su **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)**:
| Sezione | Contenuto |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [Quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | Installazione → configurazione → prima conversazione in 2 minuti |
| [CLI Usage](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | Comandi, scorciatoie da tastiera, personalità, sessioni |
| [Configuration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | File di configurazione, provider, modelli, tutte le opzioni |
| [Messaging Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| [Security](https://hermes-agent.nousresearch.com/docs/user-guide/security) | Approvazione dei comandi, abbinamento DM, isolamento dei container |
| [Tools & Toolsets](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | Oltre 40 strumenti, sistema di toolset, backend del terminale |
| [Skills System](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | Memoria procedurale, Skills Hub, creazione di skill |
| [Memory](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | Memoria persistente, profili utente, best practice |
| [MCP Integration](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | Connetti qualsiasi server MCP per funzionalità estese |
| [Cron Scheduling](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | Attività pianificate con consegna sulla piattaforma |
| [Context Files](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | Contesto del progetto che modella ogni conversazione |
| [Architecture](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | Struttura del progetto, ciclo dell'agente, classi principali |
| [Contributing](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | Configurazione per lo sviluppo, processo PR, stile del codice |
| [CLI Reference](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | Tutti i comandi e i flag |
| [Environment Variables](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | Riferimento completo alle variabili d'ambiente |
---
## Migrazione da OpenClaw
Se provieni da OpenClaw, Hermes può importare automaticamente le tue impostazioni, memorie, skill e chiavi API.
**Durante la prima configurazione:** La procedura guidata di setup (`hermes setup`) rileva automaticamente `~/.openclaw` e propone la migrazione prima che inizi la configurazione.
**In qualsiasi momento dopo l'installazione:**
```bash
hermes claw migrate # Interactive migration (full preset)
hermes claw migrate --dry-run # Preview what would be migrated
hermes claw migrate --preset user-data # Migrate without secrets
hermes claw migrate --overwrite # Overwrite existing conflicts
```
Cosa viene importato:
- **SOUL.md** — file della persona
- **Memories** — voci di MEMORY.md e USER.md
- **Skills** — competenze create dall'utente → `~/.hermes/skills/openclaw-imports/`
- **Command allowlist** — pattern di approvazione
- **Messaging settings** — configurazioni della piattaforma, utenti consentiti, directory di lavoro
- **API keys** — segreti in allowlist (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
- **TTS assets** — file audio del workspace
- **Workspace instructions** — AGENTS.md (con `--workspace-target`)
Consulta `hermes claw migrate --help` per tutte le opzioni, oppure usa la skill `openclaw-migration` per una migrazione interattiva guidata dall'agente con anteprime dry-run.
---
## Contributing
Accogliamo con piacere i contributi! Consulta la [Contributing Guide](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) per la configurazione dello sviluppo, lo stile del codice e il processo delle PR.
Inizia dal [PM developer workflow](https://github.com/nousresearch/hermes-agent/blob/main/website/docs/reference/package-management.md#developer-workflow)
per l'attivazione, l'uso quotidiano, le modifiche alle dipendenze e l'uscita dall'ambiente.
[Development Setup](https://github.com/nousresearch/hermes-agent/blob/main/CONTRIBUTING.md#development-setup) copre l'ambiente di test separato e i comandi di verifica.
---
## Community
- 💬 [Discord](https://discord.gg/NousResearch)
- 📚 [Skills Hub](https://agentskills.io)
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — server MCP per il controllo del desktop Linux per Hermes e altri host MCP, con alberi di accessibilità AT-SPI, input Wayland/X11, screenshot e targeting delle finestre del compositor.
- 🔌 [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — bridge WeChat della community: esegui Hermes Agent e OpenClaw sullo stesso account WeChat.
---
## License
MIT — vedi [LICENSE](https://github.com/nousresearch/hermes-agent/blob/main/LICENSE).
Realizzato da [Nous Research](https://nousresearch.com).