Saltar para o conteúdo principal
Use o CometAPI como provedor de modelo para o Hermes Agent por meio do suporte do Hermes a endpoint personalizado compatível com OpenAI.

​
Pré-requisitos

  • Git
  • Uma conta CometAPI com uma API key ativa
  • Um terminal no macOS, Linux ou WSL2

​
Instalação

1

Obtenha sua API key do CometAPI

Faça login no console do CometAPI. Clique em Add API Key e copie sua chave <COMETAPI_KEY>.
Painel do CometAPI mostrando o botão Add API Key
Detalhes da API key do CometAPI com a URL base exibida
2

Instale o Hermes Agent

O comando a seguir executa o instalador oficial:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Se o shell atual ainda não reconhecer o comando hermes, recarregue a configuração do shell:
source ~/.zshrc
# or
source ~/.bashrc
O Hermes armazena a configuração em ~/.hermes/, cria um link para o comando hermes em ~/.local/bin e pode adicionar ~/.local/bin ao PATH do seu shell.

​
Configuração

1

Armazene sua chave do CometAPI

Abra ~/.hermes/.env e adicione a seguinte linha:
OPENAI_API_KEY=<COMETAPI_KEY>
O Hermes usa OPENAI_API_KEY como fallback de autenticação para endpoints personalizados compatíveis com OpenAI.
2

Configure o endpoint do CometAPI

Abra ~/.hermes/config.yaml e certifique-se de que a seção model esteja assim:
model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1
Substitua your-model-id por um model ID atual de modelo de texto na página de Models do CometAPI.
Mantenha a API key em ~/.hermes/.env. Não coloque secrets diretamente no config.yaml.
Essa configuração define o modelo principal de chat. O Hermes pode usar modelos auxiliares separados para tarefas como visão ou extração da web.

​
Verificação

1

Verifique a configuração

Os comandos a seguir confirmam que o Hermes consegue ler a configuração e a API key:
hermes config check
hermes doctor
hermes status
Se hermes config check relatar opções ausentes após uma atualização, execute hermes config migrate e verifique novamente.
2

Execute um teste de chat real

O comando a seguir envia uma requisição real por meio do CometAPI:
hermes chat -q "Reply with the single word CONNECTED."
Uma configuração bem-sucedida retorna CONNECTED e nenhum erro de autenticação ou endpoint.

​
Configuração opcional

Se você estiver substituindo uma instalação antiga do Hermes, use primeiro o desinstalador integrado:
hermes uninstall
No desinstalador, escolha Full uninstall para remover a CLI, a entrada no PATH e os dados em ~/.hermes/. Depois, execute novamente a etapa de instalação e continue com a mesma configuração do CometAPI.
Se você preferir o fluxo interativo, execute hermes model e escolha Custom endpoint.Depois, informe os seguintes valores:
  • Base URL: https://api.cometapi.com/v1
  • API key: sua API key do CometAPI
  • Model: um model ID atual de modelo de texto do CometAPI
Esse fluxo grava as mesmas configurações de provider no config.yaml.