Commande hermes proxy — Référence Complète & Exemples

Vue d’ensemble

hermes proxy exécute un serveur HTTP local qui transmet les requêtes compatibles OpenAI à un fournisseur authentifié par OAuth. Les applications externes peuvent pointer vers le proxy avec n’importe quel jeton Bearer ; le proxy attache vos véritables identifiants Hermes, permettant à tout client compatible OpenAI d’utiliser Hermes comme backend.

hermes proxy <start|status|providers>

Sous-commandes

start — Lancer le proxy au premier plan

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

status — Afficher l’état de préparation des fournisseurs upstream

hermes proxy status

Affiche l’état de disponibilité des fournisseurs configurés pour savoir si le proxy peut servir des requêtes avant de connecter un client.

providers — Lister les fournisseurs disponibles

hermes proxy providers

Affiche les fournisseurs utilisables par le proxy (actuellement nous et xai).

Scénarios courants

Utiliser Hermes depuis un autre client compatible OpenAI

hermes proxy start --port 8080
# Dans l'autre outil :
#   API base : http://localhost:8080/v1
#   API key :  n'importe quelle valeur (le proxy gère l'authentification)

Exposer le proxy sur le LAN

hermes proxy start --host 0.0.0.0 --port 8645

Changer de fournisseur upstream

hermes proxy providers
hermes proxy start --provider xai

Tester le proxy avec curl

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

Astuces

• Par défaut, le proxy écoute en local (127.0.0.1) et n’expose rien sur internet, sauf si vous modifiez --host.
• N’importe quelle valeur d’API key fonctionne côté client ; le proxy utilise vos véritables identifiants OAuth Hermes.
• Le proxy doit tourner au premier plan ; démarrez-le dans un terminal dédié ou sous un gestionnaire de processus pour un usage prolongé.
• Utilisez hermes proxy status pour vérifier que l’upstream est prêt avant de connecter un client.