¿Qué es Hermes Agent?

Hermes Agent es un framework de agente de IA de código abierto desarrollado por Nous Research que se ejecuta en tu terminal, plataformas de mensajería e IDEs. Pertenece a la misma categoría que Claude Code (Anthropic), Codex (OpenAI) y OpenClaw — agentes autónomos de codificación y ejecución de tareas que usan herramientas (tool calling) para interactuar con tu sistema.

Lo que hace único a Hermes Agent frente a otras alternativas:

  • Auto-mejora mediante skills — aprende de la experiencia guardando procedimientos reutilizables como skills. Cuando resuelve un problema complejo, descubre un flujo de trabajo o recibe una corrección, persiste ese conocimiento para futuras sesiones.
  • Memoria persistente entre sesiones — recuerda quién eres, tus preferencias, detalles del entorno y lecciones aprendidas.
  • Multiplataforma — el mismo agente se ejecuta en Telegram, Discord, Slack, WhatsApp, Signal, email y más de 10 plataformas con acceso completo a herramientas.
  • Independiente del proveedor de IA — cambia de modelo y proveedor sin modificar nada más. OpenRouter, Anthropic, OpenAI, DeepSeek, modelos locales y más de 20 proveedores compatibles.
  • Totalmente extensible — plugins, servidores MCP, herramientas personalizadas, webhooks, programación de tareas con cron y todo el ecosistema Python.

Con más de 169.000 estrellas en GitHub, Hermes Agent se ha convertido en el agente de IA open source más popular del momento. En esta guía te mostraré paso a paso cómo instalarlo en tu propio VPS.

Prerrequisitos

  • Un VPS con Ubuntu 22.04 LTS o superior (también compatible con Debian 12, macOS y Windows WSL)
  • Mínimo 2 GB de RAM (4 GB recomendados para sesiones largas)
  • Python 3.10+ y pip instalados
  • Git instalado
  • Una clave de API de OpenRouter, Anthropic, DeepSeek, OpenAI u otro proveedor compatible
  • Opcional: token de bot de Telegram (desde @BotFather) para interactuar desde Telegram

Paso 1: Conectarse al VPS y preparar el sistema

Accede a tu VPS por SSH y actualiza los paquetes:

ssh usuario@tu-vps-ip
sudo apt update && sudo apt upgrade -y

Instala las dependencias necesarias:

sudo apt install -y python3 python3-pip python3-venv git curl wget build-essential ffmpeg

Paso 2: Instalar Hermes Agent

La forma más rápida y recomendada es usar el script de instalación oficial:

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

Este script:

  • Clona el repositorio en ~/.hermes/hermes-agent/
  • Crea un entorno virtual de Python con todas las dependencias
  • Instala el comando hermes en el PATH del sistema
  • Crea la estructura de directorios inicial en ~/.hermes/

Después de la instalación, cierra y vuelve a abrir tu terminal, o simplemente ejecuta:

source ~/.bashrc

Verifica que Hermes se instaló correctamente:

hermes --version
hermes doctor

Paso 3: Configurar el proveedor de IA

Ejecuta el asistente de configuración interactivo para elegir tu modelo y proveedor:

hermes setup

Esto te guiará por varias secciones. También puedes configurar solo el modelo directamente:

hermes model

Verás una lista interactiva de proveedores compatibles. Algunas opciones populares:

  • OpenRouter — acceso a cientos de modelos con una sola clave API
  • DeepSeek — muy económico, excelente rendimiento
  • Anthropic (Claude) — ideal para tareas complejas de codificación
  • OpenAI — el clásico, compatible con GPT-4o y o-series

Tus claves API se guardan en ~/.hermes/.env. Puedes editarlas manualmente:

nano ~/.hermes/.env

Ejemplo de archivo .env:

OPENROUTER_API_KEY=sk-or-v1-tu-clave-aqui
# O para DeepSeek:
DEEPSEEK_API_KEY=sk-tu-clave-aqui
# O para Anthropic:
ANTHROPIC_API_KEY=sk-ant-tu-clave-aqui

Paso 4: Probar Hermes en la terminal

Antes de configurar el gateway, prueba que Hermes funciona correctamente:

hermes chat -q "Hola, ¿cómo estás? Dame un resumen del sistema en el que estoy corriendo."

Si todo está bien, verás la respuesta del agente. También puedes iniciar una sesión interactiva:

hermes

Dentro de la sesión, escribe /help para ver todos los comandos disponibles, o /quit para salir.

Paso 5: Configurar el Gateway para Telegram

El gateway de Hermes permite que tu agente se conecte a plataformas de mensajería. Para configurar Telegram:

hermes gateway setup

Selecciona Telegram de la lista y pega el token de tu bot. También puedes configurarlo manualmente en el archivo .env:

TELEGRAM_BOT_TOKEN=1234567890:ABCdefGHIjklmNOPqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=tu_user_id_de_telegram

Para obtener tu ID de usuario en Telegram, escribe /start al bot @userinfobot.

Una vez configurado, puedes iniciar el gateway para probarlo:

hermes gateway run

Si todo funciona, abre Telegram, busca tu bot y envía un mensaje. Recibirás una respuesta de tu agente Hermes corriendo en el VPS.

Paso 6: Configurar como servicio systemd (producción)

Para que Hermes Agent se ejecute 24/7 y se reinicie automáticamente al arrancar el VPS, instálalo como servicio systemd:

hermes gateway install

Este comando crea e instala automáticamente el servicio systemd. Luego puedes controlarlo con:

hermes gateway start     # Iniciar el servicio
hermes gateway status    # Verificar estado
hermes gateway stop      # Detener el servicio
hermes gateway restart   # Reiniciar

Si prefieres hacerlo manualmente, aquí tienes un archivo de servicio de ejemplo:

sudo nano /etc/systemd/system/hermes-gateway.service

[Unit]
Description=Hermes Agent Gateway
After=network.target

[Service]
Type=simple
User=tu_usuario
WorkingDirectory=/home/tu_usuario
ExecStart=/home/tu_usuario/.hermes/hermes-agent/.venv/bin/python -m hermes_cli.main gateway run
Restart=always
RestartSec=10
Environment=HERMES_HOME=/home/tu_usuario/.hermes

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable hermes-gateway.service
sudo systemctl start hermes-gateway.service
sudo journalctl -u hermes-gateway.service -f   # Ver logs en tiempo real

⚠️ Importante: Si el gateway se detiene al cerrar la sesión SSH, habilita linger para tu usuario:

sudo loginctl enable-linger $USER

Paso 7: Configurar herramientas (toolsets)

Hermes viene con más de 20 conjuntos de herramientas que puedes activar o desactivar según tus necesidades:

hermes tools

Esto abre una interfaz interactiva para gestionar toolsets. Algunos de los más útiles:

  • terminal — ejecutar comandos en el servidor (activado por defecto)
  • web — búsqueda web y extracción de contenido
  • browser — automatización de navegador
  • file — leer, escribir, buscar y editar archivos
  • vision — análisis de imágenes
  • delegation — delegar tareas a subagentes
  • cronjob — programar tareas periódicas

Los cambios en los toolsets requieren reiniciar la sesión (/reset en el chat).

Paso 8: Configuración avanzada

Usar perfiles (profiles)

Los perfiles permiten ejecutar múltiples instancias independientes de Hermes con configuraciones aisladas:

hermes profile create trabajador --clone
hermes profile list
hermes profile use trabajador

Agregar servidores MCP

Los servidores MCP (Model Context Protocol) extienden las capacidades de Hermes con herramientas externas:

hermes mcp add filesystem --command "npx" --args "-y,@modelcontextprotocol/server-filesystem,/ruta/permitida"
hermes mcp add github --command "npx" --args "-y,@modelcontextprotocol/server-github"
hermes mcp list

Programar tareas con Cron

Hermes tiene un sistema de cron integrado para ejecutar tareas periódicas:

hermes cron create "every day at 9am" \
  --prompt "Revisa los logs del servidor y envíame un resumen" \
  --deliver telegram

Instalar skills

Los skills son procedimientos reutilizables que mejoran a Hermes con el tiempo:

hermes skills browse           # Explorar skills disponibles
hermes skills install ID       # Instalar un skill
hermes skills list             # Ver skills instalados

Comandos útiles para el día a día

ComandoQué hace
hermesInicia sesión interactiva
hermes doctorDiagnóstico del sistema
hermes config setCambiar configuración
hermes modelCambiar modelo/proveedor
hermes updateActualizar a la última versión
hermes sessions listVer sesiones recientes
/newNueva sesión (dentro del chat)
/modelCambiar modelo sobre la marcha
/compressComprimir contexto manualmente

Solución de problemas comunes

"Comando hermes no encontrado"

El script de instalación añade Hermes al PATH. Si no funciona, ejecuta source ~/.bashrc o añade manualmente export PATH="$HOME/.local/bin:$PATH" a tu ~/.bashrc.

El gateway no responde en Telegram

  • Verifica que el token del bot sea correcto: grep TELEGRAM_BOT_TOKEN ~/.hermes/.env
  • Revisa los logs: journalctl -u hermes-gateway.service -f
  • Asegúrate de haber iniciado conversación con /start

Error de autenticación con el proveedor de IA

  • Ejecuta hermes doctor para diagnosticar
  • Verifica que la clave API esté correcta en ~/.hermes/.env
  • Confirma que el proveedor tenga saldo disponible

El gateway se detiene al cerrar SSH

Solución: sudo loginctl enable-linger $USER y luego hermes gateway restart. Esto permite que los servicios systemd del usuario sigan ejecutándose después de desconectarse.

Los cambios de configuración no se aplican

Los cambios en toolsets y skills requieren una nueva sesión (/reset en el chat o hermes gateway restart). Los cambios de configuración requieren reiniciar el proceso.

Conclusión

Hermes Agent es mucho más que un chat de IA en tu terminal. Es un framework completo de agente autónomo que puede crecer contigo: empieza usándolo desde la terminal y, a medida que lo necesites, conéctalo a Telegram, agrega skills personalizados, programa tareas automáticas, conéctalo a tu IDE y construye flujos de trabajo complejos con múltiples agentes.

Con más de 169.000 estrellas en GitHub y una comunidad activa, Hermes Agent representa el estado del arte en agentes de IA open source. Y al estar en tu propio VPS, tienes control total sobre tus datos, modelos y configuración.

La instalación te toma menos de 5 minutos con el script oficial. ¡Pruébalo y descubre lo que un agente de IA autónomo puede hacer por ti 24/7!