Monta Hermes Agent en un VPS de Hostinger + Telegram (guía completa)

Hermes Agent es un asistente personal de Nous Research: abierto, gratis, vive en un servidor que nunca se apaga y le hablas por Telegram desde el móvil. Esta guía es el camino entero para montarlo en un VPS de Hostinger y conectarlo a Telegram, con los comandos listos para copiar.

Léela primero entera antes de empezar. Todo lo que pongo aquí sale de la documentación oficial; donde meto una recomendación mía la marco como tal.

Aviso honesto antes de empezar

No te voy a vender humo. “Sin saber programar” no es lo mismo que “sin esfuerzo”. No vas a escribir código, pero sí vas a copiar y pegar comandos en una terminal y crear un par de cuentas. Si nunca has tocado una terminal lo puedes hacer igual siguiendo los pasos al pie de la letra, pero reserva una tarde tranquila, no 10 minutos.

Lo que sí te ahorro: entender por qué funciona cada cosa. Tú copia, pega y comprueba que sale lo que digo.

Lo que vas a necesitar:

Una tarjeta para alquilar el servidor (desde ~6,5 $/mes en Hostinger).
Una cuenta de Telegram (la app del móvil).
Una cuenta de Claude (Claude.ai) o de ChatGPT (Plus/Pro) para darle cerebro al asistente. Si ya pagas una de las dos, el cerebro no te cuesta nada extra.

Coste real: el servidor en Hostinger arranca sobre 6,5 $/mes en promoción. Ojo: los precios baratos son con contrato largo y la renovación sube bastante (te lo aviso en el paso 1). El cerebro va aparte y puede salirte a 0 € si reutilizas tu suscripción de Claude o ChatGPT.

Paso 1 — Compra el VPS en Hostinger

El asistente necesita vivir en un ordenador que no se apague nunca. No es el tuyo: alquilas uno en la nube (un VPS) por unos euros al mes.

Entra en hostinger.com/vps-hosting (comparador de planes en hostinger.com/pricing/vps-hosting).
Elige un plan KVM. Mi recomendación:
- KVM 1 (1 vCPU · 4 GB RAM · 50 GB) ~6,49 $/mes → el mínimo razonable. Vale para empezar.
- KVM 2 (2 vCPU · 8 GB RAM · 100 GB) ~8,99 $/mes → cómodo si vas a automatizar mucho.
Sistema operativo: elige Ubuntu en el selector (en la práctica suele ser 24.04 LTS; confírmalo al desplegar).
Pon una contraseña de root y completa la compra.

Recomendación mía (no es dato oficial de Hermes): apunta a 4 GB de RAM como suelo cómodo. Hermes usa un navegador interno (Chromium/Playwright) más Node y Python, y con menos RAM te puede ir justo. La documentación oficial de Hermes no fija requisitos de hardware, así que esto es experiencia, no dogma.

Aviso del precio: esos ~6,5 $/mes son promocionales con contrato largo. Cuando renueve, el precio sube. Tenlo en cuenta antes de comprometerte a 24-48 meses.

¿No quieres Hostinger? Tienes alternativas más abajo (Hetzner, DigitalOcean, Contabo). El resto de la guía es idéntico en cualquiera de ellas: solo cambia la pantalla de compra.

Paso 2 — Entra en tu servidor

Tienes dos formas. La más fácil no necesita instalar nada.

Opción A — Terminal del navegador (recomendada para empezar): entra en tu cuenta de Hostinger, ve al hPanel → dashboard de tu VPS → botón Terminal. Se abre una consola ya logueada como root. No tienes que escribir contraseñas ni configurar nada.

Opción B — Cliente SSH desde tu ordenador: abre la terminal de tu equipo y conéctate con la IP que te da Hostinger en el hPanel:

ssh root@TU_IP

La primera vez te preguntará si confías en el servidor: escribe yes y pulsa Enter. Luego mete la contraseña de root que pusiste al comprar.

Guía oficial de Hostinger para conectar por SSH: hostinger.com/support/5723772 · Tutorial general: hostinger.com/tutorials/how-to-set-up-vps.

Paso 3 — Instala Hermes

Ya dentro del servidor, instalar Hermes es un solo comando. El instalador se baja del repo oficial de Nous Research y se encarga él solo de poner Python 3.11+, Node.js v22, ripgrep y ffmpeg. El único requisito previo que tienes que tener es Git (Ubuntu suele traerlo; si no, apt install -y git).

Copia, pega y dale a Enter:

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

Como en un VPS no hay pantalla ni navegador, conviene instalar en modo headless (servidor sin navegador). Si quieres asegurarte de que no intenta abrir cosas gráficas, el instalador acepta el flag --skip-browser. Y si más adelante necesitas que el navegador interno funcione bien para tareas web, instala sus dependencias del sistema una vez:

sudo npx playwright install-deps chromium

Cuando termine la instalación, recarga la terminal y comprueba que Hermes está disponible:

source ~/.bashrc
hermes

Dónde queda todo (entras como root en el VPS): los datos en /root/.hermes/, el binario en /usr/local/bin/hermes y tus secretos en /root/.hermes/.env. Si usas ~/.zshrc en vez de bash, haz source ~/.zshrc.

Alternativa: si prefieres instalar con pip → pip install hermes-agent y luego hermes postinstall. El repo oficial está en github.com/NousResearch/hermes-agent y las versiones en /releases.

Antes de seguir, pasa el diagnóstico:

hermes doctor

Paso 4 — Dale un cerebro (el modelo)

El asistente necesita un modelo de IA que “piense”. Hermes pide un modelo que soporte al menos 64.000 tokens de contexto (los modelos grandes de Claude y ChatGPT lo cumplen de sobra).

Lo más cómodo es reutilizar tu suscripción. Lanza el menú interactivo:

hermes model

Te sale una lista de proveedores:

Claude (Anthropic): elige Anthropic → te abrirá un login con tu cuenta de Claude.ai.
ChatGPT (OpenAI): elige Codex OAuth (ChatGPT account) → te logueas con tu suscripción ChatGPT Plus/Pro.

En ambos casos el login es por OAuth (te pide entrar con tu cuenta en el navegador). Las credenciales quedan guardadas en ~/.hermes/auth.json.

El gotcha del VPS (importante): el OAuth quiere abrir un navegador… y tu servidor no tiene navegador. Solución sencilla: cuando Hermes te muestre una URL de autorización, cópiala y ábrela en el navegador de tu propio ordenador o móvil, autoriza ahí, y pega de vuelta en la terminal del servidor lo que te pida (un código o una URL de redirección). Listo. La documentación oficial no detalla el flujo sin navegador, pero esto es exactamente como lo hice yo en mi servidor con la cuenta de ChatGPT, y funciona.

Si no quieres OAuth y prefieres una clave de API (pagas por uso): edita el .env o usa el comando de config. Por ejemplo, para Anthropic:

hermes config set ANTHROPIC_API_KEY sk-ant-...

También puedes meter las claves a mano en /root/.hermes/.env (OPENAI_API_KEY=, ANTHROPIC_API_KEY=, OPENROUTER_API_KEY=, etc.) o editarlo directamente con hermes config edit.

Opción “todo en uno” de Nous: si no quieres complicarte con cuentas externas, ellos recomiendan su Portal: hermes setup --portal y luego hermes portal status para comprobarlo.

Comprueba que el cerebro responde antes de seguir. Arranca un chat (recomiendan la interfaz de texto, el TUI):

hermes --tui

Si te contesta, el cerebro funciona. Regla oficial de Hermes: si el chat básico no funciona, no añadas más cosas todavía. Primero chat OK; luego Telegram, skills, voz, etc.

Paso 5 — Conéctalo a Telegram

Aquí empieza la parte que parece magia: hablarle desde el chat del móvil.

5.1. Crea tu bot con BotFather. En Telegram abre @BotFather (es el bot oficial para crear bots) y:

Escribe /newbot.
Ponle un nombre visible (el que verás en el chat).
Ponle un username único que tiene que acabar en bot (por ejemplo miasistente_bot).
BotFather te dará un token con esta pinta: 123456789:ABCdef.... Cópialo y guárdalo en secreto — quien tenga ese token controla tu bot.

5.2. Saca tu User ID. Escríbele un mensaje a @userinfobot y te responderá con tu ID numérico. Apúntalo: sirve para que el bot solo te haga caso a ti.

5.3. Conéctalo en el servidor. Lo más fácil es el asistente interactivo:

hermes gateway setup

Elige Telegram, pega el token y pon tu User ID en la lista de usuarios permitidos.

Si lo prefieres a mano, edita /root/.hermes/.env y añade:
TELEGRAM_BOT_TOKEN=123456789:ABCdef...
TELEGRAM_ALLOWED_USERS=123456789
Si quieres permitir a varias personas, separa los IDs por comas: TELEGRAM_ALLOWED_USERS=111,222.

⚠️ La variable se llama TELEGRAM_BOT_TOKEN, no TELEGRAM_TOKEN. Y siempre configura TELEGRAM_ALLOWED_USERS: si lo dejas vacío, cualquiera que dé con tu bot puede usarlo (y tu cuenta de IA).

5.4. Arranca el gateway:

hermes gateway

(El README también usa hermes gateway start como variante; ambas valen, pero la guía oficial de Telegram usa hermes gateway.) El bot se conecta en unos segundos. Abre el chat de tu bot en Telegram, escríbele “hola” y comprueba que responde. Si responde, ya tienes asistente.

Paso 6 — Déjalo corriendo siempre

Si arrancas Hermes y cierras la terminal/SSH, el proceso se para. Para que el bot siga vivo 24/7 aunque te desconectes, hay que dejarlo como servicio del sistema (un programa que el servidor arranca solo y mantiene encendido). En Ubuntu eso es systemd.

La forma sencilla: cuando hagas hermes gateway setup, sigue las instrucciones que te dé para instalarlo como servicio; Hermes prepara la configuración por ti. La idea es que el servidor:

Arranque el gateway solo al encenderse.
Lo reinicie si se cae.
No dependa de que tú tengas la sesión SSH abierta.

Una vez instalado como servicio, puedes desconectarte tranquilo: el bot sigue respondiéndote en Telegram. Si en algún momento quieres pararlo o reiniciarlo, lo gestionas con los comandos de servicio del sistema (o reabriendo hermes gateway setup).

Paso 7 — Comprobaciones y problemas comunes

Comandos útiles del día a día:

hermes doctor          # diagnóstico general (úsalo si algo falla)
hermes --tui           # abrir el chat en el servidor
hermes --continue      # reanudar la última conversación
hermes sessions list   # ver tus sesiones
hermes update          # actualizar Hermes a la última versión

Síntoma	Qué hacer
`hermes: command not found` tras instalar	`source ~/.bashrc` (o `~/.zshrc`), o sal y vuelve a entrar por SSH
El cerebro no responde en el chat	Repite el paso 4 (`hermes model`) y vuelve a autorizar el OAuth
El bot de Telegram no contesta	Revisa que el `TELEGRAM_BOT_TOKEN` es correcto y que tu ID está en `TELEGRAM_ALLOWED_USERS`; reinicia el gateway
Cualquier desconocido le habla al bot	Tienes `TELEGRAM_ALLOWED_USERS` vacío: ponlo ya
No sé qué falla	`hermes doctor` y lee lo que te marca en rojo

Orden de operaciones (recomendación oficial): chat básico OK → Telegram OK → y después skills, voz y automatizaciones. No metas todo a la vez o no sabrás qué se rompió.

Alternativas de VPS

Hostinger es la protagonista de esta guía por lo fácil que es su panel, pero cualquiera de estas vale (los pasos 2-7 son idénticos):

Proveedor	Plan típico	Precio aprox.	Notas
Hostinger	KVM 1 · 4 GB · 50 GB	~6,5 $/mes	Panel sencillo, terminal en el navegador. Precio promo.
Hetzner (la que uso yo)	CX22 · 2 vCPU · 4 GB · 40 GB	~7,99 €/mes	Mejor relación precio/rendimiento. Ubuntu 24.04.
DigitalOcean	Droplet · 4 GB	~24 $/mes	UX muy pulida y muchísima documentación. Más caro.
Contabo	VPS · 8 GB	~6,99 $/mes	Mucha RAM por poco dinero; rendimiento más variable.

Enlaces: Hetzner Cloud · DigitalOcean Droplets · Contabo VPS.

Fuentes oficiales

Repo de Hermes Agent: github.com/NousResearch/hermes-agent
Versiones: github.com/NousResearch/hermes-agent/releases
Script de instalación: install.sh
VPS de Hostinger: hostinger.com/vps-hosting

La regla de oro

No tienes que entender cómo funciona por dentro para tenerlo en marcha. Primero consigue que responda “hola” en Telegram; a partir de ahí, háblale como a una persona. Lo demás lo va aprendiendo él.

Proyecto oficial → Hermes Agent (Nous Research)

Sígueme para más trucos con IA y automatización → @pabloinpublic

Waitlist de la comunidad → pabloinpublic.com