docs
Agenten im Terminal

Hermes Agent

Markdown

Terminalagent · OpenAI Chat, OpenAI Responses, Anthropic Messages

Vollständiger Leitfaden
FormatKonfigurationsort
OpenAI Chat, OpenAI Responses, Anthropic Messageshermes model → «Custom endpoint (self-hosted / VLLM / etc.)» oder ~/.hermes/config.yaml (Abschnitt model oder Wörterbuch providers)

Konfiguration

Kopieren Sie die Konfiguration und ersetzen Sie sk-... durch Ihren Schlüssel aus dem Ailoot-Kundenbereich. Speichern Sie den Schlüssel möglichst in der Umgebungsvariablen AILOOT_API_KEY, sofern die Anwendung dies unterstützt.

Rufen Sie vor dem Start GET /v1/models mit Ihrem Ailoot-Schlüssel ab. Wählen Sie eine genaue Modell-ID mit den Methoden POST /v1/chat/completions, POST /v1/responses, POST /v1/messages und tragen Sie diese ID in die Konfiguration ein. Prüfen Sie bei Agenten auch die Werkzeugunterstützung und die für Ihre Clientversion benötigten Funktionen.

~/.hermes/config.yaml

model:
  default: claude-sonnet-5-5
  provider: custom
  base_url: https://api.ailoot.ai/v1
  key_env: AILOOT_API_KEY

# mehrere Formate gleichzeitig — benannte Provider:
providers:
  ailoot:
    api: https://api.ailoot.ai/v1
    key_env: AILOOT_API_KEY
    transport: chat_completions
    default_model: gpt-6.1-sol
  ailoot-claude:
    api: https://api.ailoot.ai
    key_env: AILOOT_API_KEY
    transport: anthropic_messages
    default_model: claude-sonnet-5-5

# in der Sitzung: /model custom:claude-sonnet-5-5

Diese Konfiguration liest den Schlüssel aus der Variablen AILOOT_API_KEY. Setzen Sie sie vor dem Start der Anwendung:

export AILOOT_API_KEY="sk-..."   # in ~/.zshrc oder ~/.bashrc eintragen

Beispielmodell: claude-sonnet-5-5. Weitere Modelle finden Sie im Katalog — prüfen Sie, ob das benötigte Format verfügbar ist.

Gut zu wissen

Prüfung

  • Für das OpenAI-Format lautet die Adresse https://api.ailoot.ai/v1 (oder der vollständige Pfad, falls die Anwendung eine vollständige Adresse verlangt).
  • Für das Anthropic-Format lautet die Adresse https://api.ailoot.ai ohne /v1.
  • Stellen Sie eine kurze Frage. Bei einem Fehler prüfen Sie Code und Request ID und vergleichen Sie sie mit der Seite Fehler und Limits.
  • 404 direkt nach der Einrichtung bedeutet fast immer eine falsche Adresse: Ein überflüssiges oder fehlendes /v1.
  • 402 — Guthaben reicht nicht für die Reservierung. Agenten reservieren mehr als ein Chat: warum.

Dokumentation der Anwendung: https://hermes-agent.nousresearch.com/docs/integrations/providers

Noch Fragen? Schicken Sie uns die Request ID und eine Beschreibung — wir helfen Ihnen weiter.Support kontaktieren