nousresearch/hermes-agentL'agente che cresce con te
L'agente AI auto-migliorante creato da Nous Research. È 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, un cluster GPU o 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, OpenRouter, OpenAI, il tuo endpoint personale e molti altri. Cambia con hermes model — nessuna modifica al codice, nessun vincolo.
| Una vera interfaccia terminale | TUI completa con editing multilinea, autocompletamento dei comandi slash, cronologia delle conversazioni, interruzione e reindirizzamento, e output degli strumenti in streaming. |
| Vive dove vivi tu | Telegram, Discord, Slack, WhatsApp, Signal e CLI — tutto da un singolo processo gateway. Trascrizione dei memo vocali, continuità delle conversazioni tra piattaforme. |
| Un ciclo di apprendimento chiuso | Memoria curata dall'agente con solleciti periodici. Creazione autonoma di competenze dopo attività complesse. Le competenze si auto-migliorano durante l'uso. Ricerca sessioni FTS5 con riepilogo LLM per il richiamo tra sessioni. Honcho modellazione utente dialettica. Compatibile con lo standard aperto agentskills.io. |
| Automazioni pianificate | Pianificatore cron integrato con consegna su qualsiasi piattaforma. Report giornalieri, backup notturni, audit settimanali — tutto in linguaggio naturale, eseguito senza supervisione. |
| Delega e parallelizza | Genera subagenti isolati per flussi di lavoro paralleli. Scrivi script Python che chiamano strumenti tramite RPC, comprimendo pipeline multi-fase in turni a costo di contesto zero. |
| Funziona ovunque, non solo sul tuo laptop | 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 un cluster GPU. |
| Pronto per la ricerca | Generazione batch di traiettorie, compressione delle traiettorie per addestrare la prossima generazione di modelli di chiamata agli strumenti. |
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Attenzione: Windows nativo esegue Hermes senza WSL — CLI, gateway, TUI e strumenti funzionano tutti nativamente. Se preferisci usare WSL2, il comando one-liner per Linux/macOS funziona anche lì. Trovato un bug? Per favore segnala i problemi.
Esegui questo in PowerShell:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
L'installer gestisce tutto: uv, Python 3.11, Node.js, ripgrep, ffmpeg, e un Git Bash portatile (MinGit, estratto in %LOCALAPPDATA%\hermes\git — nessun admin richiesto, completamente isolato da qualsiasi installazione Git di sistema). Hermes usa questo Git Bash integrato per eseguire i comandi shell.
Se hai già Git installato, l'installer lo rileva e lo usa al suo posto. Altrimenti, un download MinGit di ~45MB è tutto ciò che serve — non toccherà né interferirà con alcun Git di sistema.
Android / Termux: Il percorso manuale testato è documentato nella guida Termux. Su Termux, Hermes installa un extra
.[termux]curato perché l'extra completo.[all]attualmente tira dipendenze vocali incompatibili con Android.Windows: Windows nativo è completamente supportato — il comando one-liner PowerShell sopra installa tutto. Se preferisci usare WSL2, il comando Linux funziona anche lì. L'installazione nativa su Windows vive in
%LOCALAPPDATA%\hermes; l'installazione WSL2 vive in~/.hermescome su Linux.
Dopo l'installazione:
source ~/.bashrc # ricarica la shell (oppure: source ~/.zshrc)
hermes # inizia a chattare!
uv.exe come malwareSe 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 in Rust che Hermes include per gestire il proprio ambiente Python. I motori antivirus basati su ML segnalano comunemente binari Rust non firmati che scaricano e installano pacchetti.
Per verificare che la tua copia sia autentica:
# Installa GitHub CLI se necessario
winget install --id GitHub.cli
# Accedi a GitHub
gh auth login
# Esegui la verifica
$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:
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"uv e l'hash cambia a ogni versionePer più contesto, vedi i report upstream di Astral: astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079.
hermes # CLI interattiva — inizia una conversazione
hermes model # Scegli il tuo provider LLM e modello
hermes tools # Configura quali strumenti sono abilitati
hermes config set # Imposta singoli valori di configurazione
hermes config get # Stampa singoli valori di configurazione
hermes gateway # Avvia il gateway di messaggistica (Telegram, Discord, ecc.)
hermes setup # Esegui la procedura di configurazione completa (configura tutto in una volta)
hermes claw migrate # Migra da OpenClaw (se provieni da OpenClaw)
hermes update # Aggiorna all'ultima versione
hermes doctor # Diagnostica eventuali problemi
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, TTS e un browser cloud, Nous Portal copre tutto con un unico abbonamento:
/model <nome>Un comando da un'installazione fresca:
hermes setup --portal
Questo ti fa accedere tramite OAuth, imposta Nous come provider e attiva il Tool Gateway. Controlla cosa è collegato in qualsiasi momento con hermes portal info. Dettagli completi nella pagina della documentazione del Tool Gateway.
Puoi comunque portare le tue chiavi per singolo strumento quando vuoi — il gateway è per backend, non tutto-o-niente.
Hermes ha due punti di ingresso: avvia l'interfaccia terminale con hermes, oppure esegui il gateway e parlaci da Telegram, Discord, Slack, WhatsApp, Signal o Email. Una volta in una conversazione, molti comandi slash sono condivisi tra entrambe le interfacce.
| Azione | CLI | Piattaforme di messaggistica |
|---|---|---|
| Inizia a chattare | hermes | Esegui hermes gateway setup + hermes gateway start, poi invia un messaggio al bot |
| Inizia una nuova conversazione | /new o /reset | /new o /reset |
| Cambia modello | /model [provider:modello] | /model [provider:modello] |
| Imposta una personalità | /personality [nome] | /personality [nome] |
| Riprova o annulla l'ultimo turno | /retry, /undo | /retry, /undo |
| Comprimi contesto / controlla utilizzo | /compress, /usage, /insights [--days N] | /compress, /usage, /insights [giorni] |
| Sfoglia le competenze | /skills o /<nome-competenza> | /<nome-competenza> |
| Interrompi 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, vedi la guida CLI e la guida al Messaging Gateway.
Tutta la documentazione vive su hermes-agent.nousresearch.com/docs:
| Sezione | Cosa Copre |
|---|---|
| Quickstart | Installazione → configurazione → prima conversazione in 2 minuti |
| Utilizzo CLI | Comandi, scorciatoie da tastiera, personalità, sessioni |
| Configurazione | File di configurazione, provider, modelli, tutte le opzioni |
| Messaging Gateway | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| Sicurezza | Approvazione dei comandi, abbinamento DM, isolamento dei container |
| Strumenti e Toolset | 40+ strumenti, sistema di toolset, backend terminali |
| Sistema di Competenze | Memoria procedurale, Skills Hub, creazione di competenze |
| Memoria | Memoria persistente, profili utente, migliori pratiche |
| Integrazione MCP | Connetti qualsiasi server MCP per capacità estese |
| Pianificazione Cron | Attività pianificate con consegna su piattaforma |
| File di Contesto | Contesto di progetto che modella ogni conversazione |
| Architettura | Struttura del progetto, ciclo dell'agente, classi chiave |
| Contribuire | Configurazione di sviluppo, processo PR, stile del codice |
Se provieni da OpenClaw, Hermes può importare automaticamente le tue impostazioni, memorie, competenze e chiavi API.
Durante la prima configurazione: La procedura guidata (hermes setup) rileva automaticamente ~/.openclaw e offre di migrare prima che inizi la configurazione.
In qualsiasi momento dopo l'installazione:
hermes claw migrate # Migrazione interattiva (preset completo)
hermes claw migrate --dry-run # Anteprima di cosa verrebbe migrato
hermes claw migrate --preset user-data # Migra senza segreti
hermes claw migrate --overwrite # Sovrascrivi i conflitti esistenti
Cosa viene importato:
~/.hermes/skills/openclaw-imports/--workspace-target)Vedi hermes claw migrate --help per tutte le opzioni, oppure usa la competenza openclaw-migration per una migrazione interattiva guidata dall'agente con anteprime dry-run.
Accogliamo con piacere i contributi! Vedi la Guida ai Contributi per la configurazione di sviluppo, lo stile del codice e il processo PR.
Avvio rapido per i contributori — usa l'installer standard, poi lavora dal
checkout git completo che crea in $HERMES_HOME/hermes-agent (di solito
~/.hermes/hermes-agent). Questo corrisponde al layout usato da hermes update, il
venv gestito, le dipendenze lazy, il gateway e gli strumenti di documentazione.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent"
uv pip install -e ".[all,dev]"
scripts/run_tests.sh
Fallback con clone manuale (per clone usa-e-getta/CI dove intenzionalmente non vuoi il layout di installazione gestito):
Crea il venv fuori dall'albero del codice sorgente clonato — un venv dentro la directory da cui opera l'agente può essere cancellato da un comando con percorso relativo che l'agente esegue contro il proprio checkout, distruggendo il runtime in esecuzione a metà sessione.
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv ~/.hermes/venvs/hermes-dev --python 3.11
source ~/.hermes/venvs/hermes-dev/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh
MIT — vedi LICENSE.
Creato da Nous Research.
| Riferimento CLI | Tutti i comandi e i flag |
| Variabili d'Ambiente | Riferimento completo delle variabili d'ambiente |