Guía de integración de agents
Usa Hermes con la API LLM de WaveSpeed
Esta guía muestra cómo conectar Hermes a WaveSpeed AI con ~/.hermes/config.yaml, Chat completions compatibles con OpenAI, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1 y el modelo predeterminado anthropic/claude-opus-4.8. Copia la configuración anterior, exporta tu API key, ejecuta el agent y verifica los requests en Logs.
Crea una clave de acceso de WaveSpeed
Exporta la clave requerida localmente
Pega la configuración en
~/.hermes/config.yamlEjecuta hermes chat y revisa Logs
Qué configura este setup de Hermes
Protocolo
Chat completions compatibles con OpenAI
Endpoint
/v1/chat/completions
Modelo
anthropic/claude-opus-4.8
La configuración lista para copiar de arriba es el único archivo de Hermes que necesitas editar para el setup recomendado: ~/.hermes/config.yaml. Mantén la API key en tu entorno shell para no enviarla a un repositorio.
Solución de problemas
La API key no se detecta
Exporta WAVESPEED_API_KEY en la misma shell donde ejecutas Hermes. Si usas un perfil de shell, recarga la terminal antes de iniciar el agent.
Los requests fallan con un error de protocolo o endpoint
Comprueba que Hermes usa Chat completions compatibles con OpenAI y endpoint /v1/chat/completions. Los desajustes de protocolo son la causa más común de errores 404 o de payload.
El modelo seleccionado no funciona
Confirma que el ID del modelo existe en WaveSpeed Models y pega el ID exacto en ~/.hermes/config.yaml. Puedes empezar con el modelo predeterminado que aparece en esta página.
No aparecen requests en Logs
Asegúrate de que Hermes usa la base URL de WaveSpeed y tu API key actual. Luego envía un prompt nuevo desde el agent local y actualiza Logs.
¿Puede esta guía de Hermes aparecer en buscadores?
Sí. Esta página está creada como guía indexable para usuarios que buscan custom provider de Hermes, endpoint compatible con OpenAI, base URL y flujos de configuración local de agents.