¿Cansado de que tus proyectos de inteligencia artificial se queden en el “hola mundo”? Con Hermes Agent, puedes crear agentes autónomos que investiguen, codifiquen y desplieguen soluciones por ti. En esta guía, te mostramos cómo pasar de cero a un agente funcional en menos de 30 minutos, desde la instalación básica hasta la orquestación de flujos multiagente, con ejemplos de código, comandos CLI y recomendaciones para optimizar tu contenido.

¿Qué es Hermes Agent y por qué elegirlo para crear agentes?

Hermes Agent es un marco de agentes de inteligencia artificial de código abierto desarrollado por Nous Research que permite interactuar con modelos de lenguaje grandes mediante llamadas a herramientas. A diferencia de soluciones cerradas, Hermes ofrece:

• Auto-mejora mediante habilidades: cada tarea compleja se guarda como una habilidad reutilizable que el agente aprende y reaplica en futuras sesiones.
• Memoria persistente: recuerda preferencias, contexto del entorno y lecciones aprendidas entre sesiones.
• Gateway multiplataforma: el mismo agente opera en Telegram, Discord, Slack, WhatsApp, Signal y correo electrónico, con acceso completo a las herramientas.
• Compatibilidad con múltiples proveedores: puedes cambiar entre OpenRouter, Anthropic, OpenAI, modelos locales, HuggingFace y otros sin modificar el flujo de trabajo.
• Perfiles aislados: permite ejecutar varias instancias de Hermes con configuraciones, habilidades y memoria separadas.

En mi experiencia, la combinación de habilidades y memoria persistente reduce drásticamente el tiempo de puesta en marcha de proyectos de automatización, ya que el agente reutiliza soluciones probadas en lugar de reinventar la rueda cada vez.

Requisitos previos para usar Hermes

• Sistema operativo: Linux (recomendado), macOS o Windows (con WSL2).
• Python: versión 3.10 o superior.
• Dependencias: pip install hermes-agent o uv pip install hermes-agent para entornos aislados.
• Claves de API: al menos una clave de un proveedor (OpenAI, Anthropic, etc.). Guárdalas en ~/.hermes/.env.
• Herramientas opcionales: tmux para sesiones persistentes, git para versionar habilidades.

¿Cómo instalar y configurar Hermes para comenzar a crear agentes?

El proceso de instalación y configuración es sencillo y rápido. Sigue estos pasos para tener tu entorno listo en minutos:

Instalación rápida

Ejecuta el script oficial para instalar Hermes en tu sistema:

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

Configuración inicial

Inicializa el asistente de configuración con el comando:

hermes setup

Este comando te guiará por la selección de modelo, proveedor, conjuntos de herramientas y gateway. Es importante que elijas opciones compatibles con tu infraestructura y necesidades.

Selección del proveedor de modelo

Usa el comando hermes model para elegir un modelo como anthropic/Claude-sonnet-4 o un modelo local mediante llama-cpp. Configura las variables de entorno en el archivo ~/.hermes/.env para garantizar que el agente funcione correctamente.

Habilitación de conjuntos de herramientas

Revisa los conjuntos de herramientas disponibles con hermes tools list y activa los que necesites, como web, terminal, file, skills o delegation. Los cambios tomarán efecto después de un /reset o reinicio del agente.

Prueba inicial

Verifica que el modelo responda correctamente ejecutando:

hermes chat -q "¿Cuál es la capital de Francia?"

Si recibes una respuesta precisa, tu instalación está lista para crear agentes.

¿Qué enfoque debo usar para crear agentes: delegate_task o generar procesos independientes?

La elección del enfoque depende de la duración, la necesidad de interacción y el nivel de aislamiento requerido. A continuación, te explicamos cuándo y cómo usar cada método.

delegate_task (subagentes)

Cuándo usarlo: ideal para tareas que duran minutos, necesitan razonamiento pero no requieren una sesión interactiva prolongada.

Ventajas: menor sobrecarga, comparte el mismo proceso del agente padre y es fácil de pasar contexto mediante el parámetro context.

Ejemplo práctico: investigar un tema y devolver un resumen:

delegate_task(
    goal="Resume los últimos avances en modelos de lenguaje eficientes para dispositivos edge",
    context="Enfócate en documentos de 2024-2025 de arXiv y blogs de NVIDIA, Intel y Google.",
    toolsets=["web","search"]
)

Generación de procesos independientes de Hermes

Cuándo usarlo: perfecto para misiones autónomas que pueden durar horas o días, o cuando se necesita interacción continua, como el desarrollo de una aplicación completa.

Ventajas: aislamiento total de sesión, herramientas y entorno. Permite usar -w (modo worktree) para evitar conflictos de Git.

Método recomendado (PTY + tmux):

# Crear sesión tmux en segundo plano
terminal(command="tmux new-session -d -s agente1 -x 120 -y 40 'hermes'", timeout=10)

# Esperar arranque y enviar primera tarea
terminal(command="sleep 8 && tmux send-keys -t agente1 'Crea una API REST para gestión de usuarios con FastAPI' Enter", timeout=15)

# Leer salida para verificar progreso
terminal(command="sleep 20 && tmux capture-pane -t agente1 -p", timeout=5)

# Envío de seguimiento
terminal(command="tmux send-keys -t agente1 'Añade autenticación JWT y rate limiting' Enter", timeout=5)

# Cierre limpio
terminal(command="tmux send-keys -t agente1 '/exit' Enter && sleep 2 && tmux kill-session -t agente1", timeout=10)

One-shot (sin PTY): para tareas simples de fuego y olvido:

hermes chat -q "Genera un informe de mercado sobre energías renovables en México"

Comparación: delegate_task vs. generación de procesos

¿Cómo asegurar que los agentes sean duraderos y se entreguen correctamente?

Para trabajos que deben sobrevivir al cierre de la sesión actual o que requieren entrega programada, Hermes ofrece dos opciones principales: tareas programadas y gateway.

Tareas programadas (cron jobs)

Ideal para recopilación de datos, reportes diarios o mantenimiento basado en tiempo. Puedes crear tareas programadas con el comando:

hermes cron create '0 9 * * *' --prompt "Resume las noticias de tecnología de las últimas 24 horas y envíalas a mi correo"

Especifica el directorio de trabajo (por defecto /mnt/d/Proyectos/Hermes/blogs), habilidades, modelo alternativo y método de entrega (por ejemplo, deliver='local' para guardar en disco o deliver='telegram:-1001234567890:123' para enviar a un chat).

Los trabajos cron se ejecutan con skip_memory=True por defecto, pero puedes cargar habilidades y modelos específicos para cada ejecución.

Gateway (plataformas de mensajería)

Si deseas que el agente esté disponible continuamente en plataformas como Telegram o Discord, inicia el gateway:

hermes gateway install y luego hermes gateway start.

Los usuarios pueden interactuar con el agente mediante comandos como /agents, /model o /skill, o mensajes libres. Para tareas largas, combina el gateway con background=true y notify_on_complete=true en llamadas a terminal, para recibir una notificación cuando el proceso termine.

Flujo de trabajo recomendado para crear agentes

 A[Instalar Hermes] --> B[Configurar proveedor y modelo]
  B --> C{Habilitar conjuntos de herramientas}
  C -->|Sí| D[Probar con hermes chat]
  C -->|No| B
  D --> E{Elegir enfoque}
  E -->|Tarea corta| F[Usar delegate_task]
  E -->|Tarea larga| G[Generar proceso con tmux]
  F --> H[Validar salida]
  G --> H
  H --> I{¿Funciona?}
  I -->|Sí| J[Guardar como habilidad]
  I -->|No| K[Depurar y repetir]
`

¿Qué mejores prácticas debo seguir al desarrollar agentes con Hermes?

Para sacarle el máximo provecho a Hermes, sigue estas recomendaciones basadas en la experiencia de desarrolladores avanzados:

• Usa habilidades para capturar conocimiento: cada vez que resuelvas un problema complejo (5+ llamadas a herramientas, depuración iterativa, flujo no trivial), guárdalo como habilidad con skill_manage(action='create'). Así el agente lo reutilizará automáticamente.
• Aprovecha la memoria: guarda preferencias (por ejemplo, directorio de trabajo preferido, formato de entrega) con la herramienta memory.
• Controla la aprobación de comandos: configura el modo de aprobación en smart con hermes config set approvals.mode smart.
• Monitorea el uso de tokens: usa /usage o hermes insights --days 7 para revisar el consumo y ajustar modelos o indicaciones.
• Prueba en un perfil separado: crea un perfil de prueba con hermes profile create test --clone.
• Documenta y versiona: guarda los scripts de terminal, las habilidades y los trabajos cron en un repositorio Git.

Solución de problemas comunes en Hermes

Error: “No se encontró el modelo seleccionado”

Causa: el proveedor no está configurado correctamente en ~/.hermes/.env.

Solución: verifica que la variable MODEL_PROVIDER coincida con el proveedor instalado. Ejemplo:

# En ~/.hermes/.env
MODEL_PROVIDER=anthropic
ANTHROPIC_API_KEY=tu_api_key_aquí

Error: “Timeout al ejecutar delegate_task”

Causa: la tarea es demasiado compleja o el timeout es insuficiente.

Solución: aumenta el timeout (ej: timeout=600) o divide la tarea en subpasos.

¿Cómo medir el éxito y mejorar continuamente mis agentes?

Hermes provee herramientas de introspección y análisis para evaluar el rendimiento de tus agentes:

• /agents o /tasks: muestra los subagentes y tareas activas en la sesión actual.
• hermes sessions list o hermes sessions browse: revisa el historial de sesiones.
• hermes insights --days 30: obtiene analíticas de uso de modelos, conjuntos de herramientas y tiempos de respuesta.
• hermes doctor: verifica dependencias, configuraciones y credenciales.
• hermes curator status: revisa el estado de tus habilidades creadas por el agente.

Casos de uso reales con Hermes Agent

Asistente de investigación automatizada

Un desarrollador usó Hermes para crear un agente que:

• Monitorea arXiv en busca de nuevos documentos sobre modelos de lenguaje.
• Resume los hallazgos clave y los envía a un canal de Discord.
• Guarda los resúmenes en un repositorio de GitHub para referencia futura.

Herramientas usadas: web, file, git.

Comando: hermes cron create '0 8 * * *' --prompt "Busca nuevos documentos en arXiv sobre modelos de lenguaje y envía un resumen a Discord"

Desarrollador de APIs autónomo

Un equipo de startup usó Hermes para:

• Generar una API de FastAPI con autenticación JWT.
• Desplegarla en Render usando terminal(background=true).
• Documentar el código con Swagger.

Checklist antes de desplegar un agente

• [ ] Verificar que el proveedor de modelos esté configurado en ~/.hermes/.env.
• [ ] Probar el agente con hermes chat -q "Hola".
• [ ] Habilitar los conjuntos de herramientas necesarias (hermes tools list).
• [ ] Guardar las habilidades reutilizables con skill_manage(action='create').
• [ ] Configurar background=true para tareas largas.
• [ ] Revisar el consumo de tokens con hermes insights --days 7.

Preguntas frecuentes sobre Hermes Agent

¿Puedo usar Hermes con modelos locales como Llama 3?

Sí, Hermes soporta modelos locales mediante llama-cpp. Configura el proveedor con hermes model set local --path /ruta/a/tu/modelo.gguf y asegúrate de tener suficiente RAM/GPU.

¿Cómo migro un agente de un proveedor a otro (ej: de OpenAI a Anthropic)?

Usa hermes model switch y actualiza las variables de entorno en ~/.hermes/.env. Hermes mantendrá las habilidades y memoria, pero verifica la compatibilidad de los conjuntos de herramientas.

¿Es posible ejecutar Hermes en un servidor remoto?

Sí, con tmux o screen para sesiones persistentes. Para acceso seguro, usa Tailscale o SSH con -t para mantener la sesión activa.