Metti in moto Hermes
Hermes Agent v0.8.0 si installa in circa 60 secondi su Linux, macOS o WSL2. Un comando curl, e l'installer gestisce uv, Python 3.11, Node.js, ripgrep e ffmpeg per te.
checklist Requisiti di sistema
Serve solo git all'inizio — Python 3.11, Node.js v22, uv, ripgrep e ffmpeg sono installati dallo script
Linux, macOS, WSL2 su Windows, o Android via Termux. Windows nativo non è supportato.
Minimo 2 GB di RAM; di più se usi modelli locali
~1 GB per l'agente, il venv, i moduli Node e le skill integrate
Opzionale: Docker, SSH, Daytona, Singularity o Modal per l'esecuzione sandboxed dei comandi
Connessione internet necessaria per le API dei modelli hosted. I modelli locali via endpoint compatibile OpenAI funzionano offline.
Il one-liner dalla documentazione ufficiale. Consigliato per la maggior parte degli utenti su Linux, macOS o WSL2. Docs di installazione arrow_forward
WSL2 (Windows)
Windows nativo non è supportato. Esegui questo dentro una shell WSL2 dopo 'wsl --install'.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash macOS / Linux / WSL2
Serve solo git all'inizio — l'installer gestisce uv, Python 3.11, Node.js v22, ripgrep e ffmpeg.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash verified Verifica l'installazione
Esegui i comandi di verifica elencati nella documentazione ufficiale.
hermes version Stampa la versione installata (dovrebbe essere 0.8.0 o successiva).
hermes doctor Esegue un check diagnostico — Python, uv, dipendenze, file di configurazione e connettività.
hermes status Stampa la configurazione corrente: provider del modello, tool abilitati e gateway connessi.
settings Configurazione iniziale
Dopo l'installazione, ricarica la shell, poi esegui i tre comandi di setup dalla docs.
Scegli un provider di modelli
Esegui 'hermes model' per scegliere un provider. Il README elenca Nous Portal, OpenRouter, z.ai/GLM, Kimi/Moonshot, MiniMax, OpenAI e endpoint personalizzati. Anthropic e Mistral sono inclusi come dipendenze.
Abilita i tool che vuoi
Esegui 'hermes tools' per configurare quali dei 47 tool integrati sono attivi. Puoi aggiungerne o rimuoverne in seguito.
Esegui il wizard di setup completo
Esegui 'hermes setup' per completare il wizard, incluse le chiavi API e le connessioni ai gateway di chat (Telegram, Discord, Slack, WhatsApp, Signal, Email).
Invia un messaggio di test
Prova 'hermes chat -q "Ciao! Quali tool hai disponibili?"' — direttamente dal quickstart ufficiale.
.env — La configurazione si trova in ~/.hermes/ — config.yaml per le impostazioni principali, .env per le chiavi API, più sottodirectory per sessioni, log, memorie, skill e cron job. Consulta il riferimento env-vars su hermes-agent.nousresearch.com/docs/reference/environment-variables.
cloud Deploy su VPS / Server
Hermes gira su qualsiasi VPS Linux con 2 GB di RAM e ~1 GB di disco. Lo stesso one-liner funziona via SSH.
Connettiti via SSH al tuo server
Qualsiasi distro Linux va bene — Ubuntu, Debian, CentOS, Arch, ecc.
ssh user@your-server-ip Esegui l'installer
Lo script rileva automaticamente la tua distro, installa Python 3.11 via uv e configura tutte le dipendenze.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Abilita un backend sandbox
Su infrastruttura condivisa, configura uno dei backend sandbox (Docker, SSH, Daytona, Singularity o Modal) così i comandi shell di Hermes girano in isolamento. Consulta il README per il setup specifico del backend.
Imposta la chiave API e avvia
Scegli un provider di modelli e avvia Hermes. Usa tmux o screen per la persistenza — il processo gira in foreground.
hermes model && hermes Tip — Per un daemon persistente, esegui Hermes dentro tmux/screen o scrivi un file unit systemd. Consulta la docs ufficiale per il setup del daemon.
system_update_alt Aggiornamento di Hermes
Il README documenta un aggiornamento integrato: 'hermes update'. Non esiste un pacchetto PyPI pubblicato o un'immagine Docker, quindi gli altri percorsi di aggiornamento passano per git. Guida all'aggiornamento arrow_forward
hermes update cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]" curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash # Nessuna immagine Docker ufficiale è ancora pubblicata Vedi github.com/NousResearch/hermes-agent/releases per il contenuto di ogni versione.
delete_forever Disinstallazione di Hermes
Hermes si installa in ~/.hermes/hermes-agent/ e crea un symlink del binario in ~/.local/bin/hermes. Rimuoverli richiede due comandi. Note sulla disinstallazione arrow_forward
rm ~/.local/bin/hermes rm -rf ~/.hermes/hermes-agent rm -rf ~/.hermes/hermes-agent # Nessuna immagine Docker ufficiale da rimuovere Rimuovi i dati utente (opzionale)
Questo cancella sessioni, memorie, skill, cron job e chiavi API. Fai un backup di ciò che ti serve prima.
rm -rf ~/.hermes # Esegui dentro la tua shell WSL — Windows nativo non è supportato build Risoluzione dei problemi
Dalla tabella di troubleshooting della docs di installazione e dagli errori comuni dello script. Altri suggerimenti di troubleshooting arrow_forward
Serve aiuto?
Unisciti al Discord di Nous Research per supporto all'installazione e troubleshooting dalla community.