Hermes Agent installieren: Einrichtungsanleitung für Einsteiger

Hermes Agent ist ein Open-Source-KI-Agent von Nous Research, der im Terminal ausgeführt wird, verschiedene Modellanbieter verbindet, nützlichen Kontext sitzungsübergreifend speichert und sich mit Tools, Skills, Messaging-Gateways und Automatisierungen erweitern lässt. Dieser Leitfaden zeigt dir, wie du Hermes installierst. Für die Standardinstallation unter macOS oder Windows musst du Python oder Node.js nicht manuell installieren, da das offizielle Installationsprogramm die wichtigsten Abhängigkeiten für dich übernimmt.

Hermes Agent ist auf die Nutzung im Terminal ausgelegt. Daher installierst du es über die Kommandozeile. Wähle den Abschnitt, der zu deinem Computer passt:

• macOS: Öffne Terminal über Programme > Dienstprogramme > Terminal oder drücke Befehlstaste + Leertaste und suche nach „Terminal“.

• Windows: Installiere zuerst WSL2, öffne das Terminal deiner Linux-Distribution und befolge dann die Anleitung für Linux.

Du benötigst außerdem Git. Prüfe, ob Git installiert ist:

Erwartete Ausgabe:

Wenn git: command not found angezeigt wird, installiere zuerst Git:

Wenn du Homebrew unter macOS nicht hast, installiere Git über die Apple Command Line Tools, indem du Folgendes ausführst:

Kopiere den offiziellen Installationsbefehl in dein Terminal und füge ihn dort ein:

Das Installationsprogramm lädt Hermes Agent herunter, richtet die Python-Umgebung ein, installiert die erforderlichen Abhängigkeiten und fügt den Befehl hermes zu deinem Shell-Pfad hinzu. Bei einer normalen Installation für Benutzer werden Hermes-Daten unter ~/.hermes/ gespeichert.

Wenn der Befehl abgeschlossen ist, lade deine Shell neu:

Wenn du Zsh verwendest, was unter macOS üblich ist, führe Folgendes aus:

Erwartetes Ergebnis:

Bestätige nun, dass der Befehl für Hermes Agent verfügbar ist:

Erwartetes Ergebnis:

Die genaue Versionsnummer kann sich mit Aktualisierungen von Hermes Agent ändern.

Hermes Agent benötigt einen Modellanbieter, bevor es Antworten geben oder Tools verwenden kann. Die einfachste Einrichtung für Einsteiger erfolgt interaktiv:

Der Assistent lässt dich einen Anbieter wie Kimi/Moonshot auswählen. Konfiguriere Routing, Fallback, Gateway oder Cron erst, wenn ein einfacher Chat funktioniert.

Wähle das Standardmodell aus. Kimi K3 ist das neueste Flaggschiffmodell von Kimi; wenn du hauptsächlich programmieren möchtest, ist kimi-k2.7-code die bessere Wahl.

Wenn du den gewünschten Wert bereits kennst, kannst du hermes config set verwenden. Zum Beispiel:

Bevor du die Kimi API mit Hermes Agent verwendest, aktiviere deinen Kimi API Key auf der Kimi Plattform. Wir empfehlen mindestens $20, um Zugang zu Tier 2 freizuschalten, wodurch die Latenz sinkt und bei komplexen Aufgaben mit mehreren Schritten eine stabilere Leistung unterstützt wird.

Gehe in der Kimi Plattform zum Bereich API Keys und klicke auf Create API Key. Kopiere deinen API Key und bewahre ihn sicher auf. Der Schlüssel wird bei der Erstellung nur einmal angezeigt.

Füge deinen Kimi API Key ein und verbinde Hermes Agent.

Sobald das Modell konfiguriert ist, starte die klassische CLI:

Oder probiere die neuere Terminal-Benutzeroberfläche aus:

Du solltest einen Willkommensbildschirm oder prompt sehen, der deinen ausgewählten Anbieter bzw. dein Modell anzeigt. Teste es mit einer einfachen Anfrage:

Bei Erfolg sieht es so aus:

Wenn Hermes Agent startet, aber Modell- oder Authentifizierungsfehler meldet, führe Folgendes aus:

Wähle dann deinen Anbieter erneut aus und überprüfe den API-Schlüssel oder die OAuth-Anmeldung.

Wie OpenClaw kann Hermes Agent auch als Bot fungieren und sich mit deinen Chat-Apps verbinden:

Überprüfe nach der Einrichtung den Gateway-Status:

Verwende das Gateway erst, wenn dein Modellanbieter im Terminal funktioniert. Wenn die CLI keinen einfachen Chat abschließen kann, schlägt der Bot in der Regel aus demselben Grund fehl.

Ursache: Dein Terminal hat die PATH-Änderung noch nicht neu geladen.

Lösung:

Oder:

Versuche dann Folgendes:

Ursache: Git fehlt.

Lösung für Ubuntu, Debian oder WSL2:

Lösung für macOS mit Homebrew:

Ursache: Hermes Agent ist installiert, aber es ist kein Anbieterschlüssel und keine Anmeldung konfiguriert.

Lösung:

Oder lege einen Schlüssel manuell fest:

Ursache: Deine Konfigurationsdatei ist nach einem Update möglicherweise unvollständig.

Lösung:

Ursache: Die Basis-URL, der Modellname oder die Kontextlänge ist falsch.

Lösung: Teste den Endpunkt zunächst in einem separaten Client, bestätige, dass er mit OpenAI kompatibel ist, und stelle sicher, dass das Modell für normale Hermes-Agent-Workflows mindestens 64K Kontext unterstützt.

Am einfachsten installierst du Hermes Agent mit dem offiziellen Einzeilen-Installer. Lade anschließend deine Shell neu, führe hermes model aus und überprüfe die Einrichtung mit einem echten Chat sowie hermes doctor. Halte deine erste Einrichtung einfach: ein Rechner, ein Anbieter, eine funktionierende Unterhaltung. Sobald der grundlegende Hermes-Agent-Assistent stabil läuft, kannst du ihn sicher um Docker-Isolation, Gateway-Bots, Skills, geplante Automatisierungen und benutzerdefinierte Modellanbieter erweitern.