Hermes Agent: Was es ist, wie man ihn installiert und konfiguriert

Claude Code, Codex, Cursor, OpenClaw – jeder dieser KI-Agenten hat seine eigene Rolle. Wenn du einen Agenten brauchst, der auf deinem Server läuft, sich zwischen Sitzungen an dich erinnert und dir auf Telegram antwortet, während du im Taxi sitzt, passt Hermes Agent zu dieser Rolle.

Hermes Agent ist ein offenes Projekt von Nous Research und lässt sich viel einfacher installieren, als viele denken. Hier erfährst du, was es ist, wie viel es kostet, wie du es unter Windows, macOS oder Linux installierst und wie du ein Modell und einen Telegram-Bot damit verbindest. Alles basiert auf der offiziellen Dokumentation.

Was ist Hermes Agent in einfachen Worten?#

Hermes gehört zur selben Kategorie wie Claude Code oder Codex: Es ist ein KI-Agent, der nicht nur Antworten schreibt, sondern Dateien öffnet, Terminalbefehle ausführt und einen Browser nutzt. Der Unterschied liegt im Aufbau: Claude Code ist an Anthropic-Modelle gebunden, während Hermes mit jedem Modellanbieter funktioniert – von Claude und GPT bis zu lokalen Modellen, die auf deiner Hardware laufen.

Das Projekt ist jung: Sein GitHub-Repository wurde am 22. Juli 2025 erstellt. Trotzdem hat es am 22. August 2026 mehr als 234.000 Sterne und 47.000 Forks und ist damit eines der am schnellsten wachsenden offenen Projekte dieser Kategorie. Der Code ist vollständig unter der MIT-Lizenz offen: Du kannst ihn ohne Lizenzgebühren lesen, ändern und in deinen Produkten verwenden.

Zwei konkrete Mechanismen bilden die Grundlage dieser „Selbstverbesserung“: Skills und Gedächtnis. Skills sind Verfahren, die der Agent nach komplexen Aufgaben dokumentiert und beim nächsten Mal anwendet. Das Gedächtnis ist eine Datei mit Fakten über dich und deine Umgebung, die in jedes neue Gespräch geladen wird. Beide Mechanismen werden weiter unten in einem eigenen Abschnitt behandelt.

Wie unterscheidet sich Hermes Agent von Claude Code und Codex?#

Die wichtigsten Unterschiede sind in dieser Tabelle zusammengefasst:

Die Tabelle macht den Hauptpunkt deutlich. Claude Code eignet sich für Aufgaben, die das stärkste Modell erfordern und in einem Repository stattfinden – Anthropic hat hier weiterhin die beste Kombination aus Modell und Tools. Hermes ist für Fälle gedacht, in denen du einen Agenten „immer verfügbar“ brauchst: Er läuft auf einem Server, erledigt jeden Morgen nach Zeitplan etwas, antwortet dir auf Telegram und erinnert sich an das Gespräch von gestern.

Wenn du grundlegende Tools vergleichst, gibt es separate Anleitungen dazu, wie man Claude Code installiert, was Codex von OpenAI ist und zur Landschaft der KI-Coding-Tools im Jahr 2026.

Wie viel kostet Hermes Agent im Jahr 2026?#

Am einfachsten ist Nous Portal, das native Abonnement der Hermes-Entwickler. Es umfasst mehr als dreihundert Modelle und außerdem sofort nutzbare Dienste: Websuche, Bildgenerierung, Sprachsynthese und einen Cloud-Browser. Am 22. August 2026 gelten folgende Tarife:

Die zweite Möglichkeit, die viele übersehen: Du musst dich überhaupt nicht für ein neues Abonnement anmelden. Hermes kann sich per OAuth anmelden – also über ein Konto, das du bereits hast. Unterstützt werden ChatGPT- und Codex-Abonnements, Claude Max, SuperGrok von xAI, Qwen, MiniMax und GitHub Copilot. Wähle bei der Einrichtung einen Anbieter, bestätige die Anmeldung im Browser und bezahle dann genau das, was du bereits vorher bezahlt hast.

Die dritte Möglichkeit sind eigene API-Schlüssel. Anthropic, OpenAI, Google, DeepSeek, Z.AI, Kimi, Alibaba und etwa ein Dutzend weitere Anbieter: Gib einen Schlüssel ein, und die Nutzung wird direkt über deren Konto abgerechnet.

Die vierte Möglichkeit kostet kein Geld, erfordert aber Hardware: ein lokales Modell über Ollama oder LM Studio. Das funktioniert, wenn du einen leistungsstarken Computer hast und keine Daten nach außen senden möchtest. Es gibt eine Bedingung: Das Modell muss ein Kontextfenster von mindestens 64.000 Tokens haben, sonst weigert sich Hermes, damit zu starten – der Agent braucht genug Arbeitsspeicher für lange Aufgaben.

Zahlungsbedingungen für ausländische Dienste werden hier nicht behandelt – das ist ein eigenes Thema mit eigenen Regeln, das diese Anleitung am Beispiel von Claude Code bespricht.

Möchtest du den Agenten so einrichten, dass er sich an dich erinnert und zuverlässig arbeitet? Skills und Gedächtnis in Hermes bieten fertige Mechanismen zur Wissensorganisation. Diese Kombination macht aus KI einen Arbeitshelfer statt eines „halluzinierenden Assistenten“.

Hermes Agent unter Windows installieren#

Wenn du mit dem Terminal nicht vertraut bist, nimm den Installer. Auf der Website hermes-agent.nousresearch.com gibt es Download-Schaltflächen für macOS 12+, Windows 10/11 und Linux. Die heruntergeladene Datei installiert beide Apps auf einmal: die Kommandozeile hermes und Hermes Desktop – ein normales Fenster mit Chat, Dateien und Einstellungen.

Wenn du mit Befehlen vertraut bist, installiere Hermes über PowerShell:

1. PowerShell öffnen

   Drücke Win, gib PowerShell ein und öffne es. Administratorrechte sind nicht erforderlich.

2. Den Installer ausführen

   iex (irm https://hermes-agent.nousresearch.com/install.ps1)
   

   Das Skript lädt alles herunter, was es benötigt: Python 3.11, Node.js 22, den Paketmanager uv, ripgrep und ffmpeg. Wenn Git fehlt, installiert es eine eigene isolierte MinGit-Version, die separat gespeichert wird und Systemprogramme nicht verändert.

3. Das Terminal neu starten und prüfen

   hermes doctor
   

   Der Befehl zeigt, was installiert ist, was fehlt und wie sich das beheben lässt. Wenn du grüne Häkchen siehst, ist alles installiert.

Bei dieser Installationsmethode werden die Dateien unter %LOCALAPPDATA%\hermes gespeichert. Wenn du WSL2 verwendest, funktioniert darin auch der Linux-Befehl aus dem nächsten Abschnitt – wähle die für dich bequemere Methode.

Hermes Agent unter macOS und Linux installieren#

Hermes lässt sich mit einem Befehl installieren – auf einem Laptop oder Server. Der gesamte Ablauf:

1. Prüfen, ob Git installiert ist

   git --version
   

   Wenn der Befehl eine Versionsnummer zurückgibt, fahre fort. Prüfe unter Linux außerdem, ob curl und xz-utils installiert sind: Unter Debian und Ubuntu installierst du sie mit sudo apt install curl xz-utils.

2. Den Installer ausführen

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

   Das Skript klont das Repository nach ~/.hermes/hermes-agent, erstellt eine virtuelle Umgebung und installiert den Befehl hermes unter ~/.local/bin. Für einen Server ohne grafische Oberfläche und Browserautomatisierung gibt es eine schlanke Option: Füge am Ende bash -s -- --skip-browser hinzu.

3. Die Shell neu laden und starten

   source ~/.zshrc   # on macOS; on Linux, more often: source ~/.bashrc
   hermes
   

Bei einer Installation als root landen die Dateien in Systempfaden – /usr/local/lib/hermes-agent und /usr/local/bin/hermes –, was für einen Server mit mehreren Benutzerkonten praktisch ist. Einstellungen, Schlüssel und Gedächtnis bleiben im persönlichen Ordner ~/.hermes jedes Benutzers.

Ein Hinweis zu Hermes Desktop unter Linux: Um die App unter Debian und Ubuntu zu erstellen, brauchst du die Compiler aus dem Paket build-essential (sudo apt install build-essential). Und wenn du Hermes über den Befehl installiert hast, brauchst du keinen separaten Installer – führe hermes desktop aus, und die App startet mit deinen vorhandenen Einstellungen, Sitzungen und Skills.

Ein Modell mit Hermes Agent verbinden#

Das Modell ist der Motor von Hermes: Der Agent denkt nicht selbst, sondern kommuniziert mit dem von dir ausgewählten Modell. Der erste Schritt nach der Installation besteht also darin, auszuwählen, womit es sich verbindet:

hermes model

Der Einrichtungsassistent fragt nach einem Anbieter, einer Anmeldemethode und einem Modell. Es gibt viele Möglichkeiten; die wichtigsten sind:

Wenn du Nous Portal auswählst, erledigt ein Befehl alles auf einmal:

hermes setup --portal

Der Befehl öffnet eine Anmeldeseite im Browser. Nach deiner Bestätigung richtet er Nous als Anbieter ein und aktiviert Tool Gateway – Websuche, Bildgenerierung und Sprachsynthese ohne separate Schlüssel für jeden Dienst.

Hermes speichert Schlüssel und Einstellungen getrennt; das solltest du von Anfang an wissen. Geheimnisse – API-Schlüssel und Tokens – werden in ~/.hermes/.env gespeichert. Allgemeine Einstellungen stehen in ~/.hermes/config.yaml. Du musst diese Dateien nicht von Hand bearbeiten: hermes config set legt jeden Wert automatisch in der richtigen Datei ab:

Anleitungen zu Tools in der Ailoot-Dokumentation finden

Der vollständige Einrichtungsassistent heißt hermes setup. Er hat drei Modi: eine Schnelleinrichtung über Nous Portal, eine vollständige Einrichtung, bei der du jeden Anbieter und jedes Tool selbst durchgehst, und Blank Slate – eine saubere Installation, bei der bis auf das Nötigste alles deaktiviert ist, damit du nur aktivierst, was du brauchst.

Prüfen, ob Hermes Agent funktioniert#

Nachdem du ein Modell ausgewählt hast, starte ein Gespräch:

hermes          # classic interface
hermes --tui    # modern interface, with mouse support and pop-up windows

Das Willkommensbanner zeigt das ausgewählte Modell, die aktivierten Tools und Skills. Frage als Nächstes nicht „Hallo, wer bist du?“, sondern gib dem Agenten eine Aufgabe mit sichtbarem Ergebnis: „Zeig mir die fünf größten Ordner auf der Festplatte“ oder „Sieh dir den aktuellen Ordner an und sag mir, welche Datei die Hauptprojektdatei ist.“ Wenn der Agent einen Terminalbefehl ausführt und eine sinnvolle Antwort zurückgibt, funktioniert die Grundeinrichtung.

Die letzte Prüfung gilt den Sitzungen. Beende das Gespräch und kehre zurück:

hermes --continue   # or shorter: hermes -c

Du solltest dich im selben Gespräch wiederfinden. Damit wird geprüft, ob die Sitzungsdaten auf der Festplatte gespeichert werden – später hängen der Bot und geplante Aufgaben davon ab.

Wenn etwas nicht funktioniert, gehe in dieser Reihenfolge vor: hermes doctor (allgemeine Diagnose), hermes model (Modell und Anmeldung erneut prüfen), hermes setup (Konfiguration neu erstellen), hermes sessions list und hermes --continue (Sitzungen prüfen), hermes gateway status (Gateway-Status). Mit dieser Abfolge gelangst du in wenigen Minuten von „alles ist kaputt“ zurück zu einem klaren Zustand.

Was sind Skills und Gedächtnis in Hermes Agent?#

Ein Hermes-Skill ist eine SKILL.md-Datei mit einem Namen, einer Beschreibung und einem schrittweisen Verfahren: etwa zum Zusammenstellen eines Dokuments, Eröffnen eines Pull Requests oder Vorbereiten eines Mailings. Der Agent liest die Kurzbeschreibungen aller Skills und lädt dann den vollständigen Text nur, wenn die Aufgabe dazu passt – so blähen hundert installierte Skills nicht jede Anfrage auf. Der Standard ist offen: agentskills.io, und dieselben Dateien funktionieren auch in anderen Agenten.

Skills liegen im Ordner ~/.hermes/skills/. Sie kommen auf drei Wegen dorthin: Ein Basispaket wird zusammen mit der App installiert, fertige Skills lassen sich mit hermes skills install aus dem Katalog hinzufügen, und nach komplexen Aufgaben schreibt der Agent neue Skills für sich selbst. Jeder Skill wird automatisch zu einem Slash-Befehl: Installiere den gif-search-Skill, und /gif-search funktioniert in jedem Chat. Bei der Installation aus dem Katalog findet eine Sicherheitsprüfung statt, damit das Verfahren eines anderen keine schädlichen Befehle einschleust.

Das Gedächtnis ist noch einfacher. Zwei Dateien unter ~/.hermes/memories/: MEMORY.md – die eigenen Notizen des Agenten über seine Umgebung und Schlussfolgerungen, bis zu 2.200 Zeichen – und USER.md – dein Profil: wie der Agent dir antworten soll, was du magst und nicht magst, bis zu 1.375 Zeichen. Zu Beginn jedes Gesprächs werden beide Dateien dem System-Prompt hinzugefügt, sodass der Agent bereits etwas über dich weiß. Die Grenzen sind bewusst streng: Das Gedächtnis wächst nicht endlos, und der Agent entscheidet, was er behält und was er verwirft.

Diese beiden Bausteine – Skills plus Gedächtnis – bilden das Second Brain: einen Agenten, der sich an Kontext erinnert und Verfahren sammelt und jede Woche merklich besser arbeitet als am Tag seiner Installation. Hinweise zur Auswahl dieser Skills und dazu, wie du verhinderst, dass dein Agent zur Ablage wird, findest du in dieser Anleitung am Beispiel von Claude Code – die Prinzipien sind dieselben.

Hermes Agent mit Telegram verbinden#

Telegram ist Hermes’ beliebtester Kanal, und die Integration ist gut ausgebaut: Text, Sprachnachrichten mit Transkription, Bilder und Dateien sowie Antworten in Gruppen. So gehst du vor:

1. Mit BotFather einen Bot erstellen

   Öffne @BotFather in Telegram, sende /newbot, wähle einen Namen und einen eindeutigen Benutzernamen, der mit bot endet. Du erhältst ein Token wie 123456789:ABCdef... – das ist der Schlüssel zu deinem Bot, also bewahre es wie ein Passwort auf. Wenn das Token bekannt wird, widerrufe es, indem du /revoke an denselben BotFather sendest.

2. Deine Benutzer-ID finden

   Finde deine numerische Telegram-ID, zum Beispiel 123456789. Das ist die Nummer deines Kontos; verwechsle sie nicht mit deinem Benutzernamen. Du brauchst sie für die Zugriffsliste.

3. Den Gateway-Einrichtungsassistenten starten

   hermes gateway setup
   

   Wähle Telegram und füge dein Token und deine ID ein. Der Assistent speichert die Einstellungen für dich. Du kannst es auch manuell mit zwei Zeilen in ~/.hermes/.env erledigen: TELEGRAM_BOT_TOKEN=... und TELEGRAM_ALLOWED_USERS=123456789.

4. Das Gateway starten

   hermes gateway
   

   Der Bot ist nach wenigen Sekunden online. Schreibe ihm und prüfe die Antwort.

Der Zugriff ist standardmäßig eingeschränkt: Der Bot antwortet nur auf IDs in der Liste. Du kannst einer neuen Person einen Kopplungscode geben – er funktioniert eine Stunde lang und läuft dann ab. Die Liste ausstehenden und freigegebenen Benutzer erhältst du mit hermes pairing list.

Bei Gruppenchats gibt es eine Falle, die oft vergessen wird. Standardmäßig ist bei Telegram-Bots der Datenschutzmodus aktiviert: In einer Gruppe sieht ein Bot nur Befehle und Antworten auf eigene Nachrichten. Damit er alles lesen kann, schalte den Modus über @BotFather aus (Bot Settings - Group Privacy) oder mache den Bot einfacher zum Gruppenadministrator.

Standardmäßig ruft das Gateway die Telegram-Server selbst ab – das ist für einen Heimcomputer oder einen Server, der immer eingeschaltet ist, in Ordnung. Für Cloud-Plattformen, die den Rechner bei ausbleibendem eingehendem Datenverkehr in den Ruhezustand versetzen, gibt es den Webhook-Modus, bei dem Telegram Nachrichten an deine Adresse sendet.

Was kann Hermes Agent nach der Installation noch?#

Das solltest du der Reihe nach aktivieren:

1. Geplante Aufgaben. Das Gateway hat einen integrierten Scheduler: „Stell jeden Morgen um 8 eine Nachrichtenübersicht zu meinen Themen zusammen und schick sie mir auf Telegram.“ Lege den Zeitplan mit einer normalen Formulierung fest, und die Ergebnisse erscheinen im selben Chat.
2. Hermes Desktop. Der Befehl hermes desktop öffnet die App für macOS, Windows und Linux mit demselben Agenten: fortlaufende Antworten, Dateivorschauen neben dem Chat, Drag-and-drop von Dokumenten und ein Kontextzähler. Sitzungen werden geteilt – du kannst im Terminal beginnen und im Fenster weitermachen.
3. Webpanel. hermes dashboard öffnet im Browser ein Panel für Kanäle, Gedächtnis, Webhooks und Profile. Nützlich, wenn Hermes auf einem Server läuft.
4. Subagenten. Du kannst eine große Aufgabe an isolierte Hilfsagenten delegieren – jeder hat ein eigenes Gespräch und Terminal, sodass sie deinen Kontext nicht verbrauchen.
5. Sprache. Der Sprachmodus funktioniert im Terminal, auf Telegram und Discord – du kannst eine Aufgabe diktieren und eine gesprochene Antwort erhalten.
6. Code-Editor. Über das ACP-Protokoll verbindet sich Hermes direkt im Editor als Agent mit VS Code, Zed und JetBrains.

Tools lassen sich mit hermes tools einzeln ein- und ausschalten, damit der Agent nicht alles ständig mit sich herumträgt. Wenn es Zeit ist, auf einen anderen Rechner umzuziehen, bündelt hermes backup die gesamte Installation in einem Archiv, und hermes import entpackt sie am neuen Speicherort.

Für wen eignet sich Hermes Agent, und wer sollte noch warten?#

Hermes zu installieren ergibt Sinn, sobald du weißt, was ein Agent für dich tun soll: Dokumente sortieren, einen Prototyp erstellen, Korrespondenz verwalten oder morgendliche Zusammenfassungen vorbereiten. Das Tool selbst ist nicht entscheidend – es sind die Aufgaben, die du ihm gibst. Dazu gibt es eine separate Anleitung zu Aufgaben für einen KI-Agenten.

In zwei Fällen passt es möglicherweise nicht. Erstens, wenn du erwartest, dich „anzumelden und sofort loslegen zu können“: Hermes muss installiert und mit einem Modell verbunden werden. Das dauert nur einen Befehl, aber du musst trotzdem das Terminal öffnen. Zweitens, wenn du kein geeignetes Modell hast und dich nicht mit Abonnements oder API-Schlüsseln befassen möchtest.

Alle anderen sollten klein anfangen: installieren, ein Modell auswählen, ein reibungsloses Gespräch führen, dann einen Telegram-Bot hinzufügen – und erst danach Zeitpläne und Subagenten.

Was fragen Menschen sonst noch zu Hermes Agent?#

Weitere Ressourcen findest du auf Ailoot.