Retrato de Santiago Fernández

CubeLabs

🧠 IA & ML

Hermes Agent: Guía Completa para Principiantes

⏱ 30 min de lectura 📊 Principiante a Intermedio 📝 10 lecciones 🛠️ Práctico

Aprende a usar Hermes Agent, el asistente de IA autónomo y open-source de Nous Research. Instálalo en 2 minutos, elige un modelo, crea tu primer workflow automatizado y descubre cómo mejora solo con el uso. Basado en la guía oficial de Hermes Atlas.

Hermes Agent Guide - Hermes Atlas
Portada de la guía oficial — Hermes Atlas por Kevin Simback

Contenido

  1. ¿Qué es Hermes Agent?
  2. ¿Para quién es?
  3. ¿Cómo se diferencia?
  4. Instalación en 2 minutos
  5. Elegir tu modelo
  6. Tu primer workflow
  7. El bucle de aprendizaje
  8. Skills esenciales
  9. Siguientes pasos
  10. FAQ

1. ¿Qué es Hermes Agent?

Hermes Agent es un agente de IA autónomo y open-source creado por Nous Research. Se ejecuta en tu propio ordenador o en un VPS barato, recuerda todo lo que aprende entre sesiones y escribe sus propias skills reutilizables mientras trabaja.

Se comunica contigo a través de 14+ plataformas: CLI, Telegram, Discord, Slack, email y más. Con más de 104.000 estrellas en GitHub, es el agente open-source de más rápido crecimiento en 2026.

La versión de 30 segundos

Instalas Hermes con un comando curl. Eliges un proveedor de modelos (Claude, GPT, GLM, MiniMax, o incluso un modelo local con Ollama). Le das un trabajo —"resume mis notificaciones de GitHub cada mañana"— y él lo ejecuta. Y aprende. Una semana después, hace el mismo trabajo mejor porque ha estado escribiendo skills en segundo plano.

La versión de 2 minutos

La mayoría de herramientas de IA no tienen memoria: abres un chat, preguntas, cierras la pestaña. Hermes invierte eso. Vive en tu máquina, tiene memoria persistente, crea skills (procedimientos reutilizables) cada vez que descubre algo útil, y te llega por el canal que prefieras.

💡 Concepto clave

Harness Engineering: Nous cree que el verdadero avance no es un modelo más inteligente, sino un wrapper más inteligente alrededor del modelo. Hermes invierte en 5 capas: instrucciones, restricciones, feedback, memoria y orquestación. El modelo es intercambiable.

2. ¿Para quién es Hermes?

Hay tres perfiles típicos de usuario. Identifica el tuyo:

3. ¿Cómo se diferencia de Claude Code, Cursor y OpenClaw?

La mayoría de usuarios avanzados usan dos o tres de estas herramientas juntas:

Característica Claude Code Cursor OpenClaw Hermes Agent
Superficie principal CLI en un repo IDE CLI + configs CLI + chat + cron + Telegram
Memoria persistente Solo sesión Solo proyecto Archivos de config ✅ Multi-sesión (MEMORY.md, USER.md)
Auto-aprendizaje ❌ No ❌ No ❌ No ✅ Skills auto-generadas
Canales Terminal Editor Terminal Terminal, Telegram, Discord, email, webhooks
Tareas programadas ❌ No ❌ No ❌ No ✅ Cron integrado
Mejor para Codificar en un repo Escribir código inline Ejecutar workflows shell Tareas autónomas que mejoran con el tiempo
💡 Tip

La mayoría de la comunidad ejecuta Hermes + Claude Code. Claude Code para el código dentro del repo, Hermes para todo lo demás: briefings diarios, monitoreo, automatización, investigación multi-repo.

4. Instalación en 2 minutos

Un solo comando curl y dos pasos de configuración:

Requisitos

1

Instalar

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

En Windows nativo (PowerShell beta):

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
2

Primer inicio

hermes

Hermes te guiará por la configuración del proveedor. Pega tu API key cuando te la pida.

3

Verificar

hermes doctor

Muestra un reporte de salud. Todo en verde = listo.

⚠️ Errores comunes

"Command not found: hermes" → Abre una terminal nueva o ejecuta source ~/.bashrc.

"Provider error: invalid key" → La key tiene un espacio al final o es del proveedor equivocado. Re-ejecuta hermes model.

Windows: "bad interpreter" → Estás en Windows nativo, no en WSL2. Instala WSL2 con wsl --install.

5. Elegir tu modelo

El error más común del primer fin de semana: si Hermes se siente lento o torpe, casi siempre es el modelo, no Hermes.

Modelos pequeños (Gemma 2B, Llama 3.1 8B) no pueden llamar herramientas de forma fiable. Usa un modelo frontier para trabajo real.

Modelo Coste Llamadas a herramientas Mejor para
Claude Sonnet / Opus $$$ Excelente Workflows de producción
GPT-5 $$$ Excelente Stack OpenAI
GLM-5 (z.AI) $ Excelente Mejor relación calidad-precio
MiniMax M2.7 $$ Excelente Gran valor
DeepSeek $ Buena Workflows optimizados en coste
Ollama + Qwen 2.5 Coder Gratis (local) Buena Offline, privacidad
Ollama + Gemma/Llama 8B Gratis (local) Pobre Solo chat
💡 El botón fácil

Nous Portal — Una suscripción plana que cubre Claude, GPT, GLM, MiniMax y más con una sola autenticación. Un pago mensual fijo y olvídate de gestionar APIs.

6. Tu primer workflow

Elige UNO de estos ejemplos y ejecútalo hoy. Cada uno te enseña una faceta diferente de Hermes.

Ejemplo 1 — Asistente de código en tu laptop

cd ~/projects/mi-repo
hermes
> audita este repo: código muerto, imports sin usar,
  bloques comentados de más de 6 meses. Produce un reporte en markdown.

Hermes leerá archivos, ejecutará greps y escribirá el reporte. La segunda vez será más rápido — ya habrá creado una skill repo-audit.

Ejemplo 2 — Bot de Telegram en un VPS de $5

# En cualquier VPS Linux barato (Hetzner, Digital Ocean...)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

hermes gateway setup
# Pega tu token de bot de @BotFather
# Pega tu ID numérico de Telegram (de @userinfobot)

hermes daemon start

Mensajea a tu bot. Luego añade un trabajo recurrente:

> cada mañana a las 8am, resume mis notificaciones de GitHub
  y envíamelas aquí

Ejemplo 3 — Briefing diario por cron

hermes
> cada día laboral a las 7:30am, recopila: (1) top 10 HN de anoche,
  (2) mis notis de GitHub sin leer, (3) el clima en Buenos Aires.
  Envía como email a santiago@ejemplo.com
⚠️ Gotcha común

La lista de permitidos de Telegram necesita tu ID numérico (ej: 123456789), no tu @alias. Usa @userinfobot en Telegram para obtenerlo.

7. El bucle de aprendizaje

Esta es la sección más importante. Si entiendes el bucle de aprendizaje, entiendes por qué Hermes está diseñado así.

¿Por qué Hermes mejora con el tiempo?

Después de cada tarea —o cada ~5 llamadas a herramientas— Hermes hace una retrospectiva: ¿funcionó? ¿qué tomó demasiado tiempo? ¿hay un patrón reutilizable? Cuando la respuesta es sí, escribe una nueva skill o actualiza la memoria.

Esto es lo opuesto a un chat sin estado. Un chat sin estado tira todo al final de cada conversación. Hermes lo escribe.

Memoria acotada (una feature, no un bug)

La memoria se guarda en tres lugares:

Los límites pequeños son deliberados: fuerzan a Hermes a decidir qué vale la pena conservar.

Skills: procedimientos ejecutables (no notas)

Una skill es un archivo markdown en ~/.hermes/skills/<nombre>/SKILL.md que describe: cuándo activarse, cómo ejecutarse, qué contexto necesita. Mientras que Claude Code guarda datos sobre ti, Hermes guarda procedimientos reutilizables.

💡 La regla de las 5 llamadas

Las skills no se auto-generan tras cada tarea — sería ruidoso. Se generan cuando Hermes detecta repetición: normalmente tras 5+ llamadas a herramientas sobre un mismo patrón. El día 1 tu directorio de skills está vacío. El día 30 tienes 20+ skills gestionando tu vida.

8. Skills esenciales para instalar

Hay 643 skills comunitarias en el Hub. Estas son las 5 que todo usuario debería tener desde el día 1:

  1. LLM Wiki (builtin) — Referencia condensada estilo Karpathy para cualquier tema. Ideal para ponerte al día rápidamente.
  2. gstack (trusted) — Automatización de navegador, QA testing y revisiones de diseño.
  3. OpenAI taps (trusted) — Expone primitivas de function-calling de OpenAI como herramientas de Hermes.
  4. Manim (official) — Genera animaciones matemáticas desde texto. Adictivo.
  5. security-audit (official) — Escanea un repo en busca de vulnerabilidades comunes.
hermes skills install <nombre>
hermes skills browse           # Explorador interactivo
hermes skills search telegram  # Búsqueda por palabra clave
hermes skills info <nombre>    # Inspeccionar antes de instalar

Los skills vienen en 4 niveles de confianza: Builtin (viene con Hermes), Official (de Nous), Trusted (verificados), Community (el resto, léelos antes de instalarlos).

9. Siguientes pasos

Ya instalaste Hermes, elegiste modelo, ejecutaste un workflow y entiendes el bucle de aprendizaje. Tres caminos desde aquí:

10. FAQ

¿Hermes Agent es gratis?

Sí, Hermes es gratis y open-source (MIT). Pagas solo por la API del modelo que uses. Con Ollama tu coste puede ser $0.

¿Funciona sin conexión a internet?

Sí. Instálalo con Ollama o LM Studio y desconéctate. Memoria, skills y cron funcionan offline. Eso sí, los modelos locales son más débiles llamando herramientas.

¿Necesito GPU?

No — si usas un proveedor API, cualquier laptop vale. Necesitas GPU solo si ejecutas el modelo localmente.

¿Mis datos se envían a algún sitio?

Solo al proveedor que configures. Hermes no tiene telemetría. Memoria, skills y sesiones viven en tu disco. Con un modelo local, tus datos nunca salen de tu máquina.

¿Cómo actualizo Hermes?

hermes update

Hermes se auto-actualiza. Te dice qué cambió, respalda tu config y aplica la nueva versión. Versión actual: v0.10.0 (abril 2026).