Zum Hauptinhalt springen
Verwenden Sie CometAPI als model-Anbieter für Hermes Agent über die Unterstützung von Hermes für benutzerdefinierte OpenAI-kompatible Endpoints.

​
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 bei der CometAPI-Konsole an. Klicken Sie auf Add API Key und kopieren Sie Ihren <COMETAPI_KEY>-Schlüssel.
CometAPI-Dashboard mit der Schaltfläche „Add API Key“
CometAPI-API-Schlüsseldetails mit angezeigter Base-URL
2

Installieren Sie Hermes Agent

Der folgende Befehl führt das offizielle Installationsprogramm aus:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Wenn die aktuelle Shell den Befehl hermes noch nicht erkennt, laden Sie die Shell-Konfiguration neu:
source ~/.zshrc
# or
source ~/.bashrc
Hermes speichert die Konfiguration in ~/.hermes/, verlinkt den Befehl hermes in ~/.local/bin und fügt ~/.local/bin möglicherweise zum PATH Ihrer Shell hinzu.

​
Konfiguration

1

Speichern Sie Ihren CometAPI-Schlüssel

Öffnen Sie ~/.hermes/.env und fügen Sie die folgende Zeile hinzu:
OPENAI_API_KEY=<COMETAPI_KEY>
Hermes verwendet OPENAI_API_KEY als Auth-Fallback für benutzerdefinierte OpenAI-kompatible Endpoints.
2

Konfigurieren Sie den CometAPI-Endpoint

Öffnen Sie ~/.hermes/config.yaml und stellen Sie sicher, dass der Abschnitt model so aussieht:
model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1
Ersetzen Sie your-model-id durch eine aktuelle text-model ID von der CometAPI-Modelle-Seite.
Behalten Sie den API-Schlüssel in ~/.hermes/.env. Hinterlegen Sie keine Secrets fest in config.yaml.
Diese Einrichtung konfiguriert das Haupt-Chatmodell. Hermes kann für Aufgaben wie Vision oder Web-Extraktion separate Hilfsmodelle verwenden.

​
Verifizierung

1

Überprüfen Sie die Konfiguration

Die folgenden Befehle bestätigen, dass Hermes die Konfiguration und den API-Schlüssel lesen kann:
hermes config check
hermes doctor
hermes status
Wenn hermes config check nach einem Update fehlende Optionen meldet, führen Sie hermes config migrate aus und prüfen Sie dann erneut.
2

Führen Sie einen echten Chat-Test aus

Der folgende Befehl sendet eine echte Anfrage über CometAPI:
hermes chat -q "Reply with the single word CONNECTED."
Eine erfolgreiche Einrichtung gibt CONNECTED zurück und erzeugt keine Auth- oder Endpoint-Fehler.

​
Optionale Konfiguration

Wenn Sie eine ältere Hermes-Installation ersetzen, verwenden Sie zuerst das integrierte Deinstallationsprogramm:
hermes uninstall
Wählen Sie im Deinstallationsprogramm Full uninstall, um die CLI, den PATH-Eintrag und die Daten in ~/.hermes/ zu entfernen. Führen Sie dann den Installationsschritt erneut aus und fahren Sie mit derselben CometAPI-Konfiguration fort.
Wenn Sie den interaktiven Ablauf bevorzugen, führen Sie hermes model aus und wählen Sie Custom endpoint.Geben Sie dann die folgenden Werte ein:
  • Base URL: https://api.cometapi.com/v1
  • API key: Ihr CometAPI API-Schlüssel
  • Model: eine aktuelle CometAPI-text-model ID
Dieser Ablauf schreibt dieselben provider-Einstellungen in config.yaml.