Saltar al contenido principal

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.

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.