Hermes Agent ☤

Hermes Agent | Hermes Desktop

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.

Installazione Rapida

Linux, macOS, WSL2, Termux

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, 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 ~/.hermes come su Linux.

Dopo l'installazione:

source ~/.bashrc    # ricarica la shell (oppure: source ~/.zshrc)
hermes              # inizia a chattare!

Risoluzione dei problemi

Windows Defender o 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 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:

• Windows Defender: Esegui PowerShell come Admin → Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
• Bitdefender: Aggiungi un'eccezione nella console Bitdefender (Protezione > Antivirus > Impostazioni > Gestisci eccezioni)
• Inserisci nella whitelist la cartella, non l'hash del file — Hermes aggiorna uv e l'hash cambia a ogni versione

Per più contesto, vedi i report upstream di Astral: astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079.

Per Iniziare

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

📖 Documentazione completa →

Salta la raccolta di 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, TTS e un browser cloud, Nous Portal copre tutto con un unico abbonamento:

• 300+ modelli — scegline uno qualsiasi con /model <nome>
• Tool Gateway — ricerca web (Firecrawl), generazione di immagini (FAL), text-to-speech (OpenAI), browser cloud (Browser Use), tutto instradato tramite il tuo abbonamento. Nessun account aggiuntivo.

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.

Riferimento Rapido CLI vs Messaggistica

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.

Per gli elenchi completi dei comandi, vedi la guida CLI e la guida al Messaging Gateway.

Documentazione

Tutta la documentazione vive su hermes-agent.nousresearch.com/docs:

Migrazione da OpenClaw

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:

• SOUL.md — file della persona
• Memorie — voci MEMORY.md e USER.md
• Competenze — competenze create dall'utente → ~/.hermes/skills/openclaw-imports/
• Allowlist dei comandi — modelli di approvazione
• Impostazioni di messaggistica — configurazioni piattaforma, utenti consentiti, directory di lavoro
• Chiavi API — segreti in allowlist (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
• Risorse TTS — file audio dell'area di lavoro
• Istruzioni dell'area di lavoro — AGENTS.md (con --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.

Contribuire

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

Community

• 💬 Discord
• 📚 Skills Hub
• 🐛 Problemi
• 🔌 computer-use-linux — Server MCP di controllo 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 — Bridge WeChat della community: esegui Hermes Agent e OpenClaw sullo stesso account WeChat.

Licenza

MIT — vedi LICENSE.

Creato da Nous Research.