Pular para o conteúdo principal
Execute phaseo hermes para definir o Phaseo como endpoint personalizado do Hermes Agent, com uma chave própria, ou defina você mesmo as mesmas quatro configurações do Hermes e uma linha no .env.

​
Configure com a CLI do Phaseo

Se o Hermes não estiver instalado, a CLI mostra o comando do instalador oficial da Nous Research e pede confirmação antes de executá-lo. No macOS e no Linux, o instalador precisa de sh, bash e curl. Em seguida, a configuração:
  1. Salva os valores atuais de model.provider, model.base_url, model.default e model.key_env, para que a remoção possa restaurá-los.
  2. Cria uma Phaseo CLI: Hermes Agent API Key que expira após 90 dias e tem um limite de gastos mensal de $100.
  3. Grava a chave no arquivo .env do Hermes como OPENAI_API_KEY, dentro de um bloco que começa com # >>> phaseo managed (do not edit) e termina com # <<< phaseo managed. Suas outras linhas ficam intactas, e a chave nunca aparece em uma linha de comando.
  4. Executa hermes config set para apontar o Hermes para o Phaseo:
model.key_env diz ao Hermes para enviar OPENAI_API_KEY ao endpoint personalizado. Sem isso, o Hermes envia essa chave só aos hosts da própria OpenAI, e as solicitações chegam ao Phaseo sem chave. O Phaseo pergunta ao Hermes onde fica o arquivo .env dele (hermes config env-path), o que cobre perfis e outras substituições. Se o Hermes não souber informar, a CLI usa o .env em HERMES_HOME, ou ~/.hermes/.env (%LOCALAPPDATA%\hermes\.env no Windows nativo). O Hermes guarda as chaves de provedores nesse arquivo em texto puro, então proteja-o como qualquer outro arquivo de chaves. Execute phaseo hermes de novo para substituir uma chave expirada ou trocar o modelo. O comando mantém as configurações salvas na primeira execução.

​
Configure o Hermes manualmente

Adicione sua chave de API do Phaseo ao arquivo .env do Hermes:
.env
Depois, aponte o Hermes para o Phaseo:
Execute hermes config env-path para encontrar o arquivo .env que o Hermes lê.

​
Confira se funciona

Reinicie as sessões ativas do Hermes para que elas usem o endpoint e a chave do Phaseo. Execute hermes config get model.base_url --json para confirmar que ele retorna https://api.phaseo.app/v1, depois envie um prompt curto e confirme que a solicitação aparece em Configurações → Uso → Registros.

​
Remova o Phaseo

Isso restaura as quatro configurações de modelo salvas durante a configuração (ou remove as que não estavam definidas), remove o bloco do Phaseo do .env, apaga o estado salvo da CLI em ~/.config/phaseo/integrations/hermes.json e revoga a chave. Reinicie as sessões ativas do Hermes para que elas recarreguem a configuração restaurada.

​
Corrija problemas comuns

Para outros agentes e para os valores de provedor de que todo agente precisa, veja Agentes de programação.
Última modificação em 5 de novembro de 2026