Voraussetzungen: Was du vor der Installation entscheiden solltest

Hermes Agent ist kein einzelnes Sprachmodell. Er ist die Laufzeit, die ein Modell mit Terminal, Dateien, Browser, Skills, Erinnerung, Zeitplanung und Messaging verbindet. Deshalb brauchst du für ein sinnvolles Setup drei getrennte Bausteine: einen Rechner oder Server für Hermes, einen Modellzugang und – nur wenn gewünscht – einen Messenger wie Telegram.

Die offizielle Plattformmatrix führt Linux/WSL2, moderne Apple-Silicon-Macs, Windows 10/11 und Docker als Tier-1-Plattformen. Android über Termux wird best effort unterstützt. Für einen dauerhaft erreichbaren Assistenten ist ein Linux-VPS meist einfacher als ein Laptop, weil der Gateway-Prozess auch bei geschlossenem Notebook weiterläuft.

Laufzeit

Rechner oder VPS

Linux ist für 24/7-Betrieb der geradlinigste Weg. Für lokale Tests funktionieren Apple Silicon, Windows und WSL2 ebenfalls.

Intelligenz

LLM-Provider

Zum Beispiel Nous Portal, OpenRouter, Anthropic, OpenAI Codex, NVIDIA NIM, Bedrock, Foundry oder ein eigener OpenAI-kompatibler Endpoint.

Zugriff

CLI oder Messenger

Starte zunächst im Terminal. Telegram, Discord oder Slack kommen erst dazu, wenn die Basis stabil antwortet.

Sicherheit

Berechtigungsmodell

Entscheide vorab, ob Terminalbefehle lokal, in Docker oder auf einem isolierten Host laufen und welche Verzeichnisse erreichbar sein dürfen.

Die offiziellen Installationswege im Überblick

Für die meisten Nutzer ist der von Nous Research ausgelieferte Installer der richtige Weg. Er hält die von Hermes erwartete Verzeichnisstruktur konsistent und erleichtert spätere Updates. Manuelle PyPI- oder Homebrew-Installationen listet die aktuelle Plattformdokumentation ausdrücklich nicht als unterstützte Distribution auf.

SystemEmpfohlener WegGeeignet fürWichtiger Hinweis
Linux / WSL2Offizielles install.shVPS, Server, EntwicklungAuf aktueller Ubuntu-Version am besten getestet
macOS Apple SiliconDesktop-Installer oder install.shLokale Nutzung, Local LLMIntel-Macs sind nicht mehr Tier 1
Windows 10/11Desktop-Installer oder install.ps1Desktop und native CLIEinzelne Funktionen können eingeschränkt sein
DockerOffizielles Container-ImageIsolation und reproduzierbarer BetriebUpdates durch neues Image, nicht mit hermes update
Android / Termuxinstall.shExperimente und mobile Always-on-SetupsTier 2, daher regressionsanfälliger
Linux, macOS, WSL2 oder Termux
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows PowerShell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Wenn du bei einem aus dem Netz geladenen Shellskript maximale Kontrolle willst, lade es zuerst herunter, lies es und führe es danach lokal aus. Das kostet eine Minute mehr und ist für produktive Server eine vernünftige Gewohnheit.

Schritt für Schritt vom Installer zur ersten belastbaren Session

  1. 01

    System und freien Speicher prüfen

    Prüfe Betriebssystem, Architektur, verfügbaren Speicher und ausgehenden HTTPS-Zugriff. Auf einem VPS sollte ein normaler Benutzer mit sudo statt dauerhafter Root-Arbeit verwendet werden.

  2. 02

    Offiziellen Installer ausführen

    Nutze den zur Plattform passenden Befehl. Öffne danach eine neue Shell, damit Änderungen am PATH sicher geladen sind.

  3. 03

    Modellzugang konfigurieren

    Starte hermes model. Für einen schnellen Einstieg kann Nous Portal über OAuth mehrere Modelle und Tool-Dienste bündeln; alternativ hinterlegst du den Key deines gewählten Providers.

  4. 04

    Diagnose statt Raten

    Führe hermes doctor aus. Behebe Provider-, Abhängigkeits- oder Gateway-Probleme jetzt, bevor du Skills und Messenger hinzufügst.

  5. 05

    Erste CLI-Aufgabe testen

    Starte hermes und gib eine kleine, überprüfbare Aufgabe: etwa eine Datei in einem Testverzeichnis lesen, zusammenfassen und ohne Änderungen berichten.

  6. 06

    Arbeitsverzeichnis und Regeln setzen

    Lege pro Projekt ein fokussiertes AGENTS.md an. Globale Persönlichkeit gehört in ~/.hermes/SOUL.md; Geheimnisse gehören nie in diese Kontextdateien.

  7. 07

    Erst danach Gateway oder Cron aktivieren

    Richte Telegram oder Zeitpläne erst ein, wenn ein manueller Lauf zuverlässig ist. So bleiben Fehlerursachen voneinander getrennt.

Basisprüfung nach der Installation
hermes --version
hermes doctor
hermes model
hermes

Wo Hermes Konfiguration, Secrets, Memory und Skills speichert

Eine saubere Verzeichnislogik ist entscheidend für Backups und Fehlersuche. Nicht-geheime Einstellungen landen grundsätzlich in ~/.hermes/config.yaml. API-Keys und Bot-Tokens gehören in ~/.hermes/.env. Sessions, Cron-Ausgaben, Pairing-Daten, Skills und Erinnerungen liegen ebenfalls im Hermes-Home, aber in getrennten Unterverzeichnissen.

Das ist mehr als Ordnung: Ein nächtliches Backup kann Konfiguration und Lernfortschritt sichern, während Secrets getrennt verschlüsselt oder ganz aus dem Backup ausgeschlossen werden. Wer alles blind in ein öffentliches Git-Repository synchronisiert, veröffentlicht sonst leicht Zugangsdaten.

ArtefaktTypischer OrtBackup-Empfehlung
Normale Einstellungen~/.hermes/config.yamlVersionieren, Secrets vorher prüfen
API-Keys und Tokens~/.hermes/.envVerschlüsselt sichern, niemals öffentlich committen
Globale Persönlichkeit~/.hermes/SOUL.mdVersionieren
Memory und Nutzerprofil~/.hermes/memories/Regelmäßig sichern, personenbezogene Daten beachten
Skills~/.hermes/skills/Versionieren und auf veraltete Verfahren prüfen
Sessions~/.hermes/sessions/Nach Schutzbedarf und Aufbewahrungsfrist behandeln

Produktivbetrieb: Gateway, Updates und Sicherheitsgrenzen

Ein funktionierender Chat im Terminal ist noch kein produktionsreifer Agent. Für 24/7-Betrieb brauchst du Prozessüberwachung, Backups, begrenzte Berechtigungen, kontrollierte Updates und eine Zuständigkeit für Fehlalarme. Der offizielle Gateway kann als Benutzer-Service oder auf Linux als System-Service installiert werden.

  • Nutze für Messenger immer Benutzer-Allowlisten oder DM-Pairing; GATEWAY_ALLOW_ALL_USERS=true gehört nicht auf einen Agenten mit Terminalzugriff.
  • Lasse unbekannten Code in Docker oder einem anderen isolierten Backend laufen und mounte nur benötigte Verzeichnisse.
  • Teste Updates zuerst gegen eine Kopie von Konfiguration, Skills und kritischen Cron-Jobs.
  • Definiere feste Budgets und beobachte Modellkosten, bevor unbeaufsichtigte Jobs nachts laufen.
  • Halte einen manuellen Kill-Switch bereit: Gateway stoppen, Provider-Key sperren und laufende Jobs beenden.
Gateway als Hintergrunddienst
hermes gateway install
hermes gateway start
hermes gateway status
Linux-Systemdienst für Boot-Start
sudo hermes gateway install --system
sudo hermes gateway status --system
journalctl -u hermes-gateway -f

Die häufigsten Installationsfehler und ihre echte Ursache

Viele scheinbare Hermes-Probleme liegen eine Ebene darunter: Die neue Shell kennt den Pfad noch nicht, Python ist zu alt, ein Provider-Key fehlt, das Modell hat zu wenig Kontext oder der Gateway läuft unter einem anderen Benutzer als die interaktive Session.

SymptomWahrscheinliche UrsachePrüfung
hermes: command not foundShell-Profil noch nicht neu geladenNeue Shell öffnen, which hermes und ~/.local/bin prüfen
Provider meldet 401Falscher, abgelaufener oder an falschen Endpoint gesendeter Keyhermes auth, Provider und Base-URL prüfen
Lokales Modell wird abgelehntKontextfenster unter 64KServer mit mindestens 65.536 Kontext starten
Telegram antwortet nichtGateway nicht aktiv oder Nutzer nicht erlaubtGateway-Status, Logs und Allowlist/Pairing prüfen
Cron läuft nichtGateway/Scheduler gestoppt oder Prompt unvollständighermes cron status und Job-Ausgabe prüfen
Tool findet Dateien nichtFalsches Arbeitsverzeichnis oder Container-Mountterminal.cwd und Backend-Konfiguration prüfen

Dokumentiere jede funktionierende Reparatur als kurze Betriebsnotiz oder Skill. Der eigentliche Vorteil eines lernenden Agenten entsteht erst, wenn auch Menschen nachvollziehen können, welche Annahme und welcher Fix funktioniert haben.

Häufige Fragen

Ist Hermes Agent kostenlos?

Ja. Der Agent ist Open Source unter MIT-Lizenz. Kosten entstehen typischerweise für Server, Modell-API, Such-/Browserdienste oder zusätzliche SaaS-Integrationen.

Kann ich Hermes ohne API-Key installieren?

Die Software lässt sich installieren, für sinnvolle Antworten brauchst du danach aber einen Modellzugang. Das kann OAuth, ein API-Key oder ein lokal betriebener kompatibler Endpoint sein.

Braucht Hermes eine GPU?

Nicht, wenn das Sprachmodell über einen externen Provider läuft. Eine GPU brauchst du nur für lokale oder selbst gehostete Modellinferenz; der Agent selbst ist vergleichsweise leichtgewichtig.

Soll ich Hermes als root installieren?

Für einen produktiven Server ist ein dedizierter, normaler Benutzer mit gezielten sudo-Rechten sicherer. Root vereinfacht kurzfristig das Setup, vergrößert aber den möglichen Schaden jeder Fehlbedienung.

Wie aktualisiere ich Hermes?

Bei einer normalen Installation nutzt du hermes update. Bei Docker wird das Image aktualisiert und neu gestartet. Vor größeren Updates sollten Konfiguration, Memory und eigene Skills gesichert sein.

Quellen, Methodik und Aktualität

Dieser Beitrag wurde aus praktischer Arbeit mit Hermes Agent und den unten verlinkten Primärquellen erstellt. Produktstände ändern sich schnell; Versions- und Befehlsangaben wurden zuletzt am geprüft.

  1. Hermes Agent Dokumentation – Nous Research
  2. Quickstart – Nous Research
  3. Platform Support – Nous Research
  4. FAQ & Troubleshooting – Nous Research
  5. Hermes Agent GitHub Repository – Nous Research