Guía práctica de Sergie Code para la comunidad de mi canal de YouTube.
Objetivo: instalar Hermes Agent en una VPS Linux, conectarlo con Telegram y dejarlo funcionando como servicio.
Arquitectura de esta guía:
Telegram → Hermes Gateway → proveedor LLM (OpenAI / Claude / otro)Esta guía no instala Ollama en la VPS. La parte de Ollama/local puede hacerse después si la VPS tiene recursos suficientes.
Video de YouTube: https://youtu.be/ORel2kDjGzw
Link para 60% de descuento VPS: https://www.hostgator.la/7697-10-3-9.html
Hermes: https://hermes-agent.nousresearch.com/
Ollama: https://ollama.com/
Telegram: https://desktop.telegram.org/
- VPS Linux.
- Acceso SSH.
- IP de la VPS.
- Usuario con
sudoo accesoroot. - Una API key/proveedor compatible con Hermes.
- Una cuenta de Telegram.
Hermes necesita al menos un proveedor de modelos configurado. Actualmente soporta, entre otros, OpenAI, Anthropic, OpenRouter, Ollama y endpoints OpenAI-compatible.
Desde Windows PowerShell:
ssh root@IP_DE_TU_VPSSi el HOSTING te asignó otro usuario:
ssh USUARIO@IP_DE_TU_VPScat /etc/os-releaseY:
uname -mPara esta guía esperamos una distribución Linux compatible y normalmente arquitectura:
x86_64
sudo apt update && sudo apt upgrade -yInstalar herramientas básicas:
sudo apt install -y git curl xz-utilsUsar el instalador oficial:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashRecargar el entorno:
source ~/.bashrcComprobar la instalación:
hermes --versionEjecutar diagnóstico:
hermes doctorSi hermes doctor muestra errores, resolverlos antes de continuar.
Ejecutar:
hermes modelHermes abrirá el configurador interactivo.
Elegir el proveedor que quieras utilizar.
Ejemplos:
- OpenAI
- Anthropic
- OpenRouter
- Nous Portal
- Custom endpoint
Para esta demo podés usar OpenAI o Anthropic.
Importante: una suscripción de ChatGPT/Claude no necesariamente equivale a tener acceso a la API. Para utilizar directamente las APIs necesitás configurar las credenciales correspondientes.
Ejecutar:
hermesProbar con algo simple:
Hola. Respondé solamente: Hermes funciona correctamente.
Si responde correctamente:
Ctrl+C
para salir.
No seguimos con Telegram hasta que Hermes funcione desde la terminal.
Abrir Telegram y buscar:
@BotFather
Enviar:
/newbot
Elegir un nombre.
Ejemplo:
Hermes VPS Demo
Elegir un username terminado en bot.
Ejemplo:
sergie_hermes_demo_bot
BotFather devolverá un token parecido a:
1234567890:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
NO lo publiques en GitHub, Gist, capturas de pantalla ni videos.
Si alguna vez se filtra, revocalo desde BotFather.
En Telegram buscar:
@userinfobot
Enviar:
/start
El bot devolverá un número.
Ejemplo:
123456789
Este es el ID numérico que vamos a utilizar para permitir el acceso a nuestro bot.
Ejecutar:
hermes gateway setupSeleccionar:
Telegram
Cuando lo solicite:
Pegar el token obtenido desde BotFather.
Introducir el Telegram User ID numérico.
Ejemplo:
123456789
La configuración normal de Hermes se encuentra bajo:
~/.hermes/
Los secretos se almacenan en:
~/.hermes/.env
La configuración no secreta está en:
~/.hermes/config.yaml
Podemos revisar la configuración con:
hermes config getNo publiques el contenido de:
~/.hermes/.env
porque puede contener API keys y tokens.
Antes de instalarlo como servicio:
hermes gatewayDeberías ver mensajes indicando que el gateway arrancó y que Telegram se conectó.
Ahora abrir Telegram y buscar nuestro bot.
Enviar:
Hola Hermes
Si responde:
Telegram → Hermes → LLM → Telegram
ya tenemos la integración funcionando.
Para detenerlo:
Ctrl+C
Ahora no queremos probar solamente el chatbot.
Queremos comprobar que Hermes puede utilizar herramientas.
Desde Telegram probar algo como:
Creá un archivo llamado hermes-test.txt dentro de /tmp que contenga:
Hola desde Hermes Agent.
Después, desde SSH:
cat /tmp/hermes-test.txtDeberíamos obtener:
Hola desde Hermes Agent.
Esto demuestra la diferencia entre:
Chatbot:
pregunta → respuesta
y:
Agent:
pregunta → razonamiento → herramienta → acción → resultado
Una vez comprobado que Telegram funciona:
hermes gateway installIniciar el servicio:
hermes gateway startComprobar:
hermes gateway statusPara seguir los logs en tiempo real:
journalctl --user -u hermes-gateway -fAhora mandá un mensaje al bot desde Telegram y observá los eventos en la terminal.
Para salir:
Ctrl+C
Si estás utilizando un usuario normal:
sudo loginctl enable-linger $USEREsto permite que los servicios de usuario continúen ejecutándose después de cerrar la sesión SSH.
Este paso es importante antes de considerar terminada la instalación.
Reiniciar:
sudo rebootEsperar unos segundos.
Volver a conectarse:
ssh USUARIO@IP_DE_TU_VPSComprobar:
hermes gateway statusDespués abrir Telegram y enviar:
Hola Hermes, ¿seguís funcionando?
Si responde después del reboot:
Hermes quedó funcionando como servicio persistente.
Para la configuración estándar de Telegram, Hermes utiliza long polling.
Eso significa que Hermes inicia las conexiones salientes hacia Telegram para consultar nuevos mensajes.
Por lo tanto, para esta primera implementación:
- No necesitamos Nginx.
- No necesitamos un dominio.
- No necesitamos SSL.
- No necesitamos configurar un webhook.
- No necesitamos exponer un puerto HTTP de Hermes a Internet.
La VPS solamente necesita poder realizar conexiones salientes a Internet.
La arquitectura queda:
INTERNET
│
▼
┌─────────────┐
│ TELEGRAM │
└──────┬──────┘
│
▼
┌──────────────────┐
│ SERVIDOR VPS │
│ │
│ Hermes Gateway │
│ │ │
│ ▼ │
│ Hermes │
│ │ │
└────────┼─────────┘
│
┌────────┼────────┐
▼ ▼ ▼
OpenAI Claude OpenRouter
Una de las ventajas de Hermes es que podemos cambiar el proveedor sin cambiar nuestra integración de Telegram.
Salir de la sesión de Hermes si está abierta y ejecutar:
hermes modelElegir otro proveedor.
Por ejemplo:
OpenAI
o:
Anthropic
Después volver a iniciar el gateway:
hermes gateway restartLa arquitectura sigue siendo:
Telegram
↓
Hermes
↓
Nuevo proveedor
↓
Telegram
Una demostración sencilla puede hacerse en este orden:
hermesPreguntar:
¿Qué podés hacer además de responder preguntas?
Enviar:
Hola Hermes
Enviar:
Creá un archivo llamado demo.txt con el texto:
"Creado por un AI Agent"
Comprobar desde SSH:
cat /tmp/demo.txthermes modelCambiar:
OpenAI
por:
Anthropic
o viceversa.
Telegram sigue siendo el mismo.
Hermes sigue siendo el mismo.
La herramienta sigue siendo la misma.
Lo que cambió es el modelo/proveedor:
┌── OpenAI
│
Telegram → Hermes ├── Anthropic
│
└── Ollama
Esto permite explicar un concepto clave:
El agente y el modelo no son necesariamente la misma cosa.
Nunca publiques:
TELEGRAM_BOT_TOKEN
OPENAI_API_KEY
ANTHROPIC_API_KEY
OPENROUTER_API_KEY
No publiques:
cat ~/.hermes/.enven un tutorial, Gist o video.
Si una credencial aparece accidentalmente en una captura o grabación:
- Revocarla.
- Generar una nueva.
- Actualizar la configuración de Hermes.
Para Telegram, BotFather permite revocar el token del bot.
La versión de esta guía utiliza un proveedor cloud para simplificar la instalación.
Si querés instalar Ollama en la misma VPS:
Telegram
↓
Hermes
↓
Ollama
↓
Modelo local
primero verificá:
free -hy:
lscpuSi la VPS tiene GPU:
lspci | grep -i -E "nvidia|amd"No conviene instalar un modelo grande de Ollama sin comprobar antes los recursos disponibles.
Hermes requiere un contexto de al menos 64K tokens para sus workflows de agente. En Ollama esto debe configurarse del lado del servidor/modelo.
hermes --version
hermes doctor
hermes
hermes modelhermes gateway
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway stop
hermes gateway status
hermes gateway restartjournalctl --user -u hermes-gateway -fhermes config get~/.hermes/config.yaml
~/.hermes/.env
- Hermes Agent: https://hermes-agent.nousresearch.com/
- Instalación: https://hermes-agent.nousresearch.com/docs/getting-started/installation
- Quickstart: https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
- Providers: https://hermes-agent.nousresearch.com/docs/integrations/providers
- Telegram: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram
- Telegram Assistant: https://hermes-agent.nousresearch.com/docs/guides/team-telegram-assistant/
Sergie Code
Contenido creado para la comunidad de mi canal de YouTube.
Si esta guía te sirvió, podés seguir el canal para más contenido sobre:
- AI Agents
- LLMs
- Software Engineering
- Automatización
- Ollama
- MCP
- OpenAI
- Claude
- Desarrollo con IA