Hermes installieren und OmniProxy konfigurieren

Hermes ist ein Assistent, der Konversationen und Aufgabenerfahrung speichern kann und abgeschlossene Arbeit in Fähigkeiten verwandelt, die später wiederverwendet werden können. Über ein einziges Gateway kann er auch eine Verbindung zu Telegram, Discord, Slack, WhatsApp, Signal und dem Terminal herstellen. Das Gateway dient als einheitlicher Einstiegspunkt für den Empfang und die Weiterleitung von Nachrichten. Sie können ihm Code-Reviews, Vorfallnotizen oder Kundenmaterialien aus Ihren üblichen Chat-Tools senden und ihn dann zum Repository zurückkehren und weiterarbeiten lassen.

Vorbereitung

Wählen Sie zuerst eine Installationsmethode basierend auf dem Betriebssystem Ihres Computers. macOS und Windows können direkt grafische Installer verwenden, während Linux, macOS und WSL2 ein Terminal-Skript nutzen können. WSL2 ist eine Windows-Funktion zum Ausführen einer Linux-Umgebung. Termux auf Android-Telefonen und Docker haben ihre eigenen Installationsmethoden, aber diese Anleitung deckt nur die Installation auf regulären Computern ab.

Möchten ein Fenster

macOS, Windows

• macOS: DMG öffnen
• Windows: Installer öffnen
• App auf dem System installieren

Nur Terminal

Linux, macOS, WSL2

• Ein install.sh-Befehl
• install.ps1 auf Windows verwenden
• Nach der Installation hermes eingeben

Diese noch nicht verwenden

pip, brew, AUR

• Diese Installationsmethoden werden offiziell nicht unterstützt
• Sie sind nach der Installation auch schwer zu aktualisieren
• Verwenden Sie stattdessen eine der beiden Optionen links

Bevor Sie beginnen, bereiten Sie einen macOS-, Windows- oder Linux-Computer vor und stellen Sie sicher, dass er ein Terminal öffnen und auf GitHub zugreifen kann. Wenn Sie Hermes auf einem externen Laufwerk installieren möchten, schließen Sie das Laufwerk zuerst an und bestätigen Sie, dass genügend freier Speicherplatz vorhanden ist.

Installation und erster Start

Wenn Sie eine grafische App wünschen

Gehen Sie zum Download-Bereich auf der Hermes-Website und laden Sie den Installer für Ihr Betriebssystem herunter. Der Installer enthält bereits die Laufzeitumgebung, sodass beim ersten Öffnen nichts lokal kompiliert werden muss.

• macOS: Öffnen Sie das DMG und verschieben Sie Hermes.app in Programme. Ein DMG ist ein auf macOS übliches Installationsabbild. Dieser Installer unterstützt nur Apple Silicon; Intel-Macs werden nicht unterstützt.
• Windows: Öffnen Sie die .appinstaller Datei mit dem Windows App Installer. Er installiert ein signiertes MSIX, eine Art von Anwendungspaket, das von Windows verwendet wird.
• Linux: Die Desktop-Installer sind für macOS und Windows. Verwenden Sie unter Linux den unten stehenden Terminal-Befehl. Nach der Installation können Sie hermes desktopausführen.

Wenn Sie nur das Terminal benötigen

Wenn Sie Linux, macOS oder WSL2 verwenden, führen Sie dies in einem Terminal aus:

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

Wenn Sie die mit Windows gelieferte PowerShell verwenden, führen Sie aus:

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

Der Installer lädt den Hermes-Code und die zum Ausführen erforderlichen Programme herunter. Wenn der Download unterbrochen wird, führen Sie denselben Befehl erneut aus. Schließen Sie nach Abschluss der Installation das aktuelle Terminal, öffnen Sie ein neues Fenster und geben Sie ein:

hermes

Wenn Sie die Hermes-Eingabeaufforderung sehen, ist der Befehl einsatzbereit. Sie können dann hermes doctorausführen; diese Installationsprüfung zeigt Ihnen, was noch fehlt.

Programm auf einem externen Laufwerk speichern

Am 9. Oktober 2026 wurde Hermes Agent v0.21.6 auf einem externen Laufwerk installiert, das an einen Mac angeschlossen war. Das Programm wurde unter /Volumes/AItools/tools/hermes-agentgespeichert, der Launcher-Befehl befand sich unter ~/.local/bin/hermesund Konfigurations- sowie Konversationsdaten verblieben unter ~/.hermes.

Wenn Ihr Laufwerk einen anderen Namen hat, ersetzen Sie den Pfad nach --dir durch Ihren eigenen Ordner. Das Laufwerk muss angeschlossen bleiben, während Hermes läuft.

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

Programm

Externes Laufwerk

• tools/hermes-agent
• Code hier behalten

Befehl

~/.local/bin/hermes

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

Konfiguration und Chats

~/.hermes

• config.yaml ist hier
• Vor dem Trennen des Laufwerks beenden

Verbindungswerte aus OmniProxy abrufen

Hier verbindet sich Hermes mit OmniProxy anstatt direkt mit Grok oder Gemini. Konfigurieren Sie die Grok- und Gemini-Dienst-URLs in OmniProxy; geben Sie diese nicht direkt in Hermes ein.

Ihr Computer

Hermes

→

Lokales Gateway

OmniProxy

• /v1 in die Adresse einfügen

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Eine Modell-ID ist der exakte Name, den die API zur Identifizierung eines Modells verwendet. Verwenden Sie die folgenden Namen für die beiden Modelle:

• Geben Sie für Grok grok-4.7ein. Die xAI-API ist https://api.x.ai/v1, und Chat-Anfragen verwenden /v1/chat/completions. Siehe die Grok-Modelldokumentation.
• Geben Sie für Gemini gemini-3.8-flashein. Googles OpenAI-kompatible API ist https://generativelanguage.googleapis.com/v1beta/openai/. Siehe Geminis OpenAI-Kompatibilitätsdokumentation.

Um Hermes auf Gemini umzustellen, ändern Sie nur den Modellnamen auf gemini-3.8-flash. Verwenden Sie weiterhin die OmniProxy-Adresse als API-Endpunkt.

Kopieren Sie die Endpunkt-URL und den Schlüssel aus OmniProxy und geben Sie dann die entsprechende Modell-ID ein:

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

Die Basis-URL ist der Endpunkt, an den Hermes Anfragen sendet. Sie muss hier mit /v1 enden. Der API-Schlüssel ist der Schlüssel, den OmniProxy für Hermes ausstellt. Ersetzen Sie den Platzhalter durch Ihren eigenen Wert und veröffentlichen Sie ihn nicht auf einer öffentlichen Seite.

Wenn Ihre lokale OmniProxy-Instanz keinen Schlüssel erfordert, können Sie den API-Schlüssel leer lassen. Wenn die Adresse für andere zugänglich ist, sollten Sie einen Schlüssel verwenden. Bestätigen Sie auch, dass die Adresse von der Umgebung aus erreichbar ist, in der Hermes läuft. Wenn Hermes und OmniProxy auf demselben Computer laufen, können Sie eine lokale Adresse verwenden.

Tool-Konfiguration eingeben

Beenden Sie zuerst den aktuellen Chat und führen Sie dann dies in einem Terminal aus:

hermes model

Wählen Sie Custom endpoint (self-hosted / VLLM / etc.). Ein benutzerdefinierter Endpunkt bedeutet, dass Hermes eine Verbindung zu einer von Ihnen angegebenen Dienstadresse herstellt, anstatt einen voreingestellten Anbieter zu verwenden.

Der Einrichtungsassistent fragt nacheinander nach Endpunkt-URL, Schlüssel und Modellname. Geben Sie die drei Werte aus dem vorherigen Abschnitt ein. Um Gemini zu verwenden, geben Sie gemini-3.8-flash als Modellnamen ein.

Sie können auch ~/.hermes/config.yaml direkt bearbeiten. YAML ist ein Textformat, das Einrückungen verwendet, um Konfigurationsbeziehungen darzustellen. Die folgende Konfiguration verwendet Grok:

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

Um Gemini zu verwenden, ändern Sie default auf gemini-3.8-flash und lassen Sie die anderen drei Werte unverändert:

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

Führen Sie nach dem Speichern hermes erneut aus und starten Sie einen neuen Chat. In einer bereits geöffneten Sitzung /model kann nur zwischen Anbietern gewechselt werden, die bereits gespeichert wurden; diese Konfiguration kann nicht hinzugefügt werden.

Überprüfung mit einer echten Aufgabe

1

hermes doctor

• Installationsprüfung erfolgreich

2

Kurze Nachricht senden

• Antwort von Hermes sehen

3

Anfrageprotokolle öffnen

• Modellnamen verifizieren

1. Führen Sie hermes doctor aus, um zu prüfen, ob die Installation abgeschlossen ist.
2. Führen Sie hermes aus und bitten Sie ihn, in einem Satz zu erklären, was er tun kann. Sie sollten eine Antwort sehen.
3. Öffnen Sie das OmniProxy-Anfrageprotokoll, bestätigen Sie, dass die Anfrage von Hermes kam, und prüfen Sie, ob der Modellname grok-4.7 oder gemini-3.8-flashist.

Zu sehen, dass der Einrichtungsassistent erfolgreich gespeichert hat oder dass die API eine erfolgreiche Antwort zurückgegeben hat, reicht nicht aus, um zu zeigen, dass Hermes Aufgaben für Sie erledigen kann. Der Modellname im Anfrageprotokoll muss mit dem von Ihnen eingegebenen Wert übereinstimmen.

Um im Browser zu chatten, führen Sie lokal Folgendes aus:

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

Öffnen Sie dann http://127.0.0.1:9119. Diese Adresse funktioniert nur auf dem aktuellen Computer.

Häufige Fehler

• Die Eingabe von hermes meldet, dass der Befehl nicht gefunden wurde: Schließen Sie das Terminal und öffnen Sie ein neues Fenster. Wenn der Befehl immer noch nicht gefunden wird, bestätigen Sie, dass ~/.local/bin im PATH ist. PATH ist die Liste der Verzeichnisse, in denen das System nach Befehlen sucht. Bestätigen Sie unter Windows, dass das vom Installer hinzugefügte Startverzeichnis im PATH ist.
• Der Installationsdownload stoppt mittendrin: Führen Sie denselben Installationsbefehl erneut aus. Die bereits heruntergeladenen Teile werden wiederverwendet.
• Hermes antwortet nicht oder meldet, dass er keine Verbindung herstellen kann: Bestätigen Sie, dass OmniProxy läuft, und prüfen Sie, ob die Basis-URL mit /v1endet. Wenn Hermes in Docker läuft, während OmniProxy auf dem Host läuft, verwenden Sie nicht 127.0.0.1 wenn dies nur innerhalb des Containers gültig ist.
• Ein Schlüsselfehler erscheint: Aktualisieren Sie den OmniProxy-Schlüssel und ändern Sie dann api_key in config.yaml. Der xAI- oder Google-Schlüssel gehört in die Anbietereinstellungen von OmniProxy; geben Sie ihn nicht in dieses Hermes-Feld ein.
• Das Modell wird als nicht verfügbar gemeldet: Öffnen Sie die aktuelle Modellliste in OmniProxy und kopieren Sie grok-4.7 oder gemini-3.8-flash exakt so, wie es in der Liste erscheint.
• Hermes antwortet, kann aber keine Aufgaben wie das Lesen von Dateien oder das Ausführen von Befehlen ausführen: Wechseln Sie zu einem anderen Modell in OmniProxy, das über diese Funktionen verfügt, und starten Sie dann eine neue Hermes-Sitzung.
• Das Programm befindet sich auf einem externen Laufwerk und hermes doctor meldet einen Speicherfehler, nachdem das Laufwerk getrennt wurde: Schließen Sie das Laufwerk zuerst wieder an. Lassen Sie Hermes keine separate Konfiguration erstellen, während das Laufwerk getrennt ist.

Referenzen

Für Installationsschritte siehe die Hermes-Installationsdokumentation und Plattformunterstützung. Für die Konfiguration benutzerdefinierter Endpunkte siehe die Hermes-Anbieterdokumentation. Für die Modell-IDs siehe die Grok-Modelldokumentation und Geminis OpenAI-Kompatibilitätsdokumentation.

Der macOS-Installationsprozess wurde am 09.10.2026 mit Hermes Agent v0.21.6 abgeschlossen. grok-4.7 und gemini-3.8-flash waren an diesem Datum die Standard-Modell-IDs in der xAI- und Google-Dokumentation. Verwenden Sie bei der Eingabe der Werte die in OmniProxy angezeigten Namen.

Ersetzen Sie jeden Platzhalter mit Werten aus Ihrer eigenen OmniProxy-Konfiguration. Veröffentlichen Sie niemals einen echten Schlüssel.

Ein gespeicherter HTTP 200 allein beweist keine vollständige Agenten-Kompatibilität. Überprüfen Sie die Quelle und das Modell im Aufrufprotokoll von OmniProxy.

Offizielle Quellen · Hermes ↗