Hermes Agent

​

Überblick

​

Voraussetzungen

​

1. System- und Modellanforderungen

• Terminal-Umgebung: Hermes Agent läuft in der Kommandozeile von macOS, Linux und Windows (nativ oder WSL2).
• Anforderungen an den Modellkontext: Für Hermes Agent wird ein Modell mit einer Kontextlänge von mindestens 64K (64.000) Tokens empfohlen. Da der System-Prompt und die Werkzeugdefinitionen selbst bereits viel Kontext beanspruchen, kann ein zu kleines Fenster gefüllt werden, ohne Platz für die Unterhaltung zu lassen, sodass der Start abgelehnt wird. Falls kontextbezogene Fehler auftreten, wechseln Sie einfach zu einem Modell mit größerem Kontext (die Claude- und Gemini-Serien von EvoLink erfüllen diese Anforderung).

​

2. EvoLink API-Schlüssel erhalten

• Melden Sie sich beim EvoLink Dashboard an
• Suchen Sie im Dashboard nach API Keys, klicken Sie auf die Schaltfläche „Neuen Schlüssel erstellen” und kopieren Sie den generierten Schlüssel
• Der API-Schlüssel beginnt normalerweise mit sk-; bewahren Sie ihn sicher auf

​

Schritt 1: Hermes Agent installieren

• macOS / Linux
• Windows

Führen Sie das Installationsskript im Terminal aus:

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

Laden Sie nach Abschluss der Installation die Terminal-Konfiguration neu, damit der Befehl wirksam wird:

source ~/.zshrc   # oder source ~/.bashrc

Erster Start: Installationsmethode wählen (Quick oder Full)Beim ersten Ausführen von hermes startet der interaktive Installationsassistent. Zuerst werden Sie gefragt, wie Sie Hermes einrichten möchten:

• Quick Setup (Nous Portal) – Anmeldung über das kostenlose Nous OAuth, ohne API-Schlüssel, mit automatischer Konfiguration von Modellen und Werkzeugen für den schnellsten Einstieg. Standardmäßig werden jedoch die Modelle des Nous Portals verwendet und nicht EvoLink; um EvoLink anzubinden, müssen Sie nach Abschluss der Installation separat hermes model ausführen (siehe Schritt 2).
• Full setup – Sie konfigurieren Anbieter, Werkzeuge und Optionen selbst Punkt für Punkt (mit Ihrem eigenen Schlüssel). Für Benutzer, die EvoLink direkt anbinden möchten, wird diese Option empfohlen, da Sie die EvoLink-Schnittstellenadresse und den Schlüssel bereits während der Installation in einem Schritt eingeben können.

Im Folgenden werden einige wichtige Schritte zur Anbindung von EvoLink über Full setup gezeigt:

1

Full setup wählen

Wählen Sie mit den Pfeiltasten Full setup — configure every provider, tool & option yourself (bring your own keys) aus und bestätigen Sie mit der Eingabetaste.

2

Anbieter wählen: Custom endpoint

Suchen Sie in der Anbieterliste weiter unten nach custom endpoint (enter URL manually) und wählen Sie es aus. Da EvoLink eine OpenAI-kompatible Schnittstelle bereitstellt, erfolgt die Anbindung hier über einen „benutzerdefinierten Endpunkt”.

3

EvoLink-Schnittstellenadresse und API-Schlüssel eingeben

Der Assistent fordert Sie nacheinander zur Eingabe der Endpunktinformationen auf:

• API base URL eingeben: https://direct.evolink.ai/v1
• API key mit Ihrem EvoLink API-Schlüssel (beginnt mit sk-) ausfüllen

Nach der Eingabe überprüft der Assistent den Endpunkt automatisch. Wenn Sie eine Meldung wie Verified endpoint via https://direct.evolink.ai/v1/models (154 model(s) visible) sehen, ist die Schnittstelle verbunden und der Schlüssel gültig. Folgen Sie anschließend den Hinweisen, um das Standardmodell und die Werkzeuge auszuwählen.

Erwartetes Ergebnis: Nach Abschluss des Assistenten wird die Seite Installation Complete (Installation abgeschlossen) angezeigt, die den Speicherort der Konfigurationsdateien und gängige Befehle auflistet.

WSL2- sowie Android-Umgebungen (Termux) verwenden ebenfalls das obige install.sh-Skript zur Installation.

Führen Sie den Installationsbefehl in PowerShell aus:

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

Erwartetes Ergebnis: Sie sehen Download- und Installationsinformationen und am Ende einen Hinweis auf die erfolgreiche Installation.Falls ein Fehler auftritt: Wenn eine Einschränkung der Ausführungsrichtlinie gemeldet wird, öffnen Sie PowerShell als Administrator oder führen Sie zuerst Set-ExecutionPolicy -Scope CurrentUser RemoteSigned aus und versuchen Sie es erneut.Beim ersten Ausführen von hermes nach der Installation startet ebenfalls der Quick / Full Installationsassistent. Die Schritte zur Anbindung von EvoLink sind identisch mit dem Tab macOS / Linux (es wird empfohlen, Full setup zu wählen und die EvoLink-Schnittstellenadresse und den Schlüssel im Assistenten einzugeben).

macOS- und Windows-Benutzer können auch von der Hermes-Website das Desktop-Installationspaket Hermes Desktop herunterladen und durch Doppelklick installieren.

​

Installation überprüfen

hermes doctor

​

Schritt 2: EvoLink API konfigurieren (Quick-Benutzer oder Neukonfiguration)

• ~/.hermes/.env – speichert Schlüssel wie den API-Schlüssel
• ~/.hermes/config.yaml – speichert Nicht-Schlüssel-Konfigurationen wie Modell und Anbieter

• Einrichtungsassistent (empfohlen)
• Konfiguration über die Befehlszeile
• Konfigurationsdateien manuell bearbeiten

Hermes bietet einen interaktiven Einrichtungsassistenten, der sich für neue Benutzer eignet (insbesondere für Benutzer, die Quick Setup gewählt haben). Führen Sie im Terminal aus:

hermes model

1

Anbieter wählen: Custom endpoint

Suchen Sie in der Anbieterliste weiter unten nach custom endpoint (enter URL manually) und wählen Sie es aus, um den OpenAI-kompatiblen Endpunkt von EvoLink anzubinden.

2

Schnittstellenadresse, Schlüssel eingeben und Kompatibilitätsmodus wählen

Geben Sie nacheinander die Endpunktinformationen ein und wählen Sie nach erfolgreicher Prüfung den API-Kompatibilitätsmodus:

• API base URL eingeben: https://direct.evolink.ai/v1
• API key mit Ihrem EvoLink API-Schlüssel (beginnt mit sk-) ausfüllen
• API compatibility mode auf Chat Completions (standard OpenAI-compatible endpoints) setzen

Wenn Sie eine Meldung wie Verified endpoint via https://direct.evolink.ai/v1/models (163 model(s) visible) sehen, ist die Schnittstelle verbunden und der Schlüssel gültig.

3

Standardmodell wählen

Geben Sie zuletzt den Namen des Modells ein, das als Standardmodell dienen soll (z. B. claude-sonnet-4-6, claude-opus-4-8 usw.), und bestätigen Sie mit der Eingabetaste.

Der Assistent schreibt den API-Schlüssel automatisch in ~/.hermes/.env und die Modell- und Endpunktkonfiguration in ~/.hermes/config.yaml, ohne dass Sie die Dateien manuell bearbeiten müssen.

hermes model ist der wichtigste Schritt für Quick-Benutzer, um EvoLink anzubinden. Nach Abschluss können Sie direkt zum nächsten Schritt übergehen und mit der Nutzung beginnen.

Wenn Sie bereits einen EvoLink API-Schlüssel haben, können Sie die Konfiguration direkt über die Befehlszeile schreiben.

​

1. API-Schlüssel setzen (in .env schreiben)

hermes config set OPENAI_API_KEY Ihr_EvoLink_API_Key

​

2. Schnittstellenadresse und Modell setzen (in config.yaml schreiben)

hermes config set OPENAI_BASE_URL https://direct.evolink.ai/v1
hermes config set model claude-sonnet-4-6

hermes config set schreibt Schlüssel wie den API-Schlüssel automatisch in .env und die übrigen Konfigurationen in config.yaml. Sie müssen sich nicht darum kümmern, in welche Datei geschrieben wird.

Nach Abschluss können Sie hermes config ausführen, um zu prüfen, ob die aktuelle Konfiguration korrekt ist.

Fortgeschrittene Benutzer: Bei der folgenden Methode werden die Konfigurationsdateien direkt bearbeitet. Den meisten Benutzern wird der obige „Einrichtungsassistent” empfohlen.

​

1. ~/.hermes/.env bearbeiten

Öffnen (oder erstellen) Sie ~/.hermes/.env und tragen Sie API-Schlüssel und Schnittstellenadresse ein:

OPENAI_API_KEY=Ihr_EvoLink_API_Key
OPENAI_BASE_URL=https://direct.evolink.ai/v1

​

2. ~/.hermes/config.yaml bearbeiten

Öffnen (oder erstellen) Sie ~/.hermes/config.yaml und konfigurieren Sie das Hauptmodell als benutzerdefinierten Endpunkt:

model:
  provider: custom
  default: claude-sonnet-4-6
  base_url: https://direct.evolink.ai/v1
  api_mode: chat_completions

⚠️ Wichtige Hinweise:

• Ersetzen Sie Ihr_EvoLink_API_Key durch Ihren tatsächlichen API-Schlüssel
• base_url muss https://direct.evolink.ai/v1 lauten (die OpenAI-kompatible Schnittstellenadresse von EvoLink)
• Geben Sie keine Satzzeichen über eine chinesische Eingabemethode ein (z. B. den chinesischen Doppelpunkt ：)

Erläuterung der Konfigurationsoptionen:

• provider: custom: Verwendung eines benutzerdefinierten OpenAI-kompatiblen Endpunkts (also EvoLink)
• base_url: Die EvoLink API-Schnittstellenadresse
• api_mode: chat_completions: Verwendung der standardmäßigen Chat-Completions-Schnittstelle
• default: Der Name des standardmäßig verwendeten Modells

​

Schritt 3: Verwenden und überprüfen

​

1. Hermes Agent starten

hermes          # klassischer Kommandozeilenmodus

hermes --tui    # moderne Terminal-Oberfläche

​

2. Konfiguration überprüfen

Wer bist du

• Sie sehen die Antwort der KI (einige Zeilen Text)
• Es treten keine Fehler wie 401, 403, ungültiger API key oder context length (Kontextlänge) auf

• 401 Unauthorized: API-Schlüssel nicht gesetzt oder ungültig → prüfen Sie OPENAI_API_KEY in ~/.hermes/.env
• 403 Forbidden: API-Schlüssel hat unzureichende Berechtigungen oder ist abgelaufen → prüfen Sie den API-Schlüssel
• Fehler im Zusammenhang mit context length: Der Kontext des gewählten Modells beträgt weniger als 64K → wechseln Sie zu einem Modell, das die Anforderung erfüllt
• No API key / provider not found: Kein Schlüssel gefunden → führen Sie hermes config set OPENAI_API_KEY ... erneut aus

​

3. Frühere Sitzung wiederherstellen

hermes --continue    # die letzte Sitzung wiederherstellen
hermes -c            # Kurzform

​

Erweiterte Konfiguration (optional)

​

Ersatzmodell (Fallback)

fallback_providers:
  - provider: custom
    model: claude-sonnet-4-6
    base_url: https://direct.evolink.ai/v1
  - provider: custom
    model: claude-haiku-4-5-20251001
    base_url: https://direct.evolink.ai/v1

​

Hilfsmodell (Auxiliary)

auxiliary:
  title_generation:
    provider: custom
    model: claude-haiku-4-5-20251001
    base_url: https://direct.evolink.ai/v1
    api_key: Ihr_EvoLink_API_Key
  compression:
    provider: custom
    model: claude-haiku-4-5-20251001
    base_url: https://direct.evolink.ai/v1
    api_key: Ihr_EvoLink_API_Key

​

FAQ

​

1. Was ist Hermes Agent und wofür wird er hauptsächlich verwendet?

​

2. Sind Hermes Agent und die Hermes 3 / Hermes 4 Modelle dasselbe?

​

3. Warum sollte man provider: custom verwenden, um EvoLink anzubinden?

​

4. Was tun, wenn beim Start eine unzureichende Kontextlänge (context length) gemeldet wird?

​

5. Was sind die üblichen Ursachen für 401 / 403 Fehler?

• 401-Fehler: OPENAI_API_KEY nicht gesetzt oder API-Schlüssel ungültig
• 403-Fehler: API-Schlüssel hat unzureichende Berechtigungen oder ist abgelaufen
• Prüfen Sie den Schlüssel in ~/.hermes/.env sowie ob base_url https://direct.evolink.ai/v1 lautet

​

6. Warum werden meine Konfigurationsänderungen nicht wirksam?

• Stellen Sie sicher, dass die Konfiguration in die richtige Datei geschrieben wurde: der API-Schlüssel in ~/.hermes/.env, Modell/Endpunkt in ~/.hermes/config.yaml
• Sie können hermes config ausführen, um die aktuell wirksame Konfiguration anzuzeigen
• Prüfen Sie, ob Einrückung und Syntax von config.yaml korrekt sind (YAML reagiert empfindlich auf Einrückungen)
• Starten Sie Hermes neu

​

7. Wie wechsle ich das Modell?

• Interaktiv: führen Sie hermes model aus, um neu auszuwählen
• Befehlszeile: führen Sie hermes config set model Modellname aus
• Bearbeiten Sie den Wert von model.default in ~/.hermes/config.yaml direkt

​

8. Welche gängigen Modelle unterstützt EvoLink?

​

9. Wie sehe ich meinen Verbrauch ein?

​

10. Wo befinden sich die Konfigurationsdatei und die Schlüsseldatei jeweils?

• Schlüssel (API Key): ~/.hermes/.env
• Modell- und Anbieterkonfiguration: ~/.hermes/config.yaml
• Sie können hermes config edit ausführen, um die Konfigurationsdatei direkt zur Bearbeitung zu öffnen.

​

11. Wie öffne ich ein Kommandozeilen-Terminal?

​

Hinweise