curl-Installation · hermes doctor · Modell & Gateway · Plattform-Matrix · Sechs-Schritte-Runbook
Sie wollen 2026 Nous Research Hermes Agent (GitHub ca. 174.000 Stars) betreiben, scheitern aber an PATH, API Key oder stummem Telegram? Dieser datengetriebene Leitfaden liefert den vollständigen Installationspfad: offizielles curl | bash installiert Python 3.11 / Node 22, hermes doctor prüft 12 Punkte, hermes setup konfiguriert Modell und Gateway bis Telegram 24/7. Enthalten: Systemanforderungen, Plattform-Matrix, Sechs-Schritte-Runbook, Fehlertabelle — und warum produktiver Dauerbetrieb auf Mac Mini M4 Miete die stabilste Uptime liefert.
Hermes Agent (Nous Research, MIT) zählt 2026 zu den meistgenutzten Open-Source-Self-Evolving AI Agents auf GitHub: Nach abgeschlossenen Tasks entstehen wiederverwendbare Skills; Community-Daten zeigen bei gleichartigen Aufgaben ca. 38 % weniger Token. Über das Gateway binden Sie Telegram, Discord, Slack und 20+ Kanäle an; MCP sowie Claude, OpenRouter und Ollama sind unterstützt. Gegenüber OpenClaw und LangGraph: Session-übergreifendes Gedächtnis (SESSION → MEMORY.md → USER.md) und native Skill-Erstellung; das Install-Skript läuft auf $5-VPS oder Mac — produktives 24/7 und macOS-Browser-Skills hängen jedoch am Host.
Keine Theorie, sondern fünf Installations-Schmerzpunkte: hermes: command not found, fehlender API Key, Config-Drift nach Updates, stumme Telegram-Gruppen und der Laptop, der beim Zuklappen den Gateway-Prozess beendet. Wer Installation und Speicherarchitektur vertiefen will: Dreistufiges Gedächtnis und 24/7-Messwerte.
| Parameter | Minimum | Empfohlen (Produktion Gateway) |
|---|---|---|
| System | macOS 12+ / Ubuntu 20.04+ / WSL2 | macOS 14+ (Apple Silicon) oder Ubuntu 24.04 LTS |
| Python / Node | Skript installiert 3.11 / 22 | Kein manuelles Setup — hermes doctor als Referenz |
| RAM | 4 GB (nur Gateway + Cloud-API) | 16 GB+; lokales Modell: 32 GB UMA |
| Disk | ca. 1,5 GB (inkl. Skill-Cache) | 20 GB SSD+, Reserve für FTS5 und Logs |
| Netz | GitHub raw + LLM-API erreichbar | Stabile Latenz für IM-Webhooks |
Python/Node zuerst installieren: install.sh nutzt uv für Python 3.11, Node 22, ripgrep, ffmpeg — ohne sudo.
Shell nicht neu laden: PATH fehlt → command not found; source ~/.zshrc oder neues Terminal.
hermes doctor überspringen: 12 Checks finden API Key, ffmpeg, PATH — spart gegenüber Blindstart oft eine Stunde.
Browser auf Headless-VPS: --skip-browser setzen, damit Camoufox-Abhängigkeiten die Installation nicht abbrechen.
Laptop-POC als Produktion: MacBook-Sleep unterbricht Gateway; Skill-Compounding bricht ab — 24/7 braucht dedizierten Host.
Dieselbe Zeile curl | bash — der Unterschied liegt in Uptime, I/O und macOS-Pfad. Installierbar heißt nicht produktionstauglich für Gateway und Skill-Compounding 24/7. Die Matrix fasst gemessene Community- und Rechenzentrums-Bänder zusammen:
| Plattform | 24/7-Verfügbarkeit | Skill-Compounding | Monatskosten | Einsatz |
|---|---|---|---|---|
| Privates MacBook | ≈ 60 % (Sleep beim Zuklappen) | häufig unterbrochen | €0 Hardware + hohe Unsicherheit | nur POC / lokale CLI |
| Raspberry Pi 4B 8 GB | ≈ 88 % | I/O-Engpass, Timeouts bei Langjobs | Einmalkauf Hardware | Experiment, kein Prod-Gateway |
| x86 VPS 4 GB | ≈ 99,5 % | stabil, keine macOS-Skills | Pay-as-you-go | reine API + Telegram, ohne Browser-Automation |
| Mac Mini M4 Miete | Rechenzentrum-SLA, ~100 % auf 30 Tage | UMA + launchd, Skills akkumulieren | fixe Monatsmiete | Telegram 24/7 + Camoufox / lokales Ollama |
Installation dauert ~10 Minuten; stabiler 24/7-Host entscheidet, ob Skills compounden oder wöchentlich neu beginnen.
M4 Unified Memory teilt sich Gateway (Community: ca. 4,2 GB im Dauerbetrieb), Browser-Automation und SQLite WAL in einem Adressraum; launchd auf macOS entspricht dem offiziellen Testpfad besser als generisches systemd. Kurz testen: 1 Monat mieten, Telegram und Skill-Kurve messen — Details in 30-Tage-Bericht.
Schritte gelten für macOS / Linux / WSL2; Headless-VPS in Schritt 1 --skip-browser. Daten liegen unter ~/.hermes/ — vor Upgrades sichern.
Ein-Klick-Installation: Offizielles Skript ausführen, auf Hermes Agent installed at ~/.hermes warten, dann source ~/.zshrc (Linux: ~/.bashrc).
Health-Check: hermes doctor für Python, Node, ripgrep, ffmpeg, PATH; hermes --version ≥ v0.14.
Modell konfigurieren: hermes setup oder hermes model; OpenRouter / Anthropic / Nous Portal in ~/.hermes/.env.
CLI-Smoke-Test: hermes interaktiv, Task mit Tool-Call (z. B. Dateien zählen) — API muss antworten.
Telegram: Bot bei BotFather → hermes gateway setup, Telegram wählen, Token und TELEGRAM_ALLOWED_USERS; Gruppen: Privacy aus, Bot neu einladen.
24/7-Daemon: hermes gateway install && hermes gateway start; Linux optional sudo hermes gateway install --system, macOS launchd User-Service.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc hermes doctor hermes setup hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
API Key manuell: hermes config set OPENROUTER_API_KEY sk-or-xxxx oder in ~/.hermes/.env. Nach Upgrade bei fehlender Config: hermes config check && hermes config migrate.
Diese Symptome treten oft auf, wenn das Skript erfolgreich war, der Dienst aber nicht läuft — Tabelle der Reihe nach abarbeiten; nicht gleichzeitig Modell, Verzeichnis und Gateway ändern.
| Fehler / Symptom | Ursache | Fix |
|---|---|---|
| hermes: command not found | PATH nicht aktualisiert | source ~/.zshrc oder neues Terminal |
| API key not set | Kein LLM konfiguriert | hermes model oder ~/.hermes/.env |
| Missing config after update | Config-Drift nach Version | hermes config check && hermes config migrate |
| ModuleNotFoundError: dotenv | System-Python statt venv | ~/.hermes/hermes-agent/venv/bin/hermes nutzen |
| Telegram-Gruppe stumm | Bot-Privacy-Modus | BotFather Group Privacy off, Bot entfernen und neu einladen |
Hermes bindet beliebige MCP Server (GitHub, DB, Browser) über mcp_servers in ~/.hermes/config.yaml; Headless-OAuth via hermes mcp login + SSH-Tunnel. Produktion: erst einen Kanal stabilisieren, dann MCP — erleichtert Log-Bisektion.
Hinweis: Windows per PowerShell-Skript möglich; Dashboard /chat Terminal braucht WSL2 — WSL2 + Linux-Pfad entspricht diesem Runbook.
~/.hermes/hermes-agent/, PATH via Skript.hermes doctor deckt ca. 12 Punkte ab (Python 3.11, Node 22, ripgrep, ffmpeg, API Key u. a.).Notebook und Heim-NAS reichen für Installations-Abnahme, schwächen aber Telegram 24/7 durch Sleep, VPS-I/O und fehlende macOS-Browser-Skills; der Pi scheitert bei lokalem 8B und Langjobs. Teams, die Hermes als dauerhaften Kollegen betreiben, bündeln mit Mac Mini M4 Miete Uptime, UMA und launchd in planbare OpEx — stabiler als wiederholte Neuinstallationen.
Nach diesem Runbook und Bedarf an produktionsreifem 24/7-Knoten: VpsMesh liefert Mac Mini M4 per SSH, Ressourcen-Panel, Backup von ~/.hermes/ vor Lease-Ende. Tarife: Mac Mini M4 Mietpreise, Support: Hilfezentrum, Bestellung: Bestellseite.
Achtung: Host-Wechsel, Hermes-Major-Upgrade und Telegram-Whitelist nicht am selben Wochenende — zuerst hermes gateway status 24 h stabil, dann Modell oder MCP ändern.
Nein. install.sh installiert via uv Python 3.11, Node.js 22, ripgrep und ffmpeg nach ~/.hermes/hermes-agent/. Danach source ~/.zshrc und hermes doctor mit 12 Checks.
Im Privacy-Modus reagiert der Bot in Gruppen nur auf /-Befehle. BotFather → Bot Settings → Group Privacy deaktivieren, Bot entfernen und neu einladen. TELEGRAM_ALLOWED_USERS muss Ihre ID enthalten; hermes gateway status muss laufen.
Reine Cloud-API + Telegram: x86 VPS genügt. Für macOS-Browser-Skills, lokales Ollama oder launchd: Mac Mini M4 Miete mit stabilerer Uptime und UMA. Unsicher: 1 Monat testen — Tarife Preisseite, Bestellung Bestellseite.