Skip to main content
Verwenden Sie CometAPI als model-Anbieter für Hermes Agent. Hermes unterstützt in dieser Anleitung zwei CometAPI-Wege: einen allgemeinen OpenAI-kompatiblen Endpunkt für die meisten Textmodelle und eine Claude-Route über Anthropic Messages.

​
Voraussetzungen

  • Git
  • Ein CometAPI-Konto mit einem aktiven API-Schlüssel
  • Ein Terminal unter macOS, Linux oder WSL2

​
Installation

1

Holen Sie sich Ihren CometAPI API-Schlüssel

Melden Sie sich in der CometAPI-Konsole an. Klicken Sie auf Add API Key und kopieren Sie Ihren CometAPI API-Schlüssel.
CometAPI-Dashboard mit der Schaltfläche „Add API Key“
CometAPI-API-Schlüsseldetails mit angezeigter Basis-URL
2

Hermes Agent installieren

Der folgende Befehl führt das offizielle Installationsprogramm aus:
Wenn die aktuelle Shell den Befehl hermes noch nicht erkennt, laden Sie die Shell-Konfiguration neu:
Hermes speichert die Konfiguration in ~/.hermes/, verlinkt den Befehl hermes in ~/.local/bin und fügt möglicherweise ~/.local/bin zu Ihrem Shell-PATH hinzu.

​
Konfiguration

Wählen Sie die CometAPI-Route, die zur Modellfamilie passt:
Konfigurieren Sie Hermes nicht mit https://api.cometapi.com/v1beta als benutzerdefiniertem Gemini-nativen provider. Verwenden Sie für Gemini-Modelle die OpenAI-kompatible Hermes-Konfiguration. Für direkte Gemini-API-Aufrufe verwenden Sie die Gemini generateContent API.
1

Speichern Sie Ihren CometAPI-Schlüssel

Öffnen Sie ~/.hermes/.env und fügen Sie die folgenden Werte hinzu:
COMETAPI_KEY wird vom benannten Claude-provider verwendet. OPENAI_API_KEY sorgt dafür, dass Hermes’ Fallback für benutzerdefinierte OpenAI-kompatible Endpunkte funktioniert.
2

Konfigurieren Sie die OpenAI-kompatible Route

Verwenden Sie diese Route für die meisten CometAPI-Textmodelle, einschließlich Gemini-Modelle, die aus Hermes heraus verwendet werden. Öffnen Sie ~/.hermes/config.yaml und stellen Sie sicher, dass der Abschnitt model so aussieht:
Ersetzen Sie your-model-id durch eine aktuelle Textmodell-ID von der CometAPI Models page.
Belassen Sie den API-Schlüssel in ~/.hermes/.env. Hinterlegen Sie keine Secrets direkt in config.yaml.
Diese Einrichtung konfiguriert das primäre Chat-Modell. Hermes kann separate Hilfsmodelle für Aufgaben wie Vision oder Web-Extraktion verwenden.
3

Konfigurieren Sie die Claude Messages-Route

Verwenden Sie diese Route, wenn Hermes Claude-Modelle über Anthropic Messages aufrufen soll. Öffnen Sie ~/.hermes/config.yaml und verwenden Sie einen benannten provider:
Ersetzen Sie your-claude-model-id durch eine aktuelle Claude-Modell-ID von der CometAPI Models page.
Belassen Sie base_url für diese Route bei https://api.cometapi.com. Hermes verwendet den Anthropic Messages-Transport des benannten providers.

​
Verifizierung

1

Überprüfen Sie die Konfiguration

Der folgende Befehl bestätigt, dass Hermes die Konfiguration und den API-Schlüssel lesen kann:
Wenn hermes config check nach einem Update fehlende Optionen meldet, führen Sie hermes config migrate aus und prüfen Sie erneut.
2

Führen Sie einen echten Chat-Test aus

Der folgende Befehl sendet eine echte Anfrage über CometAPI:
Eine erfolgreiche Einrichtung gibt CONNECTED zurück und zeigt keine Authentifizierungs- oder Endpunktfehler. Wenn die Claude Messages-Konfiguration aktiv ist, bestätigt dies, dass Hermes den anthropic_messages-Transport über CometAPI verwenden kann.

​
Optionale Konfiguration

Wenn du eine ältere Hermes-Installation ersetzt, verwende zuerst das integrierte Deinstallationsprogramm:
Wähle im Deinstallationsprogramm Full uninstall, um die CLI, den PATH-Eintrag und die Daten in ~/.hermes/ zu entfernen. Führe dann den Installationsschritt erneut aus und fahre mit derselben CometAPI-Konfiguration fort.
Wenn du den interaktiven Ablauf für die OpenAI-kompatible Route bevorzugst, führe hermes model aus und wähle Custom endpoint.Gib dann die folgenden Werte ein:
  • Base URL: https://api.cometapi.com/v1
  • API key: dein CometAPI API key
  • Model: eine aktuelle CometAPI-Text-model ID
Dieser Ablauf schreibt die OpenAI-kompatiblen Provider-Einstellungen in config.yaml. Für Claude Messages bearbeite config.yaml direkt, damit der benannte Provider transport: anthropic_messages beibehält.