Comando hermes proxy — Referencia Completa y Ejemplos

Descripción General

hermes proxy ejecuta un servidor HTTP local que reenvía peticiones compatibles con OpenAI a un proveedor autenticado con OAuth. Las aplicaciones externas pueden apuntar al proxy con cualquier token de portador; el proxy adjunta tus credenciales reales de Hermes, de modo que cualquier cliente compatible con OpenAI puede usar Hermes como backend directo.

hermes proxy <start|status|providers>

Subcomandos

start — Ejecutar el proxy en primer plano

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

status — Mostrar qué proveedores upstream están listos

hermes proxy status

Muestra el estado de disponibilidad de los proveedores configurados para saber si el proxy puede atender peticiones antes de conectar un cliente.

providers — Listar proveedores disponibles

hermes proxy providers

Muestra los proveedores que el proxy puede usar (actualmente nous y xai).

Escenarios Comunes

Usar Hermes desde otra herramienta compatible con OpenAI

hermes proxy start --port 8080
# En la otra herramienta:
#   API base: http://localhost:8080/v1
#   API key:  cualquier valor (el proxy gestiona la autenticación)

Exponer el proxy en la LAN

hermes proxy start --host 0.0.0.0 --port 8645

Cambiar de proveedor upstream

hermes proxy providers
hermes proxy start --provider xai

Probar el proxy con curl

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

Consejos

• El proxy escucha localmente por defecto (127.0.0.1) y no expone nada a internet a menos que cambies --host.
• Cualquier valor de API key funciona en el cliente; el proxy utiliza tus credenciales OAuth reales de Hermes.
• El proxy debe ejecutarse en primer plano; inícialo en una terminal dedicada o bajo un gestor de procesos para uso prolongado.
• Usa hermes proxy status para verificar que el proveedor upstream esté listo antes de conectar un cliente.