Installare Hermes Agent su un Mac mini

Cos’è Hermes Agent

Hermes Agent è un agente open source di Nous Research, con licenza MIT. Conserva la memoria tra una sessione e l’altra e scrive le proprie skill man mano che impara il tuo lavoro. Un gateway lo collega a Telegram, Discord, WhatsApp e altre app di chat (github.com/NousResearch/hermes-agent, ottobre 2026).

Puoi usarlo come chat nel terminale, come altri agenti di coding. Oppure puoi lasciare il gateway attivo e scrivergli dal telefono. Il secondo modo è il motivo per cui la gente lo vuole su un Mac sempre acceso.

Requisiti

• Apple silicon. La documentazione di installazione dice che l’installer per macOS è solo per Apple silicon, e i Mac Intel non sono supportati (ottobre 2026).
• Python da 3.11 a 3.14, git e curl. L’installer prepara il suo Python, Node, ffmpeg e ripgrep, quindi va bene anche un Mac pulito.
• Un modello. Hermes funziona con Anthropic, OpenAI, OpenRouter, Nous Portal e molti altri. La sua documentazione sui provider elenca chiavi API, login dal browser e alcuni piani in abbonamento. Accetta anche qualsiasi endpoint locale compatibile con OpenAI, come Ollama.

Installalo

Questo è il comando documentato per macOS. Dopo, ricarica la shell.

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

Per uno script o una shell remota, l’installer accetta flag che saltano le domande e gli strumenti opzionali per browser e computer use. Li abbiamo usati per il nostro test.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive --skip-browser --skip-computer-use

L’abbiamo eseguito due volte su macchine macOS 26 in hosting su GitHub, il 2 ottobre 2026. Una volta ci sono voluti circa 2 minuti, l’altra 6,5 minuti, quasi tutti di download. Il controllo della versione ha stampato questo.

$ hermes --version
Hermes Agent v0.21.5+5635.g5bba024 (2026.9.24) · upstream 5bba024d

È utile sapere cosa è finito dove. L’installer ha clonato il codice in una cartella hermes nella tua home. Ha messo le sue copie di Python 3.14.7, Node, ffmpeg e ripgrep in una cartella tools al suo interno. Il comando hermes è finito nella cartella local bin della tua home. Ha anche aggiunto 58 skill incluse, tra cui quelle per Note, Promemoria e iMessage di Apple. Sono un motivo per far girare Hermes su un Mac e non su una macchina Linux.

Ora scegli un modello ed esegui la configurazione guidata.

hermes model
hermes setup
hermes doctor

Arrivi da OpenClaw? Il README indica un comando che importa le tue impostazioni di OpenClaw.

hermes claw migrate

Tieni il gateway attivo 24/7

Prima collega le tue app di chat. Poi installa il gateway come servizio. Su macOS è un agente launchd.

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
tail -f ~/.hermes/logs/gateway.log

Abbiamo eseguito il comando di installazione su una macchina di test senza app di chat ancora configurate. Il suo utente si chiama runner. Il controllo dello stato ha confermato che launchd stava eseguendo il gateway.

$ hermes gateway install
Installing launchd service to: /Users/runner/Library/LaunchAgents/ai.hermes.gateway.plist
✓ Service installed and loaded!
$ hermes gateway status
✓ Service definition matches the current Hermes install
✓ Gateway is supervised by launchd (PID 14390)
  Auto-start at login and auto-restart on crash are available.

Il file del servizio è impostato per partire al caricamento, quindi torna a ogni login. Riavvia anche il gateway se esce con un errore. C’è un’insidia indicata nella documentazione sulla messaggistica. Se in seguito installi nuovi strumenti, esegui di nuovo il comando di installazione, così il servizio vede il nuovo PATH.

Come ogni LaunchAgent, ha bisogno di un utente che abbia fatto il login. Attiva il login automatico, poi disattiva lo stop.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Per una sessione nel terminale che sopravvive a una connessione caduta, esegui l’agente interattivo dentro tmux. I passaggi sono nella nostra guida a tmux. Valgono allo stesso modo per Hermes.

Note di sicurezza

• Il gateway rifiuta tutti finché non li autorizzi. Imposta una allowlist di ID utente, oppure approva le persone una alla volta con i codici di abbinamento. I codici scadono dopo un’ora.
• Le approvazioni hanno tre modalità: manual, smart e off. Off equivale al flag yolo. Tienila su manual finché non ti fidi del tuo setup.
• Tieni le chiavi API nel file env dentro la cartella hermes, leggibile solo da te. Non farne mai il commit.
• Per un isolamento maggiore, la documentazione sulla sicurezza mostra come eseguire i comandi in un container Docker invece che sul Mac stesso.

# in ~/.hermes/.env
TELEGRAM_ALLOWED_USERS=123456789

# or approve one person by pairing code
hermes pairing approve telegram XKGH5N7P
chmod 600 ~/.hermes/.env

Secondo la documentazione, alcune protezioni valgono anche in modalità yolo. Una blocklist rigida ferma comandi come la cancellazione ricorsiva dell’intero disco. I suoi strumenti per i file si rifiutano di scrivere nelle cartelle ssh e aws.

Farlo girare su un Mac di MacRun

Il nostro piano Agent ti dà un Mac mini dedicato con lo stop disattivato. La sua sessione di login torna da sola dopo un riavvio. Claude Code e Codex sono preinstallati. Hermes no. Lo installi con lo script qui sopra, usando i tuoi diritti di amministratore. Se colleghi Hermes a un modello in cloud, l’M6 base con 16 GB è più che sufficiente.

Chi non dovrebbe noleggiare un Mac per questo. Hermes gira anche su Linux. Se non ti servono Xcode, Note di Apple o iMessage, un server Linux costa meno. E MacRun è pensato per il lavoro di sviluppo, quindi usalo per coding, build e lavori sul repository, non come assistente personale per la vita privata.

Guarda cosa include il piano Agent nella pagina del Mac per agenti.