Skip to main content
Use o CometAPI como provedor de model para o Hermes Agent. O Hermes oferece suporte a dois caminhos do CometAPI neste guia: um endpoint geral compatível com OpenAI para a maioria dos modelos de texto e uma rota Claude por meio de Anthropic Messages.

​
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 API key do CometAPI.
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:
Se o shell atual ainda não reconhecer o comando hermes, recarregue a configuração do shell:
O Hermes armazena a configuração em ~/.hermes/, vincula o comando hermes em ~/.local/bin e pode adicionar ~/.local/bin ao PATH do seu shell.

​
Configuração

Escolha a rota da CometAPI que corresponde à família do modelo:
Não configure o Hermes com https://api.cometapi.com/v1beta como um provider personalizado nativo do Gemini. Use a configuração do Hermes compatível com OpenAI para modelos Gemini. Para chamadas diretas à API Gemini, use a API Gemini generateContent.
1

Armazene sua chave da CometAPI

Abra ~/.hermes/.env e adicione os seguintes valores:
COMETAPI_KEY é usada pelo provider Claude nomeado. OPENAI_API_KEY mantém o fallback de endpoint personalizado compatível com OpenAI do Hermes funcionando.
2

Configure a rota compatível com OpenAI

Use esta rota para a maioria dos modelos de texto da CometAPI, incluindo modelos Gemini usados a partir do Hermes. Abra ~/.hermes/config.yaml e certifique-se de que a seção model se pareça com isto:
Substitua your-model-id por um model ID de texto atual da página de modelos da CometAPI.
Mantenha a chave de API em ~/.hermes/.env. Não codifique segredos diretamente no config.yaml.
Esta configuração define o principal modelo de chat. O Hermes pode usar modelos auxiliares separados para tarefas como visão ou extração web.
3

Configure a rota Claude Messages

Use esta rota quando quiser que o Hermes chame modelos Claude por meio de Anthropic Messages. Abra ~/.hermes/config.yaml e use um provider nomeado:
Substitua your-claude-model-id por um model ID Claude atual da página de modelos da CometAPI.
Mantenha base_url como https://api.cometapi.com para esta rota. O Hermes usa o transporte Anthropic Messages do provider nomeado.

​
Verificação

1

Verifique a configuração

O comando a seguir confirma que o Hermes consegue ler a configuração e a chave de API:
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 solicitação real por meio da CometAPI:
Uma configuração bem-sucedida retorna CONNECTED e nenhum erro de autenticação ou endpoint. Quando a configuração Claude Messages estiver ativa, isso confirma que o Hermes pode usar o transporte anthropic_messages por meio da CometAPI.

​
Configuração opcional

Se você estiver substituindo uma instalação mais antiga do Hermes, use primeiro o desinstalador integrado:
No desinstalador, escolha Desinstalação completa para remover a CLI, a entrada PATH e os dados em ~/.hermes/. Em seguida, execute novamente a etapa de instalação e continue com a mesma configuração do CometAPI.
Se você preferir o fluxo interativo para a rota compatível com OpenAI, execute hermes model e escolha Custom endpoint.Em seguida, insira os seguintes valores:
  • Base URL: https://api.cometapi.com/v1
  • API key: sua chave de API do CometAPI
  • Model: um model ID atual de modelo de texto do CometAPI
Esse fluxo grava as configurações do provedor compatível com OpenAI em config.yaml. Para Claude Messages, edite config.yaml diretamente para que o provedor nomeado mantenha transport: anthropic_messages.