Skip to main content
Usa CometAPI como proveedor de model para Hermes Agent. 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

1

Obtén tu API key de CometAPI

Inicia sesión en la consola de CometAPI. Haz clic en Add API Key y copia tu API key de CometAPI.
Panel de CometAPI que muestra el botón Add API Key
Detalles de la API key de CometAPI con la URL base mostrada
2

Instala Hermes Agent

El siguiente comando ejecuta el instalador oficial:
Si el shell actual todavía no reconoce el comando hermes, recarga la configuración del shell:
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:
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.
1

Guarda tu clave de CometAPI

Abre ~/.hermes/.env y añade los siguientes valores:
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.
2

Configura la ruta compatible con OpenAI

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í:
Reemplaza your-model-id con un model ID de texto actual de la página de modelos de CometAPI.
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.
3

Configura la ruta de Claude Messages

Usa esta ruta cuando quieras que Hermes llame a modelos Claude mediante Anthropic Messages. Abre ~/.hermes/config.yaml y usa un proveedor con nombre:
Reemplaza your-claude-model-id con un model ID actual de Claude de la página de modelos de CometAPI.
Mantén base_url en https://api.cometapi.com para esta ruta. Hermes usa el transporte Anthropic Messages del proveedor con nombre.

​
Verificación

1

Comprueba la configuración

El siguiente comando confirma que Hermes puede leer la configuración y la clave de API:
Si hermes config check informa opciones faltantes después de una actualización, ejecuta hermes config migrate y vuelve a comprobar.
2

Ejecuta una prueba de chat real

El siguiente comando envía una solicitud real a través de CometAPI:
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:
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.