Hermes Agent + DeepSeek en la red Gonka: agente autónomo por centavos

Instalación de Hermes (Linux, macOS, WSL2). El instalador oficial se encarga de traer Python, Node.js, ripgrep y ffmpeg:

# Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Windows (PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Cuando termine la instalación, reinicia el shell y comprueba que arranca:

source ~/.bashrc   # or ~/.zshrc
hermes             # interactive CLI

Clave API de JoinGonka: si aún no tienes una, regístrate en gate.joingonka.ai/register, confirma tu dirección — recibirás 3M tokens gratis en tu cuenta — y crea una clave con el prefijo jg- en el Dashboard. Una sola clave y un solo saldo te sirven para todos los modelos a la vez.

Hermes funciona con cualquier endpoint compatible con OpenAI: si el servidor responde a /v1/chat/completions, puedes apuntar Hermes hacia él. El gateway de JoinGonka es exactamente así. Hay tres formas de configurarlo.

Opción 1: nuestro instalador (un solo comando, recomendado). Registrará el proveedor en la config de Hermes, establecerá DeepSeek V4 Flash como modelo predeterminado y verificará con una petición en vivo que el gateway acepta la clave y el modelo:

npx @joingonka/setup --tool hermes

Opción 2: asistente de configuración. Ejecuta en la terminal fuera de una sesión activa:

hermes model

En la lista de proveedores elige «Custom endpoint (self-hosted / VLLM / etc.)» e introduce tres valores:

• API base URL: https://gate.joingonka.ai/v1
• API key: jg-your-key
• Model name: deepseek-ai/DeepSeek-V4-Flash-0731

Opción 3: editar la config. Hermes guarda los ajustes de modelos en ~/.hermes/config.yaml (en la build nativa para Windows — %LOCALAPPDATA%\hermes\config.yaml) — es la única fuente de verdad. Añade la sección:

# ~/.hermes/config.yaml
model:
  provider: custom
  default: deepseek-ai/DeepSeek-V4-Flash-0731
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-your-key

El nombre del modelo se escribe en la clave default — es la clave canónica de Hermes. La línea model: dentro del bloque es solo un alias de reserva: no tiene efecto si default ya está definido (por ejemplo, por el asistente de configuración), así que al editar a mano cambia precisamente default.

⚠️ La clave va solo en model.api_key. La documentación de Hermes permite OPENAI_API_KEY en ~/.hermes/.env, pero para un endpoint personalizado esto no funciona: Hermes lee la clave solo desde model.api_key, y con la clave en .env el gateway responderá 401 Invalid API key. Verificado en Hermes v0.20.4.

Verificación: ejecuta hermes y escribe «Crea un archivo hello.py con una función hello world». El agente debe crear el archivo y mostrar el resultado. El estado de la configuración actual se ve con hermes config show | grep '^model\.' y hermes status.

Cambio en caliente: dentro de la sesión con el comando /model custom:deepseek-ai/DeepSeek-V4-Flash-0731. Y /model custom sin nombre cargará automáticamente el modelo desde el endpoint si solo hay uno.

Hermes es una herramienta de agente con memoria y habilidades. No responde con una sola réplica: lee archivos, escribe código, ejecuta comandos, comprime el contexto y realiza largas tareas en segundo plano mediante un programador. Cada acción es una llamada a la API, y en un día de trabajo autónomo se acumulan decenas de millones de tokens. Comparemos el costo de sesiones típicas:

Con JoinGonka Gateway, Hermes puede mantenerse funcionando las 24 horas del día: informes nocturnos, auditorías semanales, tareas en segundo plano vía cron-scheduler, sin preocuparse por la factura. Con los precios de Anthropic, cada ejecución tendría que calcularse manualmente. El saldo inicial al registrarse es suficiente para probar al agente en una tarea real y ver su propio consumo antes de la primera recarga.

A través del Gateway, el usuario tiene acceso inmediato a tres modelos de Gonka: todos ellos soportan tool calling nativo (OpenAI function calling), por lo que las habilidades y herramientas de Hermes funcionan de manera confiable, sin necesidad de parsear respuestas de texto:

Sobre los límites de tokens en Hermes. En el archivo config.yaml, el campo context_length es la ventana de contexto completa (entrada + salida), y max_tokens es el límite solo para la longitud de la respuesta. Es mejor no configurar ninguno: Hermes determinará automáticamente los valores correctos proporcionados por el proveedor. Si configuras max_tokens manualmente, mantenlo dentro de los límites del modelo: a través del Gateway, esto es 32768 para DeepSeek V4 Flash y 8192 para MiniMax M2.7 y GLM-5.3 Flash. Puedes cambiar de modelo en cualquier momento con el comando hermes model o directamente en la sesión mediante /model.

Herramientas de terminal similares en nuestra base de conocimientos: Claude Code, Cline.