hermes proxy Befehl — Vollständige Referenz & Beispiele

Überblick

hermes proxy startet einen lokalen HTTP-Server, der OpenAI-kompatible Anfragen an einen OAuth-authentifizierten Provider weiterleitet. Externe Apps können sich mit einem beliebigen Bearer-Token am Proxy anmelden; der Proxy hängt deine echten Hermes-Zugangsdaten an, sodass jeder OpenAI-kompatible Client Hermes als Drop-in-Backend nutzen kann.

hermes proxy <start|status|providers>

Unterbefehle

`start` — Proxy im Vordergrund ausführen

hermes proxy start
hermes proxy start --provider nous --host 127.0.0.1 --port 8645
hermes proxy start --provider xai --port 9090

Flag	Beschreibung
`--provider PROVIDER`	Upstream-Provider: `nous` oder `xai` (Standard: `nous`). Siehe `hermes proxy providers`.
`--host HOST`	Bind-Adresse (Standard: `127.0.0.1`). `0.0.0.0` exponiert den Proxy im LAN.
`--port PORT`	Bind-Port (Standard: `8645`).

`status` — Anzeigen, welche Upstreams bereit sind

hermes proxy status

Zeigt den Bereitschaftsstatus der konfigurierten Upstream-Provider, damit du vor dem Verbinden eines Clients weißt, ob der Proxy Anfragen bedienen kann.

`providers` — Verfügbare Upstream-Provider auflisten

hermes proxy providers

Zeigt die Provider, die der Proxy nutzen kann (derzeit nous und xai).

Häufige Szenarien

Hermes in einem anderen OpenAI-kompatiblen Tool nutzen

hermes proxy start --port 8080
# Im anderen Tool:
#   API-Base: http://localhost:8080/v1
#   API-Key:  beliebiger Wert (der Proxy übernimmt die Authentifizierung)

Proxy im LAN verfügbar machen

hermes proxy start --host 0.0.0.0 --port 8645

Upstream-Provider wechseln

hermes proxy providers
hermes proxy start --provider xai

Proxy mit curl testen

hermes proxy start --port 8645 &
curl http://localhost:8645/v1/models

Tipps

Der Proxy lauscht standardmäßig lokal (127.0.0.1) und stellt nichts ins Internet, solange du --host nicht änderst.
Jeder beliebige API-Key-Wert funktioniert im Client; der Proxy verwendet deine echten Hermes-OAuth-Zugangsdaten.
Der Proxy muss im Vordergrund laufen; starte ihn für Dauerbetrieb in einem eigenen Terminal oder unter einem Prozessmanager.
Prüfe mit hermes proxy status, ob der Upstream bereit ist, bevor du einen Client verbindest.