> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Usar Hermes Agent com CometAPI
> Use este guia para conectar o Hermes Agent ao CometAPI por meio de configurações de chat compatíveis com OpenAI ou Anthropic Messages.
Use o [CometAPI](https://www.cometapi.com) como provedor de model para o [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). 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
Faça login no [console do CometAPI](https://www.cometapi.com/console/token). Clique em **Add API Key** e copie sua API key do CometAPI.
O comando a seguir executa o instalador oficial:
```bash theme={null}
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:
```bash theme={null}
source ~/.zshrc
# or
source ~/.bashrc
```
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:
| Família de modelos | Configuração do Hermes | Rota da CometAPI |
| --------------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------- |
| Modelos de texto compatíveis com OpenAI | `model.provider: custom` com `base_url: https://api.cometapi.com/v1` | `/v1/chat/completions` |
| Modelos Claude | Provider nomeado com `transport: anthropic_messages` | `/v1/messages` |
| Modelos Gemini no Hermes | Use a configuração compatível com OpenAI | `/v1/chat/completions` |
| Chamadas diretas à API Gemini | Use a [API Gemini `generateContent`](/api/text/gemini-generating-content) fora do Hermes | `/v1beta` `generateContent` |
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`](/api/text/gemini-generating-content).
Abra `~/.hermes/.env` e adicione os seguintes valores:
```dotenv theme={null}
COMETAPI_KEY=
OPENAI_API_KEY=
```
`COMETAPI_KEY` é usada pelo provider Claude nomeado. `OPENAI_API_KEY` mantém o fallback de endpoint personalizado compatível com OpenAI do Hermes funcionando.
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:
```yaml theme={null}
model:
provider: custom
default: your-model-id
base_url: https://api.cometapi.com/v1
```
Substitua `your-model-id` por um model ID de texto atual da [página de modelos da CometAPI](https://www.cometapi.com/models/).
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.
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:
```yaml theme={null}
model:
provider: cometapi-claude
default: your-claude-model-id
providers:
cometapi-claude:
base_url: https://api.cometapi.com
key_env: COMETAPI_KEY
transport: anthropic_messages
default_model: your-claude-model-id
```
Substitua `your-claude-model-id` por um model ID Claude atual da [página de modelos da CometAPI](https://www.cometapi.com/models/).
Mantenha `base_url` como `https://api.cometapi.com` para esta rota. O Hermes usa o transporte Anthropic Messages do provider nomeado.
## Verificação
O comando a seguir confirma que o Hermes consegue ler a configuração e a chave de API:
```bash theme={null}
hermes config check
```
Se `hermes config check` relatar opções ausentes após uma atualização, execute `hermes config migrate` e verifique novamente.
O comando a seguir envia uma solicitação real por meio da CometAPI:
```bash theme={null}
hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."
```
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:
```bash theme={null}
hermes uninstall
```
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`.