Todo lo que necesitas para entender y personalizar Hermes Agent. Habilidades que evolucionan solas, memoria de tres niveles, optimización GEPA y cómo pasar de 1 a 10 agentes que trabajan para ti 24/7.
Hermes Agent superó las 90.000 estrellas de GitHub en dos meses. Los desarrolladores están construyendo silenciosamente agentes de IA personales que aprenden su flujo de trabajo, recuerdan su contexto y funcionan 24/7.
Cada agente de IA que has usado tiene el mismo problema: lo olvida todo en cuanto termina tu sesión.
Tus preferencias de codificación, las convenciones del proyecto que le corregiste tres veces, la solución que tardó 10 minutos en descubrir ayer. Todo desaparecido. La próxima sesión, empiezas desde cero.
Hermes Agent de Nous Research adopta un enfoque fundamentalmente diferente. Viene con un barcado con un bucle de aprendizaje que:
- Recuerda entre sesiones
- Escribe sus propias habilidades reutilizables
- Las poda en segundo plano
- Y las valida fuera de línea mediante un motor evolutivo llamado GEPA
Ningún otro agente de código abierto combina los tres. Ni siquiera OpenClaw.
Esta guía cubre cómo funciona este bucle de aprendizaje, qué hace cada capa de memoria y cómo configurar todo desde cero.
Al principio.
Al final, tendrás tres agentes completamente aislados ejecutándose en tu máquina: un programador (que usa tu Claude Code), un investigador profundo y un diseñador, cada uno con su propia personalidad, memoria, habilidades y bot de Telegram.
Mira esto:
<payload-block id_="blk_1" type="upload" />
Toda la configuración toma minutos y todo aquí es reproducible en tu propio hardware.
Nota: Todas las ilustraciones de esta guía fueron diseñadas por Pixel, uno de los agentes de Hermes que aprenderás a construir al final. Esté atento a ellas mientras lee.
¡Comencemos!
Cómo leer esto
Dos mitades: teoría primero, práctica después.
¿Paso práctico después.
¿Poco tiempo? Salta a "Ponerse en marcha". Los comandos funcionan por sí solos.
Pero la teoría vale la pena. Saber cómo las habilidades evolucionan por sí mismas, cómo se compone la memoria y cuándo GEPA demuestra su valía es la diferencia entre usar Hermes como un chatbot con notas y usarlo como algo que se acumula.
Lo que viene:
- Qué es realmente es Hermes Agent. La propuesta, más una comparación con OpenClaw.
- Cómo está construido. Arquitectura en un diagrama.
- Antes de la memoria: ¿Quién es el agente? SOUL.md, la capa de identidad.
- El sistema de memoria. Tres niveles, tres velocidades.
- Habilidades que evolucionan solas. Manuales escritos por el agente más el Curador.
- GEPA. Optimización de habilidades fuera de línea.
- Ponerse en marcha. Instalación, Telegram, primer agente.
- Ejecutar múltiples agentes. Perfiles, tres personajes, resúmenes programados.
- Personalizar los agentes según tus necesidades.
Qué es Hermes y qué lo hace arquitectónicamente diferente
La propuesta en una línea: un agente que mejora cuanto más lo usas.
Lo que hace que esto sea real es que tres capacidades normalmente separadas residen en un mismo marco: aprendizaje de habilidades en tiempo de ejecución, memoria persistente de múltiples capas y un pipeline opcional de entrenamiento con pesos. Ningún otro agente de código abierto incluye las tres.
La comparación más cercana en el ecosistema abierto es OpenClaw. Ambos son persistentes, compatibles con mensajería, pero toman decisiones arquitectónicas opuestas.
Una descripción clara del blog de Kilo lo resume: "Hermes empaqueta una puerta de enlace alrededor de un agente de aprendizaje. OpenClaw empaqueta un agente alrededor de una puerta de enlace de mensajería".
<payload-block id_="blk_2" type="upload" />
Cómo está construido
Antes de que el bucle de aprendizaje tenga sentido, necesitas una idea básica de cómo está estructurado Hermes.
Todo fluye a través de una única clase AIAgent en un script run_agent.py. CLI, puerta de enlace de mensajería, ejecutor por lotes, integración con IDE: todos son puntos de entrada al mismo agente central.
Esto es lo que hace que la historia de independencia de plataforma funcione realmente.
<payload-block id_="blk_3" type="upload" />
El bucle principal es de estilo ReAct y síncrono. Construir el mensaje del sistema, verificar si es necesario comprimir, hacer una llamada API interrumpible, ejecutar cualquier llamada de herramientas, repetir.
Algunos detalles que importarán más adelante:
- El agente puede ejecutar comandos en seis lugares diferentes. Terminal local, Docker, SSH, Modal, Daytona o Singularity. Mismo código, solo un cambio de configuración. Mueve la ejecución de tu portátil a un servidor GPU en la nube sin tocar nada más.
- Funciona con casi cualquier modelo. Una capa de traducción enruta cualquier proveedor a través de uno de tres formatos de API. Por eso puedes cambiar de Claude a GPT a Gemini a Ollama local con un comando y nada se rompe.
- El agente tiene un límite máximo de 90 turnos por tarea. Sin él, un agente atascado en un bucle (reintentando una API fallida, releyendo el mismo archivo) quemaría tus créditos en silencio. Los subagentes comparten el mismo presupuesto, por lo que una cadena de delegación descontrolada no puede colarse.
E.
Eso es suficiente andamio. Ahora la parte interesante.
Antes la parte interesante.
Antes de la memoria: ¿Quién es el agente?
Antes de llegar a la memoria y las habilidades que evolucionan solas, hay una capa que está por encima de ambas: la identidad.
La memoria es lo que el agente sabe. Las habilidades son cómo hace las cosas. Pero ninguna te dice quién es cuando aparece. Sin una capa de identidad, cada agente se siente como el mismo agente con diferentes sombreros.
Hermes resuelve esto con un solo archivo: SOUL.md.
Vive en ~/.hermes/SOUL.md y ocupa el puesto #1 en el mensaje del sistema, antes de que se cargue cualquier otra cosa. Define la personalidad del agente, el tono, el estilo de comunicación y los límites estrictos.
SOUL.md está escrito a mano y es estático. Lo escribes una vez, lo ajustas con el tiempo, y se mantiene consistente en todos los proyectos y sesiones. Si el archivo falta, Hermes recurre a una identidad predeterminada incorporada.
¿Por qué importa esto importa para la historia de automejora? Porque todo lo que sigue (la memoria que el agente escribe, las habilidades que crea, la forma en que consolida el conocimiento) ocurre a través del lente de esta identidad.
SOUL.md es el marco fijo. La memoria y las habilidades son las partes móviles dentro de él.
El sistema de memoria: tres niveles, tres velocidades
Hermes no tiene una única "memoria". Tiene tres capas, cada una diseñada para un propósito diferente.
<payload-block id_="blk_4" type=" type="upload" />
Nivel 1: Dos archivos Markdown pequeños.
En el núcleo hay dos archivos almacenados en disco:
- MEMORY.md (máx. 2.200 caracteres) contiene las notas del agente sobre tu entorno, convenciones del proyecto, peculiaridades de herramientas y lecciones aprendidas.
- USER.md (máx. 1.375 caracteres) contiene tu perfil: nombre, preferencias de comunicación, nivel de habilidad y cosas que evitar.
Ambos se inyectan en el mensaje del sistema como una instantánea congelada cuando comienza una sesión. Si el agente escribe una nueva entrada de memoria en medio de la sesión, ese cambio persiste en disco inmediatamente pero no aparecerá en el mensaje del sistema hasta la próxima sesión.
Cuando la memoria se llena (~80% de capacidad, mostrado como un porcentaje en el encabezado del mensaje del sistema), el agente tiene que consolidar.
Fusiona entradas relacionadas en versiones más densas y con más información, para que solo sobreviva la información útil.
Nivel 2: Búsqueda de texto completo en sesiones.
Cada conversación (CLI y mensajería) se almacena en SQLite con búsqueda de texto completo. El agente puede buscar semanas de conversaciones pasadas desde aquí.
La compensación es clara: el Nivel 1 siempre está en contexto pero es pequeño. El Nivel 2 tiene capacidad ilimitada pero requiere una búsqueda activa más un resumen por LLM.
Los hechos críticos viven en la memoria. Todo lo demás se puede buscar bajo demanda.
Nivel 3: Proveedores de memoria externos (8 complementos).
Para una memoria persistente más profunda, Hermes incluye 8 proveedores conectables que se ejecutan junto con la memoria incorporada (nunca la reemplazan). Solo uno puede estar activo a la vez.
Cuando cualquier proveedor externo está activo, Hermes obtiene automáticamente recuerdos relevantes antes de cada turno, sincroniza los turnos de conversación después de cada respuesta y extrae recuerdos al final de la sesión.
<payload-block id_="blk_5" type="upload" />
Habilidades que evolucionan solas: el agente escribe sus propios manuales
La memoria maneja los hechos. Las habilidades manejan los procedimientos.
Las habilidades son archivos Markdown con metadatos YAML, y funcionan como la memoria procedimental del agente: no lo que sabe, sino cómo hace las cosas.
Aquí está la anatomía de una habilidad:
Para mantener bajos los costos de tokens, las habilidades usan divulgación progresiva:
<payload-block id_="blk_6" type="upload" />
- Nivel 0: El agente ve solo nombres + descripciones (~3k tokens para el catálogo completo)
- Nivel 1: Carga el contenido completo de la habilidad cuando realmente cuando realmente la necesita
- Nivel 2: Puede profundizar en archivos de referencia específicos dentro de una habilidad
El bucle de automejora.
Este es el diferenciador principal. El agente crea sus propias habilidades de forma autónoma usando la herramienta skill_manage. La creación de habilidades se activa cuando:
- El agente completa una tarea compleja (5+ llamadas de herramientas)
- Encuentra errores o callejones sin salida y halla el camino correcto
- El usuario corrige su enfoque
- Descubre un flujo de trabajo no trivial
Así que el bucle funciona así: el agente encuentra un problema → lo resuelve mediante prueba y error → guarda el enfoque exitoso como un archivo SKILL.md → la próxima vez que encuentre un problema similar, carga la habilidad y sigue el procedimiento probado en lugar de redescubrir el enfoque desde cero.
La herramienta admite seis acciones: crear, parchear (corrección específica, preferida porque es eficiente en tokens), editar (reescritura completa), eliminar, write_file y remove_file.
<payload-block id_="blk_7" type="upload" />
El Curador: recolección de basura para habilidades.
Sin mantenimiento, las habilidades creadas por el agente se acumulan. Terminas con docenas de manuales estrechos y superpuestos que desperdician tokens y contaminan el catálogo.
El Curador es un sistema de mantenimiento en segundo plano que se encarga de esto. Se ejecuta en una verificación de inactividad (no un demonio cron): si han pasado 7 días desde la última ejecución y el agente ha estado inactivo durante 2+ horas, una bifurcación en segundo plano del agente se activa con su propia caché de mensajes, sin tocar la conversación activa.
Opera en dos fases:
- Transiciones automáticas (deterministas, sin LLM): Las habilidades no utilizadas durante 30 días se vuelven obsoletas. Las habilidades no utilizadas durante 90 días se archivan.
- Revisión por LLM (hasta 8 iteraciones): Un agente bifurcado inspecciona todas las habilidades creadas por el agente y decide por habilidad si mantener, parchear, consolidar o archivar.
Dos restricciones importantes:
- El Curador nunca toca las habilidades incluidas o instaladas desde el hub. Solo las creadas por el agente.
- Nunca elimina automáticamente. El peor resultado es el archivo en ~/.hermes/skills/.archive/, que se puede recuperar con un comando.
Antes de cada paso del Curador, Hermes toma una instantánea tar.gz de todo el directorio de habilidades. La reversión es un comando, y las reversiones son reversibles.
También puedes fijar habilidades críticas con hermes curator pin <skill> para protegerlas del archivo y la eliminación. Los parches y las ediciones aún se realizan, por lo que el agente puede mejorar una habilidad fijada sin que tengas que desanclarla primero.
<payload-block id_="blk_8" type="upload" />
GEPA: Evolucionar habilidades fuera de línea con trazas de ejecución
Aquí es donde se pone interesante.
El bucle de aprendizaje dentro del agente (creación de habilidades + Curador) tiene una debilidad conocida:
- El agente tiende a la autocomplacencia. Casi siempre piensa que lo hizo bien, incluso cuando no fue así. Los comentarios de la comunidad lo han confirmado esto.
- El mismo sistema que genera habilidades automáticamente también puede sobrescribir personalizaciones manuales con versiones peores.
Aquí es donde entra GEPA.
GEPA (Genetic-Pareto Prompt Evolution) no está integrado en el tiempo de ejecución de Hermes. Vive en un repositorio complementario (NousResearch/hermes-agent-self-evolution) y opera como un pipeline de optimización fuera de línea. Publicado como un artículo oral de ICLR 2026, con licencia MIT.
La idea central: en lugar de preguntar al agente "¿lo hiciste bien?", GEPA lee las trazas de ejecución para entender por qué fallaron las cosas, luego propone mejoras específicas mediante búsqueda evolutiva.
El pipeline:
- Leer la habilidad actual del repositorio de Hermes
- Generar un conjunto de datos de evaluación (casos de prueba sintéticos mediante Claude Opus, historial de sesiones real de SQLite o conjuntos dorados seleccionados manualmente)
- Ejecutar el optimizador GEPA: leer trazas de ejecución → entender puntos de fallo → generar variantes candidatas
- Evaluar candidatos usando puntuación LLM-as-judge con rúbricas (no aprobado/reprobado binario)
- Aplicar restricciones: el conjunto de pruebas completo debe pasar al 100%, las habilidades deben estar por debajo de 15KB, se preserva la compatibilidad de caché, el propósito semántico no debe desvía
- La mejor variante sale como un PR contra el repositorio de Hermes. Nunca una confirmación directa.
No se requiere GPU. Todo se ejecuta a través de llamadas API. Costo: aproximadamente $2-10 por ejecución de optimización.
Esto es algo que se puede omitir inicialmente, pero es muy efectivo cuando te encuentras con un muro y no quieres gastar tiempo y dinero en ajuste fino (RL/GRPO)
Más detalles en este repositorio →
<payload-block id_="blk_9" type="upload" />
Recientemente escribí un artículo sobre GEPA.
Es una gran alternativa para probar antes de pasar a un ajuste fino completo o basado en RL.
<payload-block id_="blk_10" type="upload" />
Bien, para resumir:
SOUL.md establece la identidad. El bucle de tiempo de ejecución captura la experiencia. El Curador mantiene la biblioteca limpia. GEPA se asegura de que lo que está en la biblioteca realmente funcione.
Esa es toda la teoría. Ahora pongámoslo en marcha en tu máquina.
Ponerse en marcha
Linux, macOS o WSL2. Python 3.11+ viene con el instalador. 8 GB de RAM está bien para uso basado en API.
Instalación en una línea:
<code-segment id="0" lang="text">
curl -segment>
Ejecuta el asistente de configuración. Te guía a través del proveedor, clave API, modelo y herramientas:
Comienza a chatear en la terminal:
Conéctalo a Telegram:
Si quieres hablar con tu agente desde tu teléfono en lugar de la terminal, apúntalo a un bot de Telegram.
Obtén un token de bot de @BotFather (ejecuta /newbot), luego obtén tu ID de usuario de Telegram de @userinfobot.
Eso es todo. Tienes un agente funcionando:
Qué hay en ~/.hermes/
Justo después de la instalación, tu directorio de inicio recibe una nueva carpeta.
Vale la pena entender la disposición porque todo lo que hagas con Hermes toca una de estas rutas.
Algunos archivos merecen un vistazo más detenido.
- config.yaml es la fuente de verdad para todo lo que no es secreto. Elección de modelo, backend de terminal, habilitación de herramientas, servidores MCP: todo está aquí. Edita con hermes config edit o establece valores uno a uno a la vez con hermes config set <clave> <valor>.
- .env guarda tus secretos. Claves API, tokens de bot, contraseñas. Hermes enruta automáticamente los valores que parecen secretos aquí.
- SOUL.md es el puesto #1 en el mensaje del sistema, antes de todo lo demás. Capa de identidad, cubierta anteriormente.
- skills/ es donde vive todo el bucle de aprendizaje. Cada habilidad que el agente crea, más todo lo que instales, aterriza aquí.
- state.db es la base de datos SQLite que respalda la búsqueda de sesiones. Modo WAL seguro, indexado con FTS5. Esto es lo que hace que "¿qué discutimos hace tres semanas?" funcione realmente.
No editarás la mayor parte de esto manualmente. Pero conocer la disposición hace que todo lo demás encaje.
Agregar nuevas habilidades
Hermes mantiene su propio Skills Hub oficial con 687 habilidades en 18 categorías. El desglose:
- 87 habilidades integradas que vienen con el agente
- 79 habilidades opcionales que puedes habilitar bajo demanda
- 16 de Anthropic (frontend-design, pdf, pptx, docx, mcp-builder, etc.)
- 505 de LobeHub (contribuciones más amplias de la comunidad)
<payload-block id_="blk_11" type="upload" />
También puedes agregar cualquier repositorio de GitHub como un tap personalizado:
Así es como compartirías habilidades en un equipo o mantendrías tu propia colección privada.
Pasar de 1 a 10 agentes
Un agente está bien. Múltiples agentes especializados es donde Hermes se vuelve interesante.
Hermes tiene una función de primera clase para esto llamados perfiles. Cada perfil es una instancia de Hermes completamente aislada con su propia configuración, memoria, habilidades, sesiones y SOUL.md. No comparten nada por defecto.
Configuraremos tres: un diseñador, un programador y un investigador.
Crear un equipo
--clone copia la configuración y .env de tu perfil predeterminado como punto de partida.
Dar a cada uno su propio bot de Telegram
Cada perfil necesita su propio bot de BotFather. Telegram solo permite una conexión por token, así que compartir rompe las cosas.
Ejecuta /newbot tres veces con BotFather y guarda los tres tokens. Luego ejecuta el asistente de puerta de enlace una vez por perfil:
La configuración es exactamente la misma que la de un agente regular, donde puedes crear nuevos bots en BotFather y conectarlos a sus respectivos agentes.
Dar a cada uno una personalidad a través de SOUL.md
Aquí es donde los agentes se vuelven genuinamente diferentes entre sí. Edita el SOUL.md de cada perfil.
Diseñador en ~/.hermes/profiles/designer/SOUL.md:
Mira estos ejemplos:
<payload-block id_="blk_12" type="upload" />
Programador en ~/.hermes/profiles/programmer/SOUL.md:
Investigador en ~/.hermes/profiles/researcher/SOUL.md:
Personalizar el programador: enrutar la ejecución a través de Claude Code
El programador es más interesante si no solo escribe código él mismo, sino que delega la ejecución al CLI de Claude Code. Hermes orquesta. Claude Code hace las ediciones de archivos, ejecuta comandos, gestiona git. Hermes lee el resultado y decide qué sigue.
Así es como ejecuto el mío sobre mi suscripción a Claude Max. Sin clave API separada. Claude Code usa las credenciales de Max automáticamente.
Inicia una sesión y envía este único mensaje de activación:
<code-segment id="13" lang="3" lang="text">
Ya tengo una suscripción a Claude Max. Eres mi ingeniero de personal que
me ayuda con mis tareas de codificación diarias, y en segundo plano usas
Claude Code para todas las ejecuciones. Configúrate en consecuencia.
El programador instalará la habilidad autonomous-ai-agents/claude-code por su cuenta, verificará que claude esté en el PATH y comenzará a usarla para la ejecución de código. A partir del siguiente mensaje, cualquier cosa relacionada con la codificación (leer archivos, escribir código, ejecutar pruebas, confirmar, enviar) se enrutará a través de Claude Code en segundo plano.
Dos cosas que vale la pena saber:
- Asegúrate de que claude esté en tu PATH antes de activarlo. which claude debería imprimir una ruta binaria real.
- Claude Code tiene un modo de impresión (de un solo disparo, rápido, sin TUI) y un modo interactivo (sesión tmux completa). El programador elige según la tarea. No necesitas pensarlo.
Personalizar el diseñador: enseñarle tu estilo visual
El diseñador se vuelve realmente útil cuando puede generar imágenes en tu estilo, no resultados genéricos de IA. El patrón: alimentarlo diseños de referencia, dejar que los estudie, pedirle que cree una habilidad que genere nuevas imágenes en el mismo estilo.
Este es el bucle de automejora utilizado como mecanismo de configuración. En lugar de escribir una habilidad a mano, le estás mostrando al agente buenos ejemplos y pidiéndole que codifique el patrón él mismo.
Inicia una sesión con el diseñador y pega tus imágenes de referencia (arrastrar y soltar en la CLI, o adjuntar en Telegram). Luego envía este mensaje:
<code-segment id="4" lang="text">
Estudia estas imágenes de referencia y crea una habilidad que capture mi estilo visual. La habilidad debe generar nuevas imágenes en el mismo estilo usando el proveedor de imágenes que tengas configurado (Nano Banana a través de OpenRouter). Escribe la habilidad como un script de Python que construye un mensaje informado por mi estilo y lo envíe a la API. Guarda la habilidad en mi perfil de diseñador.
El diseñador.
El diseñador estudiará las referencias, escribirá el SKILL.md, generará el script de Python, lo guardará en ~/.hermes/profiles/designer/skills/my-design-style/ y verificará que el script se ejecute.
Si ya ejecutaste hermes setup y elegiste OpenRouter como proveedor, la clave ya está en el .env del perfil del diseñador gracias a --clone. Si no, agrega una vez:
A partir de entonces, pedirle al diseñador una nueva ilustración activa la habilidad. Escribe un mensaje informado por tu huella de estilo, llama a Nano Banana a través de OpenRouter y guarda la salida.
El mismo patrón funciona para cualquier salida específica de estilo. Proporciona contenido de referencia, pídele al agente que construya una habilidad que reproduzca el patrón. Introducciones de boletines, hilos de X, comentarios de revisión de código, cualquier cosa donde la consistencia importe.
Programar trabajo: Cron en inglés sencillo
El SOUL.md del investigador dice que es responsable de un resumen diario de Telegram. Eso implica un trabajo que se ejecuta en su propio horario, sin que tú recuerdes pedirlo. Para eso está Hermes cron.
Hermes incluye un programador incorporado. El demonio de la puerta de enlace late cada 60 segundos, ejecuta los trabajos pendientes en sesiones de agente aisladas y entrega la salida a la plataforma de mensajería que especifiques. Los trabajos sobreviven a los reinicios. Viven en ~/.hermes/cron/jobs.json y la salida va a ~/.hermes/cron/output/.
<payload-block id_="blk_13" type="upload" />
La parte interesante: no escribes expresiones cron. Describes lo que quieres en inglés y Hermes lo convierte.
Configurar el resumen diario del investigador
Abre una sesión con el investigador y envía este mensaje:
<code-segment id="5" lang="text">
Crea un trabajo cron que se ejecute todos los días a las 8 a.m. y me envíe un resumen de las principales noticias de IA del día anterior. Usa la web y busca envíalo a este chat de Telegram.
El investigador crea el trabajo usando su herramienta cronjob, el destino de entrega predeterminado es el chat actual (Telegram en este caso), y el programador se hace cargo a partir de ahí. Verifica que se haya creado:
Deberías ver el trabajo con su próxima hora de ejecución programada. Mañana a las 8 a.m., tu Telegram se ilumina con el resumen. No se necesita más acción.
Otros patrones útiles
La sintaxis de cron es flexible. Algunas variaciones que vale la pena conocer:
- Retrasos de un solo uso. /cron add 30m "Recuérdame revisar la compilación" se ejecuta una vez en 30 minutos.
- Intervalos recurrentes. /cron add "cada 2h" "Verificar estado del servidor" se ejecuta cada dos horas.
- Expresiones cron estándar. /cron add "0 9 \ \ 1-5" "..." para control preciso. Días laborables a las 9 a.m., en este caso.
- Adjuntar habilidad. /cron add "cada 1h" "Resumir nuevos elementos del feed" --skill blogwatcher carga una habilidad antes de ejecutar el mensaje.
También puedes encadenar trabajos. La salida de un cron se convierte en la entrada del siguiente cron mediante un indicador context_from. Útil para automatizaciones de múltiples etapas donde quieres que un paso de investigación alimente un paso de escritura.
Eso es todo.
Gracias por leer. Déjame saber en los comentarios qué te gustaría que cubra a continuación.
Si aprendes mejor con video, estoy publicando una guía completa de Hermes Agent en YouTube y X en un par de días.
¡Mantente atento!
¡Saludos! :)
