Cómo Configurar Hermes Agent con OpenRouter

OpenRouter Es el Punto de Partida Recomendado para Hermes

Cuando configurás Hermes Agent por primera vez, necesitás apuntarlo a un proveedor de LLM. El quickstart oficial soporta Nous Portal, OpenRouter, OpenAI, Anthropic y cualquier endpoint compatible con OpenAI. En la práctica, OpenRouter es la mejor opción para la mayoría de los usuarios, especialmente en un primer despliegue.

La razón es simple: OpenRouter es una sola API key que te da acceso a cientos de modelos de diferentes proveedores. En vez de manejar cuentas separadas con OpenAI, Anthropic y Nous Portal, tenés una interfaz de facturación, una API key y un selector de modelos que no requiere reconfigurar Hermes cada vez que querés probar algo distinto.

Para un agente que se mejora a sí mismo como Hermes, diseñado para mejorar con el tiempo, poder cambiar de modelo sin cambios de infraestructura es muy útil. Podés empezar con un modelo más económico para el uso diario y cambiar a uno más capaz para tareas complejas sin tocar tu instalación de Hermes.

Cómo Obtener Tu API Key de OpenRouter

La configuración es rápida:

1. Andá a openrouter.ai y creá una cuenta.
2. Navegá a Settings → API Keys y generá una nueva clave.
3. Copiá la clave: empieza con sk-or-.
4. Agregá créditos a tu cuenta. OpenRouter soporta facturación pay-as-you-go, así que podés empezar con una cantidad pequeña.

La clave que copiás es lo que le vas a proveer a Hermes (o a Hermify si usás hosting gestionado) como OPENROUTER_API_KEY.

Configurar Hermes para Usar OpenRouter

Si corrés Hermes localmente, la configuración ocurre en tu archivo config.yaml. La sección relevante se ve así:

provider: openrouter
model: anthropic/claude-3-5-sonnet
openrouter_api_key: sk-or-your-key-here

También podés usar el comando de configuración interactiva:

hermes setup

Este te guía por la elección del proveedor y el modelo, y escribe la configuración por vos. Si querés cambiar el modelo más adelante sin correr el setup completo de nuevo, podés usar:

hermes model

Esto abre un selector de modelos sin resetear el resto de tu configuración.

Elegir el Modelo Correcto en OpenRouter

OpenRouter expone cientos de modelos. La elección correcta depende de tu caso de uso y presupuesto. Estas son las opciones prácticas para Hermes:

Mejores modelos de propósito general en OpenRouter:

• anthropic/claude-3-5-sonnet: Fuerte razonamiento, sigue bien instrucciones de múltiples pasos, bueno para flujos de trabajo complejos. Es el modelo con el que comienza la mayoría de los usuarios de Hermes.
• openai/gpt-4o: Rápido, capaz, bueno para código y tareas estructuradas.
• meta-llama/llama-3.1-70b-instruct: Pesos abiertos, menor costo por token, bueno para flujos de trabajo de alto volumen.
• nousresearch/hermes-3-llama-3.1-405b: El modelo propio de Nous de la familia Hermes. Encaja naturalmente con los system prompts de Hermes Agent, ya que ambos vienen del mismo laboratorio.
• google/gemini-2.0-flash: Rápido y económico, bueno para aplicaciones sensibles a la latencia.

Enfoque de presupuesto: Empezá con llama-3.1-70b-instruct para el uso diario. Cambiá a Claude o GPT-4o para tareas que requieran razonamiento más fuerte o ventanas de contexto más largas.

El enfoque con el modelo de Nous: nousresearch/hermes-3-llama-3.1-405b vale la pena probarlo específicamente porque el runtime del agente Hermes fue construido alrededor de los modelos Nous. La alineación entre el estilo de prompting del agente y el entrenamiento del modelo tiende a ser más estrecha que con modelos de terceros.

Consejos de Configuración Específicos para OpenRouter con Hermes

Algunas cosas que importan específicamente para OpenRouter con Hermes:

Configurá una preferencia de proveedor. OpenRouter enruta las solicitudes a múltiples proveedores de infraestructura. Si usás modelos de Anthropic, podés fijar la infraestructura propia de Anthropic configurando provider_order en tu config. Esto reduce la variación de latencia.

Configurá modelos de fallback. Hermes soporta proveedores auxiliares en config.yaml. Esto significa que si tu modelo principal no está disponible, Hermes puede caer de vuelta a uno secundario. Con OpenRouter, podés especificar múltiples modelos como fallbacks bajo auxiliary_providers.

Vigilá tu ventana de contexto. Hermes usa memoria persistente y archivos de contexto, lo que significa que los prompts pueden ser largos. Los modelos con ventanas de contexto más pequeñas (menos de 32k tokens) pueden alcanzar los límites más rápido de lo esperado. Si notás respuestas que parecen ignorar el contexto reciente, es posible que el modelo esté truncando tu archivo de memoria. Cambiá a un modelo con una ventana de contexto más grande: Claude y Gemini ofrecen 128k+.

Errores Comunes de Configuración

Usar la URL base incorrecta. Hermes espera un endpoint compatible con OpenAI. La URL base de OpenRouter es https://openrouter.ai/api/v1. Algunos usuarios accidentalmente usan la URL de OpenAI, lo que causa fallos de autenticación con las claves de OpenRouter.

Olvidar el header HTTP-Referer. OpenRouter requiere un header HTTP-Referer en las solicitudes de API para identificar tu aplicación. Hermes lo maneja automáticamente cuando configurás openrouter como proveedor, pero si estás usando una configuración de endpoint personalizada, necesitás agregar este header manualmente.

Agotamiento de cuota en medio de la sesión. OpenRouter bloquea las solicitudes cuando tus créditos están bajos, lo que Hermes muestra como un error en la terminal o en la interfaz de mensajería. Agregar un umbral de auto-recarga pequeño en la configuración de OpenRouter evita que esto interrumpa flujos de trabajo largos.

Elegir un modelo que no soporta tool calls. Hermes depende del uso de tools para muchas de sus capacidades (escritura de archivos, búsquedas web, tareas programadas). Algunos modelos más económicos en OpenRouter no soportan tool calling. Revisá las flags de capacidades del modelo en la página del modelo de OpenRouter antes de cambiar.

Qué Cambia Si Usás Hosting Gestionado

Si desplegás Hermes a través de Hermify, la configuración del proveedor funciona de la misma manera, pero ingresás tu API key de OpenRouter a través del dashboard de onboarding en vez de editar un archivo de config. Hermify la almacena cifrada y la inyecta en el runtime al inicio.

También podés actualizar tu clave de proveedor o cambiar de modelos desde el dashboard de Hermify sin reiniciar el contenedor manualmente. Esta es la principal diferencia operativa: en vez de acceso SSH para editar config.yaml, usás la UI de configuración, activás un reinicio y el cambio toma efecto en segundos.

El plan Starter está diseñado específicamente alrededor de BYOK con OpenRouter: vos traés la clave, Hermify se encarga de todo lo demás. Si querés saltarte la cuenta de OpenRouter por completo, los planes Pro y Dedicated incluyen acceso a modelos para que no necesites configurar ningún proveedor externo.

Una Configuración de Partida Práctica

Si querés un buen punto de partida sin perder tiempo comparando modelos, esta es la configuración que funciona bien para la mayoría de los usuarios de Hermes en OpenRouter:

• Proveedor: OpenRouter
• Modelo: anthropic/claude-3-5-sonnet para uso principal
• Fallback: meta-llama/llama-3.1-70b-instruct
• Ventana de contexto: 200k tokens (Claude lo soporta)
• Carga inicial de créditos: $10–$20 (típicamente dura varias semanas de uso regular)

Desde ahí, podés ajustar el modelo a medida que entiendas mejor tus propios patrones de uso. Hermes está diseñado para sesiones de larga duración, así que el modelo que elijas afecta la calidad de la memoria y la confiabilidad de las tools, no solo la velocidad de respuesta.

Si querés saltarte el trabajo de configuración y llegar más rápido a un despliegue funcional de Hermes, Hermify se encarga del cableado del proveedor. También podés leer más sobre la diferencia real de costos entre Hermes self-hosted y el hosting gestionado antes de decidir.