Hermes installieren und mit OmniProxy konfigurieren

Hermes ist ein Assistent, der Unterhaltungen und Erfahrungen aus Aufgaben speichern kann. Bereits erledigte Arbeiten lassen sich als Fähigkeiten aufbereiten und später erneut verwenden. Über dasselbe Gateway kann Hermes außerdem mit Telegram, Discord, Slack, WhatsApp, Signal und dem Terminal verbunden werden. Das Gateway dient dabei als zentraler Eingang zum Empfangen und Weiterleiten von Nachrichten. So kannst du Hermes über dein gewohntes Chat-Tool mit Code-Reviews, Störungsprotokollen oder Kundenunterlagen beauftragen und die Arbeit anschließend im Repository fortsetzen lassen.

Vor der Installation

Wähle zunächst die Installationsmethode passend zu deinem Betriebssystem. Für macOS und Windows stehen Installationspakete mit grafischer Oberfläche zur Verfügung. Unter Linux, macOS und WSL2 kannst du ein Terminalskript verwenden. WSL2 ermöglicht es, eine Linux-Umgebung unter Windows auszuführen. Für Termux auf Android und Docker gibt es jeweils eigene Installationswege; in dieser Anleitung geht es nur um die Installation auf einem normalen Computer.

Mit Benutzeroberfläche

macOS, Windows

• macOS: DMG öffnen
• Windows: Installationspaket öffnen
• Anwendung im System installieren

Nur Terminal

Linux, macOS, WSL2

• Ein einziges install.sh
• Unter Windows install.ps1 verwenden
• Nach der Installation hermes eingeben

Vorerst nicht verwenden

pip, brew, AUR

• Diese Installationsmethoden werden offiziell nicht unterstützt
• Auch Aktualisierungen sind danach schwierig
• Stattdessen eine der beiden Optionen links verwenden

Halte vor Beginn einen Computer mit macOS, Windows oder Linux bereit und stelle sicher, dass du darauf ein Terminal öffnen und auf GitHub zugreifen kannst. Wenn du Hermes auf einer externen Festplatte installieren möchtest, schließe sie vorher an und prüfe, ob genügend Speicherplatz vorhanden ist.

Installation und erster Start

Installation mit grafischer Oberfläche

Öffne den Downloadbereich der Hermes-Website und lade das Installationspaket für dein Betriebssystem herunter. Die erforderliche Laufzeitumgebung ist bereits enthalten, sodass beim ersten Start nichts lokal kompiliert werden muss.

• macOS: Öffne die DMG-Datei und verschiebe Hermes.app in den Ordner „Programme“. DMG ist ein unter macOS verbreitetes Format für Installationsabbilder. Dieses Installationspaket unterstützt nur Apple-Chips; Intel-Macs werden nicht unterstützt.
• Windows: Öffne die .appinstaller-Datei mit dem Windows-App-Installer. Dabei wird ein signiertes MSIX installiert, also ein von Windows verwendetes App-Paket.
• Linux: Das Desktop-Installationspaket ist für macOS und Windows vorgesehen. Verwende unter Linux den unten gezeigten Terminalbefehl. Nach der Installation kannst du hermes desktop ausführen.

Installation nur über das Terminal

Wenn du Linux, macOS oder WSL2 verwendest, führe im Terminal Folgendes aus:

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

Wenn du die in Windows integrierte PowerShell verwendest, führe Folgendes aus:

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

Das Installationsprogramm lädt den Hermes-Code und die benötigten Programme herunter. Wird der Download unterbrochen, führe denselben Befehl einfach erneut aus. Schließe nach Abschluss der Installation zunächst das aktuelle Terminal, öffne ein neues Fenster und gib Folgendes ein:

hermes

Wenn die Hermes-Eingabeaufforderung erscheint, ist der Befehl einsatzbereit. Führe anschließend hermes doctor aus. Diese Installationsprüfung zeigt dir, welche Komponenten gegebenenfalls noch fehlen.

Programm auf einer externen Festplatte installieren

Am 9. Oktober 2026 wurde Hermes Agent v0.21.6 auf einem Mac auf einer externen Festplatte installiert. Das Programm befindet sich unter /Volumes/AItools/tools/hermes-agent, der Startbefehl unter ~/.local/bin/hermes. Konfiguration und Unterhaltungen werden weiterhin unter ~/.hermes gespeichert.

Wenn deine Festplatte anders heißt, ersetze den Pfad hinter --dir durch deinen eigenen Ordner. Während Hermes ausgeführt wird, muss diese Festplatte angeschlossen bleiben.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

Programm

Externe Festplatte

• tools/hermes-agent
• Code hier speichern

Befehl

~/.local/bin/hermes

• Im Terminal hermes eingeben
• Wird nach dem Öffnen eines neuen Fensters wirksam

Konfiguration und Unterhaltungen

~/.hermes

• config.yaml befindet sich hier
• Vor dem Trennen der Festplatte zuerst beenden

Verbindungsdaten aus OmniProxy abrufen

Hermes stellt hier eine Verbindung zu OmniProxy her, nicht direkt zu Grok oder Gemini. Die Dienstadressen von Grok und Gemini werden in OmniProxy konfiguriert. Trage sie nicht direkt in Hermes ein.

Dein Computer

Hermes

→

Lokales Gateway

OmniProxy

• Adresse bis einschließlich /v1 angeben

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Die Modell-ID ist der exakte Name, mit dem die Schnittstelle ein Modell identifiziert. Verwende für die beiden Modelle folgende Namen:

• Trage für Grok grok-4.7 ein. Die xAI-Schnittstelle lautet https://api.x.ai/v1; Chatanfragen verwenden /v1/chat/completions. Weitere Informationen findest du in der Grok-Modelldokumentation.
• Trage für Gemini gemini-3.8-flash ein. Die OpenAI-kompatible Schnittstelle von Google lautet https://generativelanguage.googleapis.com/v1beta/openai/. Weitere Informationen findest du in den Hinweisen zur OpenAI-Kompatibilität von Gemini.

Wenn du in Hermes stattdessen Gemini verwenden möchtest, musst du nur den Modellnamen durch gemini-3.8-flash ersetzen. Als Schnittstellenadresse bleibt weiterhin die Adresse von OmniProxy eingetragen.

Kopiere die Schnittstellenadresse und den Schlüssel aus OmniProxy und trage anschließend die entsprechende Modell-ID ein:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL ist die Schnittstellenadresse, an die Hermes seine Anfragen sendet. Sie muss hier mit /v1 enden. API Key ist der Schlüssel, den OmniProxy für Hermes bereitstellt. Ersetze den Platzhalter durch deinen eigenen Wert und veröffentliche den Schlüssel nicht.

Wenn dein lokaler OmniProxy keinen Schlüssel verlangt, kannst du API Key leer lassen. Sobald die Adresse jedoch für andere Personen erreichbar ist, solltest du einen Schlüssel verwenden. Stelle außerdem sicher, dass die Adresse aus der Umgebung erreichbar ist, in der Hermes ausgeführt wird. Wenn Hermes und OmniProxy auf demselben Computer laufen, kannst du eine lokale Adresse verwenden.

Tool-Konfiguration eintragen

Beende zunächst den laufenden Chat und führe anschließend im Terminal Folgendes aus:

hermes model

Wähle Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint bezeichnet eine benutzerdefinierte Schnittstelle. Hermes verbindet sich damit mit der von dir angegebenen Dienstadresse statt mit einem voreingestellten Anbieter.

Der Assistent fragt nacheinander nach Schnittstellenadresse, Schlüssel und Modellname. Trage die drei Werte aus dem vorherigen Abschnitt ein. Wenn du Gemini verwenden möchtest, gib als Modellnamen gemini-3.8-flash an.

Du kannst alternativ ~/.hermes/config.yaml direkt bearbeiten. YAML ist ein Textformat, das Konfigurationsbeziehungen durch Einrückungen darstellt. Für Grok sieht die Konfiguration so aus:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Wenn du Gemini verwendest, ersetze default durch gemini-3.8-flash. Die übrigen drei Einträge bleiben unverändert:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Speichere die Datei, starte hermes erneut und beginne dann einen Chat. In einer bereits geöffneten Sitzung kann /model nur zwischen bereits gespeicherten Anbietern wechseln. Der Befehl kann diese neue Konfiguration nicht hinzufügen.

Mit einer echten Aufgabe überprüfen

1

hermes doctor

• Installationsprüfung bestanden

2

Eine kurze Nachricht senden

• Antwort von Hermes wird angezeigt

3

Aufrufprotokoll öffnen

• Modellnamen überprüfen

1. Führe hermes doctor aus, um zu prüfen, ob die Installation vollständig ist.
2. Führe hermes aus und bitte den Assistenten, in einem Satz zu erklären, was er tun kann. Daraufhin sollte eine Antwort erscheinen.
3. Öffne die Aufrufprotokolle von OmniProxy. Prüfe, ob diese Anfrage von Hermes stammt und ob als Modellname grok-4.7 oder gemini-3.8-flash angegeben ist.

Dass der Assistent die Konfiguration erfolgreich gespeichert hat oder die Schnittstelle eine Erfolgsmeldung zurückgibt, bedeutet noch nicht, dass Hermes Aufgaben für dich erledigen kann. Der Modellname im Aufrufprotokoll muss exakt mit deinem Eintrag übereinstimmen.

Wenn du im Browser chatten möchtest, führe lokal Folgendes aus:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

Öffne anschließend http://127.0.0.1:9119. Diese Adresse ist nur auf dem aktuellen Computer erreichbar.

Häufige Fehler

• Nach der Eingabe von hermes wird gemeldet, dass der Befehl nicht gefunden wurde: Schließe zunächst das Terminal und öffne ein neues Fenster. Wird der Befehl weiterhin nicht gefunden, prüfe, ob ~/.local/bin in PATH enthalten ist. PATH ist die Liste der Verzeichnisse, in denen das System nach Befehlen sucht. Prüfe unter Windows, ob das vom Installationsprogramm eingetragene Startverzeichnis in PATH enthalten ist.
• Der Installationsdownload wird auf halbem Weg unterbrochen: Führe denselben Installationsbefehl erneut aus. Bereits heruntergeladene Daten werden weiterverwendet.
• Hermes antwortet nicht oder meldet, dass keine Verbindung möglich ist: Stelle sicher, dass OmniProxy ausgeführt wird, und prüfe, ob Base URL mit /v1 endet. Wenn Hermes in Docker und OmniProxy auf dem Hostsystem läuft, darfst du nicht 127.0.0.1 verwenden, wenn diese Adresse nur innerhalb des Containers gültig ist.
• Es wird ein ungültiger Schlüssel gemeldet: Aktualisiere den OmniProxy-Schlüssel und ändere anschließend api_key in config.yaml. Die Schlüssel von xAI oder Google gehören zu den Anbietereinstellungen in OmniProxy und dürfen nicht in dieses Feld von Hermes eingetragen werden.
• Es wird gemeldet, dass das Modell nicht vorhanden ist: Öffne die aktuelle Modellliste von OmniProxy und kopiere grok-4.7 oder gemini-3.8-flash exakt so, wie der Name dort angezeigt wird.
• Hermes antwortet, kann aber keine Dateien lesen, Befehle ausführen oder ähnliche Aufgaben erledigen: Wechsle in OmniProxy zu einem anderen Modell mit diesen Fähigkeiten und starte anschließend eine neue Hermes-Sitzung.
• Das Programm befindet sich auf einer externen Festplatte, und hermes doctor meldet nach dem Entfernen der Festplatte einen Speicherfehler: Schließe die Festplatte wieder an. Lasse Hermes keine separate Konfiguration anlegen, während die Festplatte nicht verbunden ist.

Offizielle Referenzen

Die Installationsschritte findest du in der Hermes-Installationsdokumentation und unter Plattformunterstützung. Die Konfiguration eines Custom endpoint wird in der Hermes-Provider-Dokumentation beschrieben. Die Modell-IDs findest du jeweils in der Grok-Modelldokumentation und in den Hinweisen zur OpenAI-Kompatibilität von Gemini.

Die Installation unter macOS wurde am 2026-10-09 mit Hermes Agent v0.21.6 vollständig durchgeführt. grok-4.7 und gemini-3.8-flash waren an diesem Tag die Standard-Modell-IDs in der Dokumentation von xAI beziehungsweise Google. Verwende bei der tatsächlichen Konfiguration den Namen, der in OmniProxy angezeigt wird.

Ersetze jeden Platzhalter durch Werte aus deiner OmniProxy-Konfiguration. Veröffentliche niemals einen echten Schlüssel.

Ein gespeichertes Ergebnis oder HTTP 200 allein beweist keine vollständige Agenten-Kompatibilität. Prüfe Quelle und Modell im OmniProxy-Aufrufprotokoll.

Offizielle Quellen · Hermes ↗