Alle Artikel

Hermes Agent mit Carpe Diem Schlüssel und Katalog-Plugins

·Von Carpe Diem Team — Lumen Labs·4 Min. Lesezeit
tutorielguidetechnicalai
Öllampe, geschlossenes Notizbuch und ein Messingschlüssel auf einem dunklen Holzschreibtisch.

Hermes Agent von Nous Research ist ein Agent im Terminal: er ruft Werkzeuge auf (Dateien, Befehle, Web), behält ein Gedächtnis und spricht mit einer OpenAI-kompatiblen API. Du kannst ihm ein Repository übergeben: er liest den Code, führt die Tests aus, und jede Runde wird wie ein /chat/completions-Aufruf auf Carpe Diem abgerechnet. Am 3. November 2026 hat hermes chat --oneshot mit Hermes 0.22.2 und deepseek-v4-1-flash in 4 Sekunden pong geantwortet.

Öllampe, geschlossenes Notizbuch und ein Messingschlüssel auf einem dunklen Holzschreibtisch.

Illustration erzeugt mit seedream-v5-lite auf Carpe Diem.

Was du brauchst

  • Ein Konto bei Carpe Diem mit Credits oder Prepaid-Guthaben und einen cdm_-Schlüssel (Credits & keys).
  • Hermes Agent 0.22.2 (Installer in Schritt 2).

Wenn du nur ein Python-Skript ohne Agent willst, reicht das OpenAI-Python-SDK-Tutorial. Hier starten wir den Agenten.

Schritt 1: einen cdm_-Schlüssel erstellen

Öffne Credits & keys und den Tab API Keys. Schlüssel beginnen mit cdm_ und werden nur einmal angezeigt: kopiere ihn, bevor du die Seite schließt. Wähle Credits oder Prepaid, optional einen Namen, dann Create a key. Beide Modi belasten denselben Katalog; die Zahlungsdetails stehen im Guide, §4.1.

Tab API Keys: optionaler Name, Credits oder Prepaid, Button Create a key.

Schritt 2: Hermes installieren

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

Getestet haben wir mit Hermes Agent v0.22.2; hermes --version zeigt dir die installierte Version. Eigene Anbieter werden im Abschnitt Custom endpoint der Hermes-Dokumentation beschrieben.

Schritt 3: Hermes auf Carpe Diem umstellen

Hermes legt seine Einstellungen in ~/.hermes/ ab: config.yaml für die Konfiguration, .env für Geheimnisse (Hermes-Konfiguration). Die vier Befehle unten schreiben den Anbieter custom, die URL von Carpe Diem, das Standardmodell und einen Verweis auf die Umgebungsvariable, die den Schlüssel trägt.

hermes config set model.provider custom
hermes config set model.base_url https://carpe-diem.xyz/api/operator/v1
hermes config set model.default deepseek-v4-1-flash
hermes config set model.api_key '${OPENAI_API_KEY}'

Der Schlüssel selbst kommt in ~/.hermes/.env, nie ins yaml:

OPENAI_API_KEY=cdm_your_key_here

custom ist der generische Anbieter von Hermes für eine OpenAI-kompatible API. Die URL muss auf /v1 enden: das ist die Basis-URL von Carpe Diem, und Hermes hängt /chat/completions selbst an. Kopiere die Modellkennung von /models.

Eine Falle: hermes config set model.default hat das yaml geschrieben, aber ein Chat ohne -m hat trotzdem einen leeren Modellnamen gesendet. Übergib -m deshalb immer explizit. Nach den config set-Befehlen sah das yaml (ohne den Schlüssel im Klartext) so aus:

model:
  default: deepseek-v4-1-flash
  provider: custom
  base_url: https://carpe-diem.xyz/api/operator/v1
  api_key: ${OPENAI_API_KEY}

Schritt 4: den ersten Aufruf starten

hermes chat --oneshot --max-turns 1 --safe-mode \
  --provider custom -m deepseek-v4-1-flash \
  -q "Reply with the exact word: pong"

--oneshot antwortet und beendet sich danach, --safe-mode begrenzt die Werkzeuge, die der Agent nutzen kann, und --max-turns 1 bricht nach einer Runde ab. Das ist die vorsichtigste Form, um Schlüssel und URL zu prüfen. Ohne --oneshot öffnet hermes chat eine interaktive Sitzung.

Hier die erhaltene Ausgabe:

Query: Reply with the exact word: pong
Initializing agent...
────────────────────────────────────────
pong
────────────────────────────────────────

Resume this session with:
  hermes --resume 20261103_160550_5ad0d5

Session:        20261103_160550_5ad0d5
Duration:       4s
Messages:       2 (1 user, 0 tool calls)

Die Anfrage ging an https://carpe-diem.xyz/api/operator/v1/chat/completions. Die Zusammenfassung zeigt 0 tool calls: der Agent hat ohne Werkzeug geantwortet. Hermes zeigt den Header X-Carpe-Cost-Usdc-Micro nicht: die Kosten stehen in der Verbrauchsübersicht oder, für ein Skript, im SDK-Tutorial.

Schritt 5: ein Plugin hinzufügen

Der Katalog wird per Name installiert, auf einem gepinnten Commit. Mit --no-enable klont die Installation ohne Aktivierung; hermes plugins enable schaltet danach ein.

hermes plugins browse
hermes plugins install mcp-serve --no-enable --yes-deps
hermes plugins enable mcp-serve

Das Plugin ging von not enabled auf enabled. Hermes hat um ein hermes gateway restart gebeten. Paketidentität:

mcp-serve 1.0.0 6389dd08

Wenn es nicht klappt

401 Unauthorized / AUTH_REQUIRED. Mit OPENAI_API_KEY=cdm_invalid hat Hermes custom rejected your API key angezeigt. Der Schlüssel ist unvollständig oder falsch kopiert, oder .env wurde nicht gelesen: prüfe die Datei und starte den Befehl erneut.

400 INVALID_MODEL. Ohne -m enthielt der Request-Body "model": "" und die API antwortet Invalid model name. Füge -m deepseek-v4-1-flash hinzu.

400 MODEL_ERROR. Mit deepseek-v4-1-flash-typo hat die API This model is no longer available upstream geantwortet. Eine falsch geschriebene Kennung liefert MODEL_ERROR: vergleiche sie mit /models.

Gateway ohne Token. hermes gateway hat Hermes Gateway Starting und dann Press Ctrl+C to stop angezeigt. Ohne TELEGRAM_BOT_TOKEN und ohne DISCORD_BOT_TOKEN ist keine Messaging-Plattform verbunden.

Plugin installiert, aber inaktiv. Wenn du mit --no-enable installiert hast, bleibt das Plugin not enabled bis hermes plugins enable <Name> und dann hermes gateway restart.

Weitergehen

Um mit dem Agenten über Telegram oder Discord zu sprechen, ist das Gateway ein eigener Prozess. Wir haben kein Bot-Token eingefügt, deshalb wurde keine Nachricht ausgetauscht. Zum Einrichten folge den Guides für Telegram und Discord, dann in ~/.hermes/.env:

TELEGRAM_BOT_TOKEN=...
TELEGRAM_ALLOWED_USERS=...

Danach hermes gateway. Ohne Token erscheint das Banner Hermes Gateway Starting und keine Messaging-Plattform ist verbunden.

Sobald du den pong hast, entferne --safe-mode und --max-turns 1, wenn der Agent seine Werkzeuge nutzen soll, und wechsle das Modell nur über -m. Für einen Web-Chat statt eines Agents im Terminal siehe das Tutorial Vercel AI SDK. Zum Vergleichen von Modellen ohne Installation reicht der Create Hub.

Methode: Test am 3. November 2026 mit Hermes 0.22.2. Der pong lief im --safe-mode mit einer Runde. Das Plugin mcp-serve wurde installiert und dann aktiviert. Das Gateway startete ohne Bot-Token. Die Kosten wurden nicht in der Hermes-Oberfläche abgelesen.

Erstelle deinen Schlüssel unter Credits & keys, setze base_url und -m, und starte den pong.