hermes auth Befehl — Vollständige Referenz & Beispiele

Überblick

hermes auth verwaltet gepoolte Zugangsdaten für LLM- und Service-Anbieter. Pro Anbieter können mehrere Zugangsdaten gespeichert werden, damit Hermes bei Rate-Limits automatisch rotieren kann.

hermes auth <Unterbefehl>

Unterbefehle

add <Anbieter>

Eine Zugangsdaten zum Pool hinzufügen.

hermes auth add openrouter
hermes auth add openrouter --api-key $OPENROUTER_API_KEY
hermes auth add anthropic --type oauth
hermes auth add nous --type oauth --label team-key

Flags:

• --type {oauth,api-key} — Zugangsdatentyp.
• --label LABEL — Optionale Anzeigebezeichnung.
• --api-key API_KEY — API-Schlüsselwert (ansonsten sicher abfragen).
• --portal-url, --inference-url — Nous Portal-/Inference-Base-URLs.
• --client-id CLIENT_ID — OAuth-Client-ID.
• --scope SCOPE — OAuth-Scope-Überschreibung.
• --no-browser — Browser für OAuth-Login nicht automatisch öffnen.
• --timeout TIMEOUT — OAuth/Netzwerk-Timeout in Sekunden.
• --insecure — TLS-Verifizierung für OAuth deaktivieren.
• --ca-bundle CA_BUNDLE — Benutzerdefiniertes CA-Bundle für OAuth.

list [Anbieter]

Gepoolte Zugangsdaten auflisten.

hermes auth list
hermes auth list openrouter

remove <Anbieter> <Ziel>

Eine Zugangsdaten per Index, Eintrags-ID oder exakter Bezeichnung entfernen.

hermes auth remove openrouter 1

reset <Anbieter>

Erschöpfungsstatus für alle Zugangsdaten eines Anbieters löschen.

hermes auth reset openrouter

status <Anbieter>

Authentifizierungsstatus eines Anbieters anzeigen.

hermes auth status anthropic

logout <Anbieter>

Bei einem Anbieter abmelden und gespeicherten Auth-Status löschen.

hermes auth logout anthropic

spotify [login|status|logout]

Hermes über PKCE bei Spotify authentifizieren.

hermes auth spotify login
hermes auth spotify status
hermes auth spotify logout

Flags:

• --client-id CLIENT_ID — Spotify-App-Client-ID (oder HERMES_SPOTIFY_CLIENT_ID).
• --redirect-uri REDIRECT_URI — Erlaubte localhost-Redirect-URI.
• --scope SCOPE — Angeforderte Spotify-Scopes überschreiben.
• --no-browser — Browser nicht automatisch öffnen.
• --timeout TIMEOUT — Callback-/Token-Exchange-Timeout in Sekunden.

Häufige Szenarien

# API-Key aus Umgebungsvariable hinzufügen
hermes auth add openrouter --api-key $OPENROUTER_API_KEY

# Mehrere Schlüssel zur Rotation hinzufügen
hermes auth add openrouter --api-key $KEY1 --label key-1
hermes auth add openrouter --api-key $KEY2 --label key-2
hermes auth add openrouter --api-key $KEY3 --label key-3

# OAuth-Anbieter hinzufügen
hermes auth add anthropic --type oauth

# Status prüfen und nach Rate-Limits zurücksetzen
hermes auth status openrouter
hermes auth reset openrouter

# Zugangsdaten auflisten und entfernen
hermes auth list openrouter
hermes auth remove openrouter 1

Tipps

• Füge 3–5 Schlüssel für Anbieter mit hohem Durchsatz hinzu, damit Hermes bei Rate-Limits rotieren kann.
• --api-key liest sicher aus der Umgebung; bei Weglassen erfolgt eine sichere Eingabeaufforderung.
• hermes auth reset löscht den Erschöpfungsstatus, aber nicht die Zugangsdaten.
• Spotify nutzt PKCE; setze HERMES_SPOTIFY_CLIENT_ID, um --client-id nicht jedes Mal angeben zu müssen.