Hermes zum Laufen bringen
Hermes Agent v0.8.0 ist in etwa 60 Sekunden auf Linux, macOS oder WSL2 installiert. Ein curl-Befehl, und der Installer kümmert sich um uv, Python 3.11, Node.js, ripgrep und ffmpeg.
checklist Systemanforderungen
Nur git wird vorab benötigt — Python 3.11, Node.js v22, uv, ripgrep und ffmpeg werden vom Script installiert
Linux, macOS, WSL2 unter Windows oder Android via Termux. Natives Windows wird nicht unterstützt.
Mindestens 2 GB RAM; mehr, wenn du lokale Modelle betreibst
~1 GB für den Agenten, sein venv, Node-Module und eingebaute Skills
Optional: Docker, SSH, Daytona, Singularity oder Modal für gesandboxte Befehlsausführung
Internetverbindung für gehostete Model-APIs erforderlich. Lokale Modelle über einen OpenAI-kompatiblen Endpoint funktionieren offline.
Der Ein-Zeiler aus den offiziellen Docs. Empfohlen für die meisten Nutzer auf Linux, macOS oder WSL2. Install-Docs arrow_forward
WSL2 (Windows)
Natives Windows wird nicht unterstützt. Führe dies innerhalb einer WSL2-Shell aus, nach 'wsl --install'.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash macOS / Linux / WSL2
Nur git wird vorab benötigt — der Installer kümmert sich um uv, Python 3.11, Node.js v22, ripgrep und ffmpeg.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash verified Installation überprüfen
Führe die in den offiziellen Docs aufgeführten Prüfbefehle aus.
hermes version Gibt die installierte Version aus (sollte 0.8.0 oder neuer sein).
hermes doctor Führt einen Diagnose-Check durch — Python, uv, Dependencies, Config-Dateien und Konnektivität.
hermes status Zeigt deine aktuelle Konfiguration: Model-Provider, aktivierte Tools und verbundene Gateways.
settings Erstkonfiguration
Nach der Installation die Shell neu laden und die drei Setup-Befehle aus den Docs ausführen.
Model-Provider wählen
Führe 'hermes model' aus, um einen Provider zu wählen. Die README listet Nous Portal, OpenRouter, z.ai/GLM, Kimi/Moonshot, MiniMax, OpenAI und Custom-Endpoints. Anthropic und Mistral werden ebenfalls als Dependencies mitgeliefert.
Die gewünschten Tools aktivieren
Führe 'hermes tools' aus, um einzustellen, welche der 47 eingebauten Tools aktiviert sind. Später jederzeit änderbar.
Den vollständigen Setup-Wizard durchlaufen
Führe 'hermes setup' aus, um den kompletten Wizard zu durchlaufen — inklusive API-Keys und Chat-Gateway-Verbindungen (Telegram, Discord, Slack, WhatsApp, Signal, E-Mail).
Eine Testnachricht senden
Probiere 'hermes chat -q "Hallo! Welche Tools hast du verfügbar?"' — direkt aus dem offiziellen Quickstart.
.env — Die Config liegt in ~/.hermes/ — config.yaml für Haupteinstellungen, .env für API-Keys, plus Unterverzeichnisse für Sessions, Logs, Erinnerungen, Skills und Cron-Jobs. Siehe die env-vars-Referenz auf hermes-agent.nousresearch.com/docs/reference/environment-variables.
cloud VPS- / Server-Deployment
Hermes läuft auf jedem Linux-VPS mit 2 GB RAM und ~1 GB Speicher. Derselbe Ein-Zeiler funktioniert über SSH.
Per SSH auf den Server verbinden
Jede Linux-Distribution funktioniert — Ubuntu, Debian, CentOS, Arch usw.
ssh user@deine-server-ip Den Installer ausführen
Das Script erkennt deine Distribution automatisch, installiert Python 3.11 über uv und richtet alle Dependencies ein.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Ein Sandbox-Backend aktivieren
Auf geteilter Infrastruktur eines der Sandbox-Backends konfigurieren (Docker, SSH, Daytona, Singularity oder Modal), damit Hermes' Shell-Befehle isoliert laufen. Siehe die README für backend-spezifisches Setup.
API-Key setzen und starten
Einen Model-Provider wählen und Hermes starten. Nutze tmux oder screen für Persistenz — der Prozess läuft im Vordergrund.
hermes model && hermes Tip — Für einen persistenten Daemon Hermes in tmux/screen starten oder eine systemd-Unit-Datei schreiben. Schau in die offiziellen Docs für das Daemon-Setup.
system_update_alt Hermes aktualisieren
Die README dokumentiert einen eingebauten Updater: 'hermes update'. Es gibt kein veröffentlichtes PyPI-Paket oder Docker-Image, andere Upgrade-Pfade laufen über git. Upgrade-Anleitung 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 # Noch kein offizielles Docker-Image veröffentlicht Siehe github.com/NousResearch/hermes-agent/releases für die Inhalte jeder Version.
delete_forever Hermes deinstallieren
Hermes installiert sich nach ~/.hermes/hermes-agent/ und verlinkt die Binary nach ~/.local/bin/hermes. Beides entfernen geht mit zwei Befehlen. Hinweise zur Deinstallation arrow_forward
rm ~/.local/bin/hermes rm -rf ~/.hermes/hermes-agent rm -rf ~/.hermes/hermes-agent # Kein offizielles Docker-Image zum Entfernen Nutzerdaten löschen (optional)
Damit werden Sessions, Erinnerungen, Skills, Cron-Jobs und API-Keys gelöscht. Sichere vorher alles, was du noch brauchst.
rm -rf ~/.hermes # Innerhalb der WSL-Shell ausführen — natives Windows wird nicht unterstützt build Fehlerbehebung
Aus der Troubleshooting-Tabelle der Install-Docs und häufigen Fehlern des Install-Scripts. Mehr Troubleshooting-Tipps arrow_forward
Brauchst du Hilfe?
Tritt dem Nous Research Discord bei für Installations-Support und Community-Hilfe.