Comando hermes proxy — Referência Completa e Exemplos

Visão Geral

hermes proxy executa um servidor HTTP local que encaminha requisições compatíveis com OpenAI para um provedor autenticado via OAuth. Aplicativos externos podem apontar para o proxy com qualquer token Bearer; o proxy anexa suas credenciais reais do Hermes, permitindo que qualquer cliente compatível com OpenAI use o Hermes como backend.

hermes proxy <start|status|providers>

Subcomandos

start — Executar o proxy em primeiro 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 quais provedores upstream estão prontos

hermes proxy status

Exibe o estado de prontidão dos provedores configurados, para que você saiba se o proxy pode atender requisições antes de conectar um cliente.

providers — Listar provedores disponíveis

hermes proxy providers

Exibe os provedores que o proxy pode usar (atualmente nous e xai).

Cenários Comuns

Usar Hermes a partir de outra ferramenta compatível com OpenAI

hermes proxy start --port 8080
# Na outra ferramenta:
#   API base: http://localhost:8080/v1
#   API key:  qualquer valor (o proxy gerencia a autenticação)

Expor o proxy na LAN

hermes proxy start --host 0.0.0.0 --port 8645

Trocar de provedor upstream

hermes proxy providers
hermes proxy start --provider xai

Testar o proxy com curl

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

Dicas

• O proxy escuta localmente por padrão (127.0.0.1) e não expõe nada à internet, a menos que você altere --host.
• Qualquer valor de API key funciona no cliente; o proxy usa suas credenciais OAuth reais do Hermes.
• O proxy deve rodar em primeiro plano; inicie-o em um terminal dedicado ou sob um gerenciador de processos para uso prolongado.
• Use hermes proxy status para verificar se o provedor upstream está pronto antes de conectar um cliente.