Hermes Agent con Muapi
Usa modelos de texto de Muapi con Hermes Agent configurando Muapi como endpoint personalizado compatible con OpenAI.
1. Crea una clave y elige un modelo
Crea una clave API en el panel de Muapi y lista los modelos de texto disponibles:
curl -s "https://api.muapi.ai/v1/models?type=text" \
-H "Authorization: Bearer $MUAPI_API_KEY"
Elige un modelo con capabilities.tools: true. Los flujos de agente de Hermes requieren una ventana de contexto de al menos 64.000 tokens; comprueba el límite del modelo antes de elegirlo.
2. Configura Hermes Agent
Ejecuta el asistente de configuración del modelo:
hermes model
Elige Custom endpoint e introduce:
| Campo | Valor |
|---|---|
| URL base de la API | https://api.muapi.ai/v1 |
| Clave API | Tu clave API de Muapi |
| Nombre del modelo | ID exacto de la lista de modelos de texto de Muapi |
También puedes definir el endpoint en ~/.hermes/config.yaml:
model:
default: YOUR_MODEL_ID
provider: custom
base_url: https://api.muapi.ai/v1
key_env: MUAPI_API_KEY
Guarda la clave en ~/.hermes/.env:
MUAPI_API_KEY=your-muapi-api-key
Sustituye YOUR_MODEL_ID por el ID exacto de la lista de Muapi.
3. Inicia Hermes Agent
Inicia la CLI o la interfaz de terminal y prueba una tarea pequeña que use una herramienta:
hermes
# O bien:
hermes --tui
Cuando el modelo funcione, conecta plataformas de mensajería con hermes gateway setup.
Solución de problemas
- Si Hermes no se conecta, comprueba que la URL base termine en
/v1, que la clave esté disponible y que el ID del modelo sea exacto. - Si el modelo no usa herramientas, elige uno con
capabilities.tools: true. - Hermes requiere una ventana de contexto de al menos 64K; elige un modelo que cumpla ese mínimo.
- Empieza con una tarea pequeña y consulta el uso en el panel de Muapi.
Consulta la documentación de proveedores de Hermes Agent para configurar endpoints personalizados y la guía de configuración para ver los ajustes actuales.