> ## 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 con CometAPI
> Usa esta guía para conectar Hermes Agent a CometAPI mediante la configuración de chat compatible con OpenAI o Anthropic Messages.
Usa [CometAPI](https://www.cometapi.com) como proveedor de model para [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). Hermes admite dos rutas de CometAPI en esta guía: un endpoint general compatible con OpenAI para la mayoría de los modelos de texto y una ruta de Claude a través de Anthropic Messages.
## Requisitos previos
* Git
* Una cuenta de CometAPI con una API key activa
* Una terminal en macOS, Linux o WSL2
## Instalación
Inicia sesión en la [consola de CometAPI](https://www.cometapi.com/console/token). Haz clic en **Add API Key** y copia tu API key de CometAPI.
El siguiente comando ejecuta el instalador oficial:
```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```
Si el shell actual todavía no reconoce el comando `hermes`, recarga la configuración del shell:
```bash theme={null}
source ~/.zshrc
# or
source ~/.bashrc
```
Hermes almacena la configuración en `~/.hermes/`, enlaza el comando `hermes` en `~/.local/bin` y puede añadir `~/.local/bin` al PATH de tu shell.
## Configuración
Elige la ruta de CometAPI que coincida con la familia de modelos:
| Familia de modelos | Configuración de Hermes | Ruta de CometAPI |
| --------------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------- |
| Modelos de texto compatibles con OpenAI | `model.provider: custom` con `base_url: https://api.cometapi.com/v1` | `/v1/chat/completions` |
| Modelos Claude | Proveedor con nombre con `transport: anthropic_messages` | `/v1/messages` |
| Modelos Gemini en Hermes | Usa la configuración compatible con OpenAI | `/v1/chat/completions` |
| Llamadas directas a la API de Gemini | Usa la [API de Gemini `generateContent`](/api/text/gemini-generating-content) fuera de Hermes | `/v1beta` `generateContent` |
No configures Hermes con `https://api.cometapi.com/v1beta` como un proveedor Gemini nativo personalizado. Usa la configuración de Hermes compatible con OpenAI para los modelos Gemini. Para llamadas directas a la API de Gemini, usa la [API de Gemini `generateContent`](/api/text/gemini-generating-content).
Abre `~/.hermes/.env` y añade los siguientes valores:
```dotenv theme={null}
COMETAPI_KEY=
OPENAI_API_KEY=
```
`COMETAPI_KEY` se usa con el proveedor Claude con nombre. `OPENAI_API_KEY` mantiene funcionando el fallback del endpoint personalizado compatible con OpenAI de Hermes.
Usa esta ruta para la mayoría de los modelos de texto de CometAPI, incluidos los modelos Gemini usados desde Hermes. Abre `~/.hermes/config.yaml` y asegúrate de que la sección `model` se vea así:
```yaml theme={null}
model:
provider: custom
default: your-model-id
base_url: https://api.cometapi.com/v1
```
Reemplaza `your-model-id` con un model ID de texto actual de la [página de modelos de CometAPI](https://www.cometapi.com/models/).
Mantén la clave de API en `~/.hermes/.env`. No incrustes secretos directamente en `config.yaml`.
Esta configuración define el modelo principal de chat. Hermes puede usar modelos auxiliares separados para tareas como visión o extracción web.
Usa esta ruta cuando quieras que Hermes llame a modelos Claude mediante Anthropic Messages. Abre `~/.hermes/config.yaml` y usa un proveedor con nombre:
```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
```
Reemplaza `your-claude-model-id` con un model ID actual de Claude de la [página de modelos de CometAPI](https://www.cometapi.com/models/).
Mantén `base_url` en `https://api.cometapi.com` para esta ruta. Hermes usa el transporte Anthropic Messages del proveedor con nombre.
## Verificación
El siguiente comando confirma que Hermes puede leer la configuración y la clave de API:
```bash theme={null}
hermes config check
```
Si `hermes config check` informa opciones faltantes después de una actualización, ejecuta `hermes config migrate` y vuelve a comprobar.
El siguiente comando envía una solicitud real a través de CometAPI:
```bash theme={null}
hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."
```
Una configuración correcta devuelve `CONNECTED` y no muestra errores de autenticación ni de endpoint. Cuando la configuración de Claude Messages está activa, esto confirma que Hermes puede usar el transporte `anthropic_messages` a través de CometAPI.
## Configuración opcional
Si estás reemplazando una instalación anterior de Hermes, usa primero el desinstalador integrado:
```bash theme={null}
hermes uninstall
```
En el desinstalador, elige **Full uninstall** para eliminar la CLI, la entrada de PATH y los datos de `~/.hermes/`. Luego vuelve a ejecutar el paso de instalación y continúa con la misma configuración de CometAPI.
Si prefieres el flujo interactivo para la ruta compatible con OpenAI, ejecuta `hermes model` y elige **Custom endpoint**.
Luego introduce los siguientes valores:
* Base URL: `https://api.cometapi.com/v1`
* API key: tu clave de API de CometAPI
* Model: un model ID de texto actual de CometAPI
Este flujo escribe la configuración del proveedor compatible con OpenAI en `config.yaml`. Para Claude Messages, edita `config.yaml` directamente para que el proveedor con nombre conserve `transport: anthropic_messages`.