Benvenuto all'installazione più semplice che tu abbia mai fatto

Benvenuto all’installazione più semplice che tu abbia mai fatto

Se hai rimandato l’installazione di Hermes Agent perché temevi una configurazione complicata, fermati proprio lì. Il nuovo installer fa quasi tutto per te — e intendo tutto. In questo tutorial, ti faremo partire in meno di due minuti, senza bisogno di un dottorato in magia da terminale.

Il Percorso Più Veloce: Hermes Desktop

Per gli utenti macOS e Windows, il modo assolutamente più semplice è scaricare l’installer Hermes Desktop dal nostro sito. Scaricalo, eseguilo, e sei a posto. Installa sia lo strumento da riga di comando che l’app desktop, così ottieni il meglio di entrambi i mondi.

Solo Riga di Comando? Nessun Problema

Preferisci restare nel terminale? Hai due opzioni a seconda del tuo sistema operativo:

Linux / macOS / WSL2 / Android (Termux):

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

Windows (nativo) — esegui in PowerShell:

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

Hai cambiato idea e vuoi l’app desktop più tardi? Basta eseguire hermes desktop e ci penserà lui al resto.

Cosa Fa Realmente l’Installer (Così Non Devi Farlo Tu)

Ecco la magia: l’installer gestisce tutto automaticamente. Niente più caccia alle dipendenze una per una. Configura:

Python 3.11 (tramite uv, senza bisogno di sudo)
Node.js v22 (per l’automazione del browser e il bridge WhatsApp)
ripgrep (per ricerche file fulminee)
ffmpeg (per la conversione audio in TTS)
Il clone del repository, l’ambiente virtuale e il comando globale hermes

L’unica cosa che devi aver installato tu stesso è Git (verifica con git --version). Su Linux, assicurati anche che curl e xz-utils siano disponibili. Per l’app desktop, ti servirà build-essential su Debian/Ubuntu.

Dove Finisce Tutto

A seconda di come installi, i file finiscono in posti diversi:

Installer	Il codice si trova in	Binario `hermes`	Directory dati
Per utente (git installer)	`~/.hermes/hermes-agent/`	`~/.local/bin/hermes`	`~/.hermes/`
Modalità root (`sudo curl … \| sudo bash`)	`/usr/local/lib/hermes-agent/`	`/usr/local/bin/hermes`	`/root/.hermes/`

La struttura in modalità root è perfetta per macchine condivise dove un’unica installazione di sistema serve tutti. La tua configurazione personale (auth, skills, sessioni) resta comunque al sicuro nella tua cartella ~/.hermes/.

Dopo l’Installazione: Inizia a Chattare!

Una volta che l’installer ha finito, ricarica la shell e tuffati:

source ~/.bashrc   # oppure: source ~/.zshrc
hermes             # Inizia a chattare!

Vuoi modificare qualcosa più tardi? Ci sono comandi dedicati per quello:

hermes model          # Scegli il tuo provider LLM e il modello
hermes tools          # Configura quali strumenti sono abilitati
hermes gateway setup  # Configura le piattaforme di messaggistica
hermes config set     # Imposta singoli valori di configurazione
hermes config get     # Ispeziona singoli valori di configurazione
hermes setup          # Oppure esegui la procedura di configurazione completa

Il Percorso Più Veloce: Nous Portal

Ecco un suggerimento da professionisti: se vuoi saltare del tutto la gestione delle chiavi API per ogni strumento, usa il Nous Portal. Un unico abbonamento copre più di 300 modelli più il Tool Gateway (ricerca web, generazione immagini, TTS, browser cloud). Configura tutto con un singolo comando:

hermes setup --portal

Questo ti fa accedere, imposta Nous come provider e attiva il Tool Gateway — tutto in un colpo solo.

Ti Stai Spostando da un’Altra Macchina?

Non ricostruire tutto da zero. Ripristina un backup completo con hermes import, oppure trasferisci un singolo agente con hermes profile import. Ricorda: le esportazioni dei profili escludono le credenziali per design, quindi per un vero backup usa hermes backup.

Una Nota per gli Utenti Nix

Nix non è più un percorso di installazione esplicitamente supportato (solo best-effort). Se usi già Nix, c’è una guida di configurazione dedicata con un flake e un modulo NixOS — consulta la documentazione Nix & NixOS Setup.

Vuoi Eseguirlo come Servizio di Sistema?

Vuoi eseguire Hermes come utente dedicato non privilegiato (come un account systemd hermes)? Totalmente supportato. L’unico passaggio che richiede root è il --with-deps di Playwright per le librerie Chromium. L’installer rileva se sudo è disponibile e lo gestisce con eleganza.

Questo è tutto! Ora sei pronto per iniziare la tua prima conversazione con Hermes. Nel prossimo tutorial esploreremo la tua prima sessione di chat e tutte le cose fantastiche che puoi fare. Ci vediamo lì!