Comando hermes auth — Referência Completa e Exemplos

Visão Geral

hermes auth gerencia credenciais em pool para provedores LLM e de serviços. Várias credenciais podem ser armazenadas por provedor para que o Hermes rotacione chaves quando uma atingir o limite de taxa.

hermes auth <subcomando>

Subcomandos

add <provedor>

Adicionar uma credencial ao pool.

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} — Tipo de credencial.
• --label LABEL — Rótulo de exibição opcional.
• --api-key API_KEY — Valor da chave de API (caso omitido, solicita de forma segura).
• --portal-url, --inference-url — URLs base do portal/inferência Nous.
• --client-id CLIENT_ID — Id de cliente OAuth.
• --scope SCOPE — Sobrescrita do scope OAuth.
• --no-browser — Não abrir o navegador automaticamente para OAuth.
• --timeout TIMEOUT — Timeout de OAuth/rede em segundos.
• --insecure — Desativar verificação TLS para OAuth.
• --ca-bundle CA_BUNDLE — Bundle CA personalizado para OAuth.

list [provedor]

Listar credenciais em pool.

hermes auth list
hermes auth list openrouter

remove <provedor> <alvo>

Remover uma credencial por índice, id ou rótulo exato.

hermes auth remove openrouter 1

reset <provedor>

Limpar o estado de exaustão de todas as credenciais de um provedor.

hermes auth reset openrouter

status <provedor>

Mostrar o status de autenticação de um provedor.

hermes auth status anthropic

logout <provedor>

Deslogar de um provedor e limpar o estado de autenticação armazenado.

hermes auth logout anthropic

spotify [login|status|logout]

Autenticar o Hermes com Spotify via PKCE.

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

Flags:

• --client-id CLIENT_ID — Client id do app Spotify (ou HERMES_SPOTIFY_CLIENT_ID).
• --redirect-uri REDIRECT_URI — URI de redirect localhost permitida.
• --scope SCOPE — Sobrescrever os scopes solicitados.
• --no-browser — Não abrir o navegador automaticamente.
• --timeout TIMEOUT — Timeout de troca de token/callback em segundos.

Exemplos

# Adicionar uma chave de API de uma variável de ambiente
hermes auth add openrouter --api-key $OPENROUTER_API_KEY

# Adicionar várias chaves para rotação
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

# Adicionar um provedor OAuth
hermes auth add anthropic --type oauth

# Verificar e resetar após rate limit
hermes auth status openrouter
hermes auth reset openrouter

# Listar e remover uma credencial
hermes auth list openrouter
hermes auth remove openrouter 1

Dicas

• Adicione 3 a 5 chaves para provedores de alto throughput, assim o Hermes pode rotacionar quando uma atingir o limite.
• --api-key lê a variável de ambiente de forma segura; se omitido, o CLI solicita a chave sem exibição.
• hermes auth reset limpa o estado de exaustão, mas não exclui as credenciais.
• Spotify usa PKCE; defina HERMES_SPOTIFY_CLIENT_ID para evitar passar --client-id toda vez.