Hermes Agent hace muchas afirmaciones inusuales para un proyecto de código abierto: recuerda todo, escribe sus propias habilidades, en realidad se auto-mejora. Después de tres semanas ejecutándolo en un Hetzner CCX13, las afirmaciones se mantienen. Aquí está la ruta de instalación que realmente funciona en 2026, con las advertencias que la documentación oficial pasa por alto.
Lo Que Necesitas Antes de Empezar
- Un VPS con Ubuntu 24.04 o Debian 12 (Hermes también soporta macOS y WSL2, esta guía es solo para Linux)
- Acceso SSH con sudo o root
- Mínimo 4 GB de RAM si traes tu propio modelo, 16 GB si auto-hospedas el LLM
- 80 GB de espacio en disco, preferentemente NVMe
- Un endpoint de modelo (clave API de OpenAI, clave API de Anthropic o una instalación local de Ollama)
El tamaño del VPS depende de si auto-hospedas el modelo. Consulta la guía mejor VPS para Hermes Agent para la lista de opciones realistas. En esta tutorial asumo la configuración con tu propio modelo, que es lo que hacen el 80% de los usuarios.
Paso 1: Provisionar el VPS
Accede vía SSH a un Hetzner CCX13 recién creado o equivalente y actualiza el índice de paquetes:
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git ufw
Configura un cortafuegos básico antes de exponer nada a internet:
sudo ufw allow ssh
sudo ufw allow 443/tcp
sudo ufw enable
Salta el puerto 80 a menos que planees ejecutar una interfaz web pública. Las puertas de enlace de mensajería (Telegram, Slack, Discord) usan conexiones salientes y no necesitan puertos entrantes abiertos.
Paso 2: Ejecuta el Script de Instalación de Hermes
El comando de una línea oficial del repositorio Nous Research:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Ejecútalo con tu usuario normal, nunca como root. Es un instalador a nivel de usuario, y esto es lo que hace realmente:
- Instala
uv, el gestor de paquetes de Python de Astral, y un Python 3.11 gestionado - Descarga Node.js,
ripgrepyffmpeg, de los que depende la capa de herramientas - Descomprime Hermes en
~/.hermesy pone el binariohermesen el PATH
Nada acaba en /opt, no se crea ningún usuario del sistema y no se registra ningún servicio. Ese último punto importa en un VPS y lo arreglamos en el Paso 6.
Recarga tu shell para que el nuevo PATH surta efecto:
source ~/.bashrc
Paso 3: Elige un Proveedor de Modelo
Ejecuta el asistente de configuración:
hermes setup
Te guía por el proveedor de modelo y las herramientas que quieras habilitar. Usa tu propia clave de OpenAI, Anthropic u OpenRouter; esta última es la opción pragmática en un VPS porque una sola clave llega a más de 200 modelos, incluidos los de pesos abiertos. Si prefieres no manejar claves separadas para búsqueda, generación de imágenes y TTS, hermes setup --portal te autentica en Nous Portal por OAuth y lo conecta todo a una única suscripción.
Para cambiar de idea más tarde, hermes model cambia el proveedor y hermes tools activa o desactiva herramientas. Confirma que la instalación está sana con:
hermes doctor
Luego inicia una conversación para comprobarlo de extremo a extremo:
hermes
Si la llamada al modelo falla aquí, casi siempre es la clave de API o una errata en la URL del proveedor. hermes doctor nombra el componente que falla en lugar de obligarte a leer logs.
Paso 4: Añade una Puerta de Enlace de Mensajería
La puerta de enlace es lo que hace que merezca la pena el VPS: el agente sigue trabajando con tu portátil cerrado. Telegram es el primer canal más sencillo. Crea un bot con @BotFather y ten el token a mano, luego:
hermes gateway setup
El asistente pregunta qué plataformas habilitar y pide el token. Hermes maneja Telegram, Discord, Slack, WhatsApp, Signal, correo y Home Assistant desde este mismo proceso, así que añade ahora todos los canales que quieras en vez de repetir la configuración después.
Restringe el bot a tu propia cuenta durante la configuración. Un bot de Telegram es accesible públicamente para cualquiera que encuentre su nombre, y un bot abierto gasta tus créditos de modelo en desconocidos. Obtén tu identificador con @userinfobot.
Arráncala:
hermes gateway start
Envía un mensaje a tu bot. La primera respuesta es más lenta porque el agente carga el contexto.
Paso 5: Míralo Escribir una Habilidad
Pídele a Hermes algo no trivial. Buena primera prueba: «Busca en GitHub los repositorios de Python en tendencia esta semana y resume los tres primeros.»
Tras una tarea compleja el agente escribe una habilidad reutilizable. Lista las que tiene:
ls ~/.hermes/skills/
O, desde dentro de una conversación, /skills. La próxima vez que preguntes algo parecido ejecutará el procedimiento guardado en lugar de razonar desde cero, y la habilidad se seguirá refinando con el uso. Las habilidades siguen el estándar abierto agentskills.io, así que son portables.
Aparte, Hermes indexa las conversaciones anteriores con SQLite FTS5, que es lo que le permite responder a «qué te conté sobre la base de datos de staging el mes pasado» sin que se lo vuelvas a explicar.
Paso 6: Mantenlo en Marcha Tras Cerrar Sesión
Este es el paso que se salta cualquier guía rápida, y la razón por la que mucha gente cree que su instalación está rota. hermes gateway start muere al terminar tu sesión SSH. Dos comandos lo arreglan de forma permanente.
Primero, permite que los servicios de tu usuario corran sin una sesión activa:
sudo loginctl enable-linger $USER
Después crea una unidad systemd de usuario en ~/.config/systemd/user/hermes-gateway.service:
[Unit]
Description=Hermes Agent messaging gateway
After=network-online.target
[Service]
ExecStart=%h/.local/bin/hermes gateway start
Restart=always
RestartSec=10
[Install]
WantedBy=default.target
Habilítala y arráncala:
systemctl --user daemon-reload
systemctl --user enable --now hermes-gateway
Revísala con systemctl --user status hermes-gateway y lee su salida con journalctl --user -u hermes-gateway -n 50. Comprueba que la ruta de ExecStart coincide con donde el instalador dejó el binario, cosa que te dirá which hermes.
Ahora la puerta de enlace sobrevive tanto al cierre de sesión como al reinicio.
Paso 7: Configura Copias de Seguridad Automáticas
Todo lo irremplazable vive en ~/.hermes: tus habilidades, tu configuración y el índice de conversaciones. Respáldalo con regularidad:
sudo crontab -e
Agrega:
0 3 * * * tar -czf /backup/hermes-$(date +\%Y\%m\%d).tar.gz -C $HOME .hermes && find /backup -name "hermes-*.tar.gz" -mtime +14 -delete
Esto crea copias diarias a las 3 AM y conserva las últimas 14. Ajusta el destino donde guardes los backups (S3, Backblaze, un disco separado).
¿Qué Sigue?
La primera semana usando Hermes es principalmente para agregar integraciones (Slack, Discord, calendario, GitHub) y verlo acumular habilidades. Alrededor de la tercera semana, la aceleración por las habilidades acumuladas empieza a notarse. A las seis semanas, Hermes es mucho más rápido en tareas recurrentes que un GPT-5 nuevo con prompt.
Algunas integraciones que vale la pena agregar después:
- Puerta de enlace de Slack para uso en equipo
- Herramienta de sistema de archivos para trabajo con documentos
- Integración con calendario para programación
- MCP de GitHub para consultas relacionadas con código
Para ver el panorama general de dónde encaja Hermes en el ecosistema de agentes, consulta la comparación mejor VPS para Hermes Agent. Para otras configuraciones de agentes IA, revisa las guías de SelfHostVPS.
Frequently asked questions
¿Cuánto tiempo tarda realmente en instalarse el Hermes Agent?
La instalación con un solo comando toma de 8 a 12 minutos en un VPS limpio con Ubuntu 24.04, y la mayor parte se va en descargar Python 3.11, Node.js, ripgrep y ffmpeg, que el instalador aprovisiona por ti. Elegir proveedor de modelo con hermes setup añade un par de minutos, y la primera puerta de enlace otros cinco por el token del bot. Desde un VPS frío hasta el agente funcionando: unos 20 minutos.
¿Necesito acceso root en el VPS para instalar Hermes Agent?
No. El instalador es a nivel de usuario: escribe en ~/.hermes y pone el binario hermes en el PATH, así que ejecútalo como usuario normal y nunca como root. Solo necesitas sudo para dos cosas opcionales en un VPS: abrir puertos del cortafuegos y ejecutar loginctl enable-linger para que la puerta de enlace siga corriendo tras cerrar la sesión SSH. Instalar como root es la forma más común de acabar con un Hermes que no se puede actualizar limpiamente.
¿Puedo instalar Hermes Agent en hosting compartido o solo en un VPS?
Solo en VPS. Hermes necesita procesos en segundo plano persistentes para las puertas de enlace de mensajería, acceso a archivos SQLite y la capacidad de enlazar puertos para la interfaz web opcional. El hosting compartido bloquea los tres. El VPS más barato de 5 EUR de Hetzner o Contabo funciona bien con Hermes; en hosting compartido simplemente no se podrá instalar.
¿Qué pasa si el VPS se reinicia? ¿Se reinicia Hermes automáticamente?
Por sí solo no. El instalador no registra ningún servicio, así que tras un reinicio no queda nada corriendo hasta que vuelvas a arrancar la puerta de enlace. El Paso 6 más abajo configura una unidad systemd de usuario junto con lingering y lo resuelve en unos dos minutos. Tus datos sobreviven igualmente: habilidades, configuración e historial viven en ~/.hermes y un reinicio no los toca.