Saltar al contenido principal
Usa CometAPI como proveedor de modelos para Hermes Agent mediante la compatibilidad de Hermes con endpoints personalizados compatibles con OpenAI.

​
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 clave <COMETAPI_KEY>.
Panel de CometAPI mostrando 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:
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:
source ~/.zshrc
# or
source ~/.bashrc
Hermes guarda 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

1

Guarda tu clave de CometAPI

Abre ~/.hermes/.env y añade la siguiente línea:
OPENAI_API_KEY=<COMETAPI_KEY>
Hermes usa OPENAI_API_KEY como método de autenticación de respaldo para endpoints personalizados compatibles con OpenAI.
2

Configura el endpoint de CometAPI

Abre ~/.hermes/config.yaml y asegúrate de que la sección model tenga este aspecto:
model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1
Reemplaza your-model-id por un model ID de texto actual de la página de modelos de CometAPI.
Mantén la API key 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.

​
Verificación

1

Comprueba la configuración

Los siguientes comandos confirman que Hermes puede leer la configuración y la API key:
hermes config check
hermes doctor
hermes status
Si hermes config check informa opciones faltantes después de una actualización, ejecuta hermes config migrate y vuelve a comprobarlo.
2

Ejecuta una prueba de chat real

El siguiente comando envía una solicitud real a través de CometAPI:
hermes chat -q "Reply with the single word CONNECTED."
Una configuración correcta devuelve CONNECTED y no muestra errores de autenticación ni de endpoint.

​
Configuración opcional

Si vas a reemplazar una instalación anterior de Hermes, usa primero el desinstalador integrado:
hermes uninstall
En el desinstalador, elige Full uninstall para eliminar el CLI, la entrada del PATH y los datos de ~/.hermes/. Después, vuelve a ejecutar el paso de instalación y continúa con la misma configuración de CometAPI.
Si prefieres el flujo interactivo, ejecuta hermes model y elige Custom endpoint.Luego introduce los siguientes valores:
  • Base URL: https://api.cometapi.com/v1
  • API key: tu API key de CometAPI
  • Model: un model ID de texto actual de CometAPI
Este flujo escribe la misma configuración del provider en config.yaml.