Ratgeber

Hermes Agent auf einem Mac mini installieren

Hermes Agent installieren Sie auf einem Mac mit Apple Silicon mit einem Skript. Das Skript richtet sein eigenes Python und seine Tools ein. Danach wählen zwei Befehle ein Modell und machen das Messaging-Gateway zu einem launchd-Dienst. Hier sind die offiziellen Schritte, die Ausgabe unserer Testinstallation und wie Sie es rund um die Uhr am Laufen halten.

Was Hermes Agent ist

Hermes Agent ist ein Open-Source-Agent von Nous Research unter der MIT-Lizenz. Er behält ein Gedächtnis zwischen Sitzungen und schreibt eigene Skills, während er Ihre Arbeit lernt. Ein Gateway verbindet ihn mit Telegram, Discord, WhatsApp und anderen Chat-Apps (github.com/NousResearch/hermes-agent, Oktober 2026).

Sie können ihn wie andere Coding-Agents als Chat im Terminal nutzen. Oder Sie lassen das Gateway laufen und schreiben ihm vom Handy aus. Wegen dieser zweiten Art wollen ihn viele auf einem dauerhaft eingeschalteten Mac haben.

Voraussetzungen

  • Apple Silicon. Laut Installationsdoku läuft der Installer für macOS nur auf Apple Silicon. Intel-Macs werden nicht unterstützt (Oktober 2026).
  • Python 3.11 bis 3.14, git und curl. Der Installer bringt sein eigenes Python, Node, ffmpeg und ripgrep mit. Ein frischer Mac ist also kein Problem.
  • Ein Modell. Hermes arbeitet mit Anthropic, OpenAI, OpenRouter, Nous Portal und vielen anderen. Die Doku zu den Anbietern nennt API-Keys, Anmeldung im Browser und einige Abo-Tarife. Außerdem akzeptiert er jeden lokalen Endpunkt, der zu OpenAI kompatibel ist, etwa Ollama.

Installation

Das ist der dokumentierte Befehl für macOS. Laden Sie danach Ihre Shell neu.

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

Für ein Skript oder eine Remote-Shell nimmt der Installer Flags an. Sie überspringen die Fragen und die optionalen Tools für Browser und Computer Use. Wir haben sie für unseren Test genutzt.

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

Wir haben ihn am 2. Oktober 2026 zweimal auf von GitHub gehosteten Maschinen mit macOS 26 ausgeführt. Einmal dauerte es etwa 2 Minuten, das andere Mal 6,5 Minuten, vor allem wegen Downloads. Die Versionsprüfung gab das hier aus.

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

Es hilft zu wissen, was wo gelandet ist. Der Installer hat den Code in einen Ordner hermes in Ihrem Home-Verzeichnis geklont. Eigene Kopien von Python 3.14.7, Node, ffmpeg und ripgrep hat er in einen Ordner tools darin gelegt. Der Befehl hermes kam in den lokalen bin-Ordner in Ihrem Home-Verzeichnis. Außerdem kamen 58 mitgelieferte Skills dazu, darunter welche für Apple Notes, Erinnerungen und iMessage. Sie sind ein Grund, Hermes auf einem Mac statt auf einer Linux-Kiste zu betreiben.

Wählen Sie jetzt ein Modell und starten Sie den Setup-Assistenten.

hermes model
hermes setup
hermes doctor

Sie kommen von OpenClaw? Das README nennt einen Befehl, der Ihre Einstellungen aus OpenClaw importiert.

hermes claw migrate

Das Gateway rund um die Uhr am Laufen halten

Verbinden Sie zuerst Ihre Chat-Apps. Dann installieren Sie das Gateway als Dienst. Unter macOS ist das ein launchd-Agent.

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

Wir haben den Installationsbefehl auf einer Testmaschine ausgeführt, auf der noch keine Chat-Apps eingerichtet waren. Ihr Benutzer heißt runner. Die Statusprüfung bestätigte, dass launchd das Gateway ausführte.

$ 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.

Die Dienstdatei ist auf Start beim Laden eingestellt. Sie kommt also bei jeder Anmeldung zurück. Außerdem startet sie das Gateway neu, wenn es mit einem Fehler endet. Ein Haken aus der Messaging-Doku: Wenn Sie später neue Tools installieren, führen Sie den Installationsbefehl erneut aus. Dann übernimmt der Dienst den neuen PATH.

Wie jeder LaunchAgent braucht er einen angemeldeten Benutzer. Aktivieren Sie die automatische Anmeldung und schalten Sie dann den Ruhezustand ab.

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

Für eine Terminal-Sitzung, die einen Verbindungsabbruch übersteht, führen Sie den interaktiven Agent in tmux aus. Die Schritte stehen in unserer tmux-Anleitung. Für Hermes funktionieren sie genauso.

Hinweise zur Sicherheit

  • Das Gateway lehnt alle ab, bis Sie sie zulassen. Legen Sie eine Allowlist mit Benutzer-IDs an oder geben Sie Personen einzeln per Pairing-Code frei. Codes laufen nach einer Stunde ab.
  • Freigaben haben drei Modi: manual, smart und off. Off entspricht dem Flag yolo. Bleiben Sie bei manual, bis Sie Ihrem Setup vertrauen.
  • Bewahren Sie API-Keys in der env-Datei im Ordner hermes auf, nur für Sie lesbar. Committen Sie sie nie.
  • Für mehr Isolation zeigt die Sicherheitsdoku, wie Sie Befehle in einem Docker-Container statt direkt auf dem Mac ausführen.
# in ~/.hermes/.env
TELEGRAM_ALLOWED_USERS=123456789

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

Manche Schutzmechanismen greifen laut Doku sogar im yolo-Modus. Eine feste Sperrliste stoppt Befehle wie das rekursive Löschen der ganzen Festplatte. Die Datei-Tools weigern sich, in die Ordner ssh und aws zu schreiben.

Auf einem Mac von MacRun betreiben

Unser Agent-Tarif gibt Ihnen einen dedizierten Mac mini mit abgeschaltetem Ruhezustand. Seine Anmeldesitzung kommt nach einem Neustart von selbst zurück. Claude Code und Codex sind vorinstalliert. Hermes nicht. Sie installieren es mit dem Skript oben und Ihren Admin-Rechten. Wenn Sie Hermes mit einem Cloud-Modell nutzen, reicht der Basis-M6 mit 16 GB locker.

Wer dafür keinen Mac mieten sollte. Hermes läuft auch unter Linux. Wenn Sie weder Xcode noch Apple Notes oder iMessage brauchen, ist ein Linux-Server günstiger. Und MacRun ist für Entwicklerarbeit gedacht. Nutzen Sie ihn also für Code, Builds und Aufgaben im Repo, nicht als persönlichen Assistenten für Ihr Privatleben.

Was der Agent-Tarif enthält, sehen Sie auf der Seite zum Agent-Mac.

Häufige Fragen

Läuft Hermes Agent auf einem Intel-Mac?

+

Nein. Laut Installationsdoku von Hermes Agent unterstützt der Installer für macOS nur Apple Silicon, Stand Oktober 2026.

Wie lasse ich Hermes Agent unter macOS im Hintergrund laufen?

+

Führen Sie hermes gateway install aus. Das legt einen launchd-Agent an, der bei der Anmeldung startet. Mit hermes gateway start, stop und status verwalten Sie ihn.

Kann Hermes Agent ein lokales Modell nutzen?

+

Ja. Laut Doku zu den Anbietern arbeitet er mit jedem Endpunkt, der zu OpenAI kompatibel ist, auch mit Ollama und LM Studio. Wählen Sie ihn mit hermes model.

Wo speichert Hermes Agent API-Keys?

+

In der env-Datei im Ordner hermes in Ihrem Home-Verzeichnis. Die Sicherheitsdoku empfiehlt chmod 600 dafür und rät, sie nie zu committen.

Passende Ratgeber