Hermes Agent Schnellstart: Von der Installation zu den ersten Schritten

Warum Hermes es wert ist, beachtet zu werden

Wenn Sie jemals ein neues AI-Tool installiert haben, die Binärdatei in Ihrem PATH landen sahen und trotzdem mit etwas endeten, das technisch vorhanden, aber praktisch nutzlos war, verstehen Sie bereits das Problem, das dieser Hermes Agent Quickstart löst. Eine abgeschlossene Installation beweist nur, dass Dateien kopiert wurden. Sie beweist nicht, dass der Agent ein Repo inspizieren, mit einem echten Modell kommunizieren, Tools sicher verwenden oder die Arbeit später wieder aufnehmen kann.

Deshalb ist Hermes es wert, beachtet zu werden. Wenn es ordnungsgemäß funktioniert, fühlt es sich nicht mehr wie „ChatGPT in einem Terminal” an und beginnt sich wie ein operativer Agent zu verhalten. Es kann Dateien inspizieren, Terminal-Tools verwenden, innerhalb eines Workspace bleiben und die Sitzung fortführen, anstatt so zu agieren, als würde jede Eingabe wieder bei null beginnen.

Das macht es zu einer guten Wahl für Entwickler, Self-Hoster und Terminal-first-Nutzer, die Hilfe bei echten Aufgaben benötigen: eine Codebasis zusammenfassen, ein Repo auf einem persönlichen Rechner prüfen oder auf einem kleinen VPS von AlexHost, AvaHost oder einem anderen Anbieter ausführen, ohne direkt in einen größeren Automatisierungs-Stack einzusteigen. Am Ende dieses Leitfadens haben Sie Hermes installiert, konfiguriert, an einer sicheren ersten Aufgabe getestet und erfolgreich wieder aufgenommen.

Was Hermes ist – und wobei Ihnen dieser Leitfaden tatsächlich helfen wird

Bevor Sie Befehle ausführen, halten Sie drei Begriffe auseinander. Die meiste Verwirrung beim ersten Ausführen entsteht dadurch, dass sie zu einer vagen Vorstellung von „der AI” zusammengefasst werden.

Die folgende Tabelle gibt Ihnen das mentale Arbeitsmodell für dieses Tutorial:

Dieser Artikel zielt auf nur einen Erfolgszustand ab: eine einzige sichere, funktionierende Hermes-Sitzung, die Sie starten, testen und wieder aufnehmen können. Es ist kein Leitfaden für den Produktionseinsatz. Es ist keine vollständige Feature-Tour. Es ist der kürzeste zuverlässige Weg zu „Hermes funktioniert auf meinem Rechner, und ich kann es beweisen.”

📝 Hinweis: Hermes zu installieren ist nicht dasselbe wie Hermes zu konfigurieren. Die Binärdatei kann vorhanden und dennoch unbrauchbar sein, bis Sie hermes model ausführen und es mit einem Provider und Modell verbinden.

Sie werden vielleicht bemerken, dass die offizielle Dokumentation auch hermes setup anbietet. Das ist gültig, aber dieser Leitfaden trennt die Installation bewusst von hermes model, damit Sie genau sehen können, wo die meisten Erfolge oder Misserfolge beim ersten Ausführen passieren. Wir bleiben auch aus Gründen der Reproduzierbarkeit beim klassischen CLI-first-Ansatz, obwohl hermes –tui existiert und dieselben zugrunde liegenden Sitzungen verwendet. Außerhalb des Rahmens dieses Quickstarts: Gateway-Setup, Cron, MCP, lokales Modell-Networking, Multi-Provider-Routing und Produktionshärtung.

Sicherheitsregeln, bevor Sie Hermes Shell-Zugriff geben

Bevor Sie einen Agent mit Terminal-Zugriff testen, entscheiden Sie, wo er falsch liegen darf. Für diesen Artikel bedeutet das: ein Nicht-Produktionsrechner, eine VM, ein wegwerfbares Repo oder zumindest ein risikoarmer Workspace, wo ein versehentlicher Befehl Ihren Tag nicht ruinieren würde.

⚠️ Warnung: Behalten Sie die Genehmigungen für diesen gesamten Quickstart im standardmäßig sicheren Modus bei und verwenden Sie nicht –yolo. Hermes fragt vor riskanten Befehlen nach; das ist eine Sicherheitsfunktion, keine sinnlose Reibung.

Verwenden Sie diese kurze Checkliste, bevor Sie fortfahren:

• Beginnen Sie auf einem risikoarmen Rechner oder Workspace.
• Behalten Sie Genehmigungsaufforderungen aktiviert.
• Vermeiden Sie persönliche Produktions-Repos für den ersten Test.
• Erwarten Sie, dass die Proof-Aufgabe schreibgeschützt bleibt.
• Behandeln Sie Docker- und SSH-Terminal-Backends als spätere Härtungsschritte, nicht als Anforderungen für den ersten Tag.

Die erste echte Proof-Aufgabe in diesem Leitfaden bleibt innerhalb von ~/.hermes/hermes-agent, was die Demo relevant für Hermes hält und gleichzeitig sensible Projekte vermeidet. Sobald der grundlegende CLI-Workflow stabil ist, können Sie zu stärkerer Isolation mit Docker oder Remote-Backends übergehen. In der ersten Stunde ist sicher und überprüfbar besser als ehrgeizig.

Vor der Installation: Voraussetzungen, unterstützte Pfade und ein WSL2-Problem

Für Mainstream-Nutzer ist die unterstützte Geschichte einfach: Linux, macOS und WSL2 sind die Pfade, um die man sich zuerst kümmern sollte. Natives Windows existiert, befindet sich aber noch in einer frühen Beta-Phase. Wenn Sie also unter Windows arbeiten, ist die praktische Empfehlung immer noch WSL2.

Stellen Sie auf Ubuntu 24.04 oder WSL2 zunächst sicher, dass git und curl verfügbar sind:

Wenn die zweite Zeile Ihren Distro-String sowie funktionierende Versionsausgaben für beide Tools zurückgibt, sind Ihre grundlegenden Voraussetzungen erfüllt. Auf macOS besteht die entsprechende Prüfung normalerweise nur darin, git –version und curl –version zu bestätigen, bevor Sie denselben Hermes-Installer verwenden.

📝 Hinweis: Natives Windows ist noch ein früher Beta-Pfad, bevorzugen Sie daher WSL2, wenn Sie unter Windows arbeiten.
💡 Tipp: Halten Sie in WSL2 Hermes und Ihre Arbeits-Repos unter ~ statt unter /mnt/c, um langsamere Git-Operationen und seltsames Datei-Berechtigungsverhalten zu vermeiden.

Die gute Nachricht ist, dass Hermes nicht erfordert, dass Sie zuerst manuell einen riesigen Abhängigkeits-Stack zusammenstellen. Der offizielle Git-Installer kümmert sich für Sie um uv, Python 3.11, Node.js 22, ripgrep und ffmpeg. Was Sie bereit haben sollten, bevor der Setup-Assistent startet, ist ein Provider-Account oder zumindest ein getesteter Plan für einen benutzerdefinierten Endpunkt. Wählen Sie außerdem ein Modell mit mindestens 64K Kontext: Kleinere Kontextfenster neigen dazu, zu versagen, sobald der Agent beginnt, Dateikontext, Tool-Ausgaben und mehrstufige Anweisungen gemeinsam zu verarbeiten.

Hermes Agent mit dem offiziellen Ein-Zeilen-Pfad installieren

Wenn die Voraussetzungen erfüllt sind, führen Sie den offiziellen Installer genau wie dokumentiert aus:

Dies ist nun mehr als ein bloßer Installationsschritt. Hermes erkennt die Plattform, bereitet die benötigten Abhängigkeiten vor und fährt dann sofort mit dem Erststart-Setup-Flow fort. Im obigen Beispiel erkennt der Installer Linux, prüft auf uv, installiert Python 3.11 wo nötig, bereitet Node.js 22 für Browser-Tools vor und erstellt die Hermes-Befehlsumgebung.

Wenn Ihre Installation als Root durchgeführt wird, sehen Sie möglicherweise Pfade wie /usr/local/bin/hermes, /usr/local/lib/hermes-agent und /root/.hermes/. Bei einer normalen Benutzerinstallation erwarten Sie dieselbe Struktur unter Ihrem eigenen Home-Verzeichnis.

Das wichtige Detail ist, dass der Ein-Zeilen-Installer nun direkt in den Setup-Assistenten übergeht. Mit anderen Worten: Installation und Erstkonfiguration sind ein kontinuierlicher Ablauf. Behandeln Sie das Ende der Paketinstallation nicht als Ziellinie, denn Hermes ist erst dann wirklich nützlich, wenn dieser Setup-Assistent abgeschlossen ist.

Die erste Entscheidung ist der Inferenz-Provider. In diesem Durchlauf wird OpenRouter ausgewählt, was eine praktische erste Wahl ist, da es über einen Provider-Account Zugang zu einem breiten Modellkatalog bietet. Wenn Sie bereits einen anderen unterstützten Provider verwenden, wählen Sie stattdessen diesen.

Sobald der Provider ausgewählt ist, fragt Hermes nach dem passenden API-Key. In diesem Beispiel bedeutet das OPENROUTER_API_KEY. Fügen Sie den Key ein, drücken Sie Enter, und Hermes speichert ihn für die zukünftige Verwendung.

Wenn Sie diesen Schritt überspringen, kann Hermes die Installation abschließen, ist aber noch nicht für eine echte Agent-Sitzung bereit. Sie müssten zurückkehren und den Provider später konfigurieren.

Nachdem der Key gespeichert wurde, wechselt der Assistent zur Modellauswahl. In diesem Durchlauf ist das ausgewählte Modell deepseek/deepseek-v4-pro. Das ist ein gültiges konkretes Beispiel, aber nicht Ihr einziger Weg: Der Assistent ermöglicht es Ihnen auch, einen benutzerdefinierten Modellnamen einzugeben oder zu überspringen und das aktuelle Modell beizubehalten, wenn Sie das Setup auf einer bestehenden Installation erneut ausführen.

Für einen ersten Durchlauf ist die praktische Regel einfach: Wählen Sie ein Modell, auf das Sie bereits wissen, dass Sie Zugriff haben, und stellen Sie sicher, dass es genug Kontext für echte Agent-Arbeit hat. Hermes ist mit Modellen, die mindestens ein 64K-Kontextfenster bieten, deutlich zuverlässiger. Kleinere Kontextfenster können bei einem kleinen Test gut aussehen, dann aber versagen, sobald Tool-Ausgaben, Dateikontext und mehrstufige Anweisungen sich anhäufen.

Wenn Sie diese Wahl später ändern möchten, ist hermes model immer noch der schnellste Weg, Provider- und Modellauswahl erneut durchzuführen, ohne etwas neu zu installieren.

Als nächstes fragt Hermes, wie viel vom umfassenderen Setup Sie jetzt sofort erledigen möchten. Für diesen Quickstart ist die empfohlene Option die richtige: Quick Setup.

Das hält den Artikel auf den tragenden Pfad fokussiert: Provider, Modell und die minimalen umgebenden Entscheidungen, die nötig sind, um Hermes nutzbar zu machen.

Der nächste Bildschirm fragt nach dem Terminal-Backend. Für einen ersten Durchlauf behalten Sie das aktuelle lokale Backend bei, damit Hermes direkt auf diesem Rechner läuft. Docker, SSH, Modal und andere Backends sind später nützlich, fügen aber Komplexität hinzu, bevor Sie den grundlegenden CLI-Workflow überhaupt bestätigt haben.

Hermes bietet dann das Einrichten einer Messaging-Plattform an. Für diesen Quickstart überspringen Sie das. Das hält den Leitfaden auf den grundlegenden CLI-Agent-Flow fokussiert, und Sie können später mit hermes setup gateway Telegram, Discord oder einen anderen Messaging-Pfad hinzufügen.

Sobald der Assistent fertig ist, zeigt Hermes an, wo die wichtigen Dateien gespeichert wurden.

Die wichtigste Aufteilung ist einfach zu merken: config.yaml enthält nicht-geheime Einstellungen, .env enthält API-Keys und andere Geheimnisse, und die Datenverzeichnisse enthalten Sitzungen, Logs und zugehörigen Laufzeitstatus. In diesem Screenshot befinden sich die Pfade unter /root/.hermes/, weil die Installation als Root durchgeführt wurde. Bei einer normalen Benutzerinstallation lesen Sie diese Pfade als ~/.hermes/.

Hermes gibt dann die kurze Bereit-zum-Loslegen-Zusammenfassung aus, einschließlich der Befehle, die Sie am wahrscheinlichsten zuerst verwenden werden.

Zu diesem Zeitpunkt ist Hermes sowohl installiert als auch konfiguriert. Als nächstes sollten Sie überprüfen, ob die Umgebung in Ordnung ist, bevor Sie mit der ersten echten Aufgabe fortfahren:

hermes doctor sollte die Grundlagen bestätigen: keine aktiven Sicherheitshinweise, eine funktionierende Python-Umgebung und die erforderlichen Pakete vorhanden. Das ist das saubere Erfolgssignal, das Sie vor dem Fortfahren haben möchten.

Wenn hermes in einer neuen Shell noch nicht sichtbar ist, laden Sie Ihre Shell neu und überprüfen Sie den Befehlspfad, bevor Sie fortfahren. Auf Bash bedeutet das normalerweise source ~/.bashrc; auf Zsh source ~/.zshrc. Falls nötig, bestätigen Sie den Launcher mit command -v hermes.

Wenn Doctor erfolgreich ist, ist die Installation nicht nur abgeschlossen – Hermes ist jetzt tatsächlich einsatzbereit.

Führen Sie Ihre erste sichere Agent-Aufgabe aus

Da Hermes nun installiert, konfiguriert und von hermes doctor geprüft wurde, sind Sie bereit für die erste echte Demonstration. Der sicherste hochwertige erste Workspace ist Ihr Hermes-Home-Verzeichnis selbst. In diesem Durchlauf wurde die Installation als Root durchgeführt, daher ist dieses Verzeichnis /root/.hermes. Bei einer normalen Benutzerinstallation wäre derselbe Ort ~/.hermes.

Wechseln Sie in dieses Verzeichnis, bestätigen Sie Ihren Standort und starten Sie dann Hermes:

Dies ist ein guter erster Workspace, weil er bereits vorhanden ist, direkt mit dem Tool zusammenhängt, das Sie gerade installiert haben, und im Vergleich zum Einsetzen eines Agents in ein persönliches oder Produktions-Repo risikoarm ist. Der Startbildschirm ist auch selbst eine nützliche Plausibilitätsprüfung: Er zeigt, dass Hermes korrekt startet, das aktive Modell in der Fußzeile und die Tatsache, dass der Agent bereits seine verfügbaren Tools und gebündelten Skills sehen kann.

Wenn Sie die neuere Oberfläche bevorzugen, ist hermes –tui weiterhin verfügbar, aber dieser Leitfaden bleibt beim klassischen CLI-first-Ansatz, weil er einfacher Schritt für Schritt zu reproduzieren ist und beide Oberflächen dieselben Sitzungen teilen.

Wenn Hermes geöffnet wird, geben Sie einen einfachen, schreibgeschützten Prompt ein, der es auffordert, den aktuellen Workspace zu inspizieren und den Einstiegspunkt zu identifizieren. In diesem Beispiel zielt der Prompt explizit auf /root/.hermes, weil die Installation als Root durchgeführt wurde. Bei einer normalen Benutzerinstallation verweisen Sie stattdessen auf Ihr eigenes ~/.hermes-Verzeichnis.

Verwenden Sie den folgenden Prompt:

Summarize this repo in 5 bullets and tell me what the main entrypoint is: ~/.hermes

Das ist genau die Art von erster Aufgabe, die Sie wollen: sicher, beobachtbar und leicht zu überprüfen. Im obigen Screenshot rät Hermes nicht nur. Es beginnt, konkrete Dateien wie config.yaml, SOUL.md und .install_method zu lesen, sucht nach Hermes-bezogenen Dateien und inspiziert den installierten Launcher-Pfad. Diese sichtbare Tool-Aktivität ist der eigentliche Beweis, dass Hermes sich wie ein Agent verhält, anstatt wie eine einmalige Chat-Box.

Ein gesundes Ergebnis sollte mit einer konkreten Zusammenfassung zurückkommen, die an den Workspace gebunden ist, und einem überprüfbaren Einstiegspunkt. In diesem Durchlauf identifiziert Hermes den installierten Befehlswrapper unter /usr/local/bin/hermes, erklärt, dass er zum Python-CLI-Einstiegspunkt führt, und fasst die umgebende Hermes-Umgebung in fünf Punkten zusammen.

Das ist das Erfolgssignal, nach dem Sie suchen. Die Antwort ist spezifisch, basiert auf Dateien, die Hermes tatsächlich inspiziert hat, und lässt sich leicht gegen das überprüfen, was Sie bereits auf der Festplatte sehen können. Behandeln Sie das Ergebnis nicht als Magie – vergleichen Sie die Zusammenfassung mit den sichtbaren Dateien und dem Verzeichnislayout. Für eine erste Demo ist sicher und überprüfbar viel besser als beeindruckend.

Sitzung fortsetzen und bestätigen, dass das Setup wirklich funktioniert

Der Quickstart ist nicht abgeschlossen, wenn Hermes einmal antwortet. Er ist abgeschlossen, wenn Sie bestätigen, dass die Sitzung fortgesetzt werden kann.

Verwenden Sie den folgenden Resume-Befehl; -c ist die Kurzform für dieselbe Aktion:

Das erwartete Ergebnis ist, dass Hermes die neueste Sitzung wieder öffnet oder Ihnen eine Zusammenfassung gibt, die eindeutig zu der Aufgabe gehört, die Sie gerade ausgeführt haben. Das ist wichtig, weil es beweist, dass Hermes nicht wie ein wegwerfbarer Einmal-Chat agiert. Es führt eine dauerhafte Arbeitssitzung, zu der Sie zurückkehren können.

Verwenden Sie diese kompakte Erfolgs-Checkliste, bevor Sie fortfahren:

• Hermes installiert und verifiziert
• Provider konfiguriert
• Erste Antwort sauber
• Erste Repo-Aufgabe abgeschlossen
• Sitzung erfolgreich fortgesetzt

Wenn das Fortsetzen nicht funktioniert, stellen Sie zunächst sicher, dass Sie dasselbe Profil verwenden, und prüfen Sie dann verfügbare Sitzungen mit hermes sessions list. Sobald hermes –continue funktioniert, haben Sie die vollständige Grundlage, die dieses Hermes Agent Tutorial etablieren sollte.

Was Sie als nächstes ausprobieren können, sobald der grundlegende Workflow funktioniert

Sobald der grundlegende Chat stabil ist, fügen Sie jeweils nur eine neue Ebene hinzu.

💡 Tipp: Widerstehen Sie dem Drang, sofort alle erweiterten Funktionen zu aktivieren. Stabilisieren Sie zuerst einen sauberen Workflow, dann erweitern Sie gezielt.

Hier ist das kurze Menü sinnvoller nächster Schritte:

• Probieren Sie hermes –tui, wenn Sie die neuere Terminal-Oberfläche auf Basis desselben Sitzungsmodells möchten.
• Führen Sie hermes setup später aus, wenn Sie den umfassenderen Setup-Assistenten nach dem manuellen Verstehen der Grundlagen möchten.
• Erkunden Sie hermes gateway setup, wenn Ihr nächstes Ziel die Integration einer Messaging-Plattform ist.
• Überprüfen Sie hermes tools und hermes skills, wenn Sie eine kontrollierte Funktionserweiterung wünschen.
• Wechseln Sie zu einem Docker- oder SSH-Terminal-Backend, wenn der Agent beginnt, höher riskante Systeme zu berühren.
• Verwenden Sie die offizielle Dokumentation für benutzerdefinierte Provider und lokale Modell-Endpunkte, sobald der gehostete Pfad bereits funktioniert.

Wenn Sie Ideen für echte Anwendungsfälle möchten, sind hier einige gute, die Sie als nächstes recherchieren können: Codebasis-Onboarding-Notizen, Changelog-Entwurf, sichere Refaktorierungsplanung, Konfigurationsdatei-Erklärung, Pull-Request-Review-Zusammenfassungen, VPS-Housekeeping-Checklisten, Deployment-Runbook-Entwurf, Log-Triage-Prompts und Dokumentationslücken-Findung.

Für tiefere Pfade verlinken Sie nach außen, anstatt diesen Quickstart in einen zweiten Artikel auszudehnen: der Quickstart, die Installationsdokumentation, der CLI-Leitfaden und der Sicherheitsleitfaden sind die richtigen nächsten Anlaufstellen.

Sie haben jetzt einen sicheren, funktionierenden Hermes Quickstart

Der wichtige Meilenstein ist nicht, dass Hermes installiert wurde. Der wichtige Meilenstein ist, dass Hermes nützlich wurde. Sie haben jetzt eine verifizierte Grundlage: Die Binärdatei ist vorhanden, der Provider ist konfiguriert, die erste Antwort hat funktioniert, die erste sichere Aufgabe wurde abgeschlossen und die Sitzung wurde danach fortgesetzt.

Das ist der richtige Punkt, um innezuhalten und den Erfolg zu verbuchen. Behalten Sie Genehmigungen aktiviert, erweitern Sie jeweils eine Ebene und wechseln Sie zu stärkerer Isolation, wenn der Agent beginnt, höher riskante Arbeiten durchzuführen. Wenn Sie Hermes schließlich auf einer persönlichen Workstation, einem Lab-Rechner oder einem VPS von AlexHost, AvaHost oder anderswo betreiben, bleibt die Regel dieselbe: Vertrauen in kleinen Schritten aufbauen.