Skip to content

Instantly share code, notes, and snippets.

@sergiecode
Last active September 10, 2026 10:10
Show Gist options
  • Select an option

  • Save sergiecode/04994dd05bd19ec6f6180bb76886a85d to your computer and use it in GitHub Desktop.

Select an option

Save sergiecode/04994dd05bd19ec6f6180bb76886a85d to your computer and use it in GitHub Desktop.
HERMES + VPS + TELEGRAM

Hermes Agent + Telegram en una VPS

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.


Links importantes:

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/


Requisitos

  • VPS Linux.
  • Acceso SSH.
  • IP de la VPS.
  • Usuario con sudo o acceso root.
  • 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.


Paso 1 — Conectarse por SSH

Acción

Desde Windows PowerShell:

ssh root@IP_DE_TU_VPS

Si el HOSTING te asignó otro usuario:

ssh USUARIO@IP_DE_TU_VPS

Paso 2 — Comprobar el sistema operativo

cat /etc/os-release

Y:

uname -m

Para esta guía esperamos una distribución Linux compatible y normalmente arquitectura:

x86_64

Paso 3 — Actualizar el servidor

sudo apt update && sudo apt upgrade -y

Instalar herramientas básicas:

sudo apt install -y git curl xz-utils

Paso 4 — Instalar Hermes Agent

Usar el instalador oficial:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Recargar el entorno:

source ~/.bashrc

Comprobar la instalación:

hermes --version

Ejecutar diagnóstico:

hermes doctor

Si hermes doctor muestra errores, resolverlos antes de continuar.


Paso 5 — Configurar el proveedor de LLM

Ejecutar:

hermes model

Hermes 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.


Paso 6 — Probar Hermes antes de conectar Telegram

Ejecutar:

hermes

Probar 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.


Paso 7 — Crear el bot de Telegram

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

Guardar ese token de forma segura.

NO lo publiques en GitHub, Gist, capturas de pantalla ni videos.

Si alguna vez se filtra, revocalo desde BotFather.


Paso 8 — Obtener el Telegram User ID

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.


Paso 9 — Configurar Telegram en Hermes

Ejecutar:

hermes gateway setup

Seleccionar:

Telegram

Cuando lo solicite:

Bot token

Pegar el token obtenido desde BotFather.

Allowed users

Introducir el Telegram User ID numérico.

Ejemplo:

123456789

Paso 10 — Comprobar la configuración

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 get

Atención

No publiques el contenido de:

~/.hermes/.env

porque puede contener API keys y tokens.


Paso 11 — Ejecutar el Gateway manualmente

Antes de instalarlo como servicio:

hermes gateway

Deberí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

Paso 12 — Hacer una prueba de agente

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.txt

Deberíamos obtener:

Hola desde Hermes Agent.

Esto demuestra la diferencia entre:

Chatbot:
pregunta → respuesta

y:

Agent:
pregunta → razonamiento → herramienta → acción → resultado

Paso 13 — Instalar Hermes Gateway como servicio

Una vez comprobado que Telegram funciona:

hermes gateway install

Iniciar el servicio:

hermes gateway start

Comprobar:

hermes gateway status

Paso 14 — Ver los logs

Para seguir los logs en tiempo real:

journalctl --user -u hermes-gateway -f

Ahora mandá un mensaje al bot desde Telegram y observá los eventos en la terminal.

Para salir:

Ctrl+C

Paso 15 — Hacer que el servicio sobreviva al logout

Si estás utilizando un usuario normal:

sudo loginctl enable-linger $USER

Esto permite que los servicios de usuario continúen ejecutándose después de cerrar la sesión SSH.


Paso 16 — Probar después de reiniciar la VPS

Este paso es importante antes de considerar terminada la instalación.

Reiniciar:

sudo reboot

Esperar unos segundos.

Volver a conectarse:

ssh USUARIO@IP_DE_TU_VPS

Comprobar:

hermes gateway status

Después abrir Telegram y enviar:

Hola Hermes, ¿seguís funcionando?

Si responde después del reboot:

Hermes quedó funcionando como servicio persistente.


Paso 17 — Comprobar que no necesitamos abrir puertos

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.


Configuración final

La arquitectura queda:

                    INTERNET
                       │
                       ▼
                ┌─────────────┐
                │   TELEGRAM  │
                └──────┬──────┘
                       │
                       ▼
             ┌──────────────────┐
             │    SERVIDOR  VPS │
             │                  │
             │  Hermes Gateway │
             │        │         │
             │        ▼         │
             │      Hermes      │
             │        │         │
             └────────┼─────────┘
                      │
             ┌────────┼────────┐
             ▼        ▼        ▼
          OpenAI    Claude   OpenRouter

Cambiar de proveedor

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 model

Elegir otro proveedor.

Por ejemplo:

OpenAI

o:

Anthropic

Después volver a iniciar el gateway:

hermes gateway restart

La arquitectura sigue siendo:

Telegram
   ↓
Hermes
   ↓
Nuevo proveedor
   ↓
Telegram

Demo para una clase

Una demostración sencilla puede hacerse en este orden:

1. Mostrar Hermes desde CLI

hermes

Preguntar:

¿Qué podés hacer además de responder preguntas?

2. Mostrar Telegram

Enviar:

Hola Hermes

3. Mostrar herramientas

Enviar:

Creá un archivo llamado demo.txt con el texto:
"Creado por un AI Agent"

Comprobar desde SSH:

cat /tmp/demo.txt

4. Cambiar el modelo

hermes model

Cambiar:

OpenAI

por:

Anthropic

o viceversa.


5. Repetir exactamente la misma prueba

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.


Seguridad mínima

Nunca publiques:

TELEGRAM_BOT_TOKEN
OPENAI_API_KEY
ANTHROPIC_API_KEY
OPENROUTER_API_KEY

No publiques:

cat ~/.hermes/.env

en un tutorial, Gist o video.

Si una credencial aparece accidentalmente en una captura o grabación:

  1. Revocarla.
  2. Generar una nueva.
  3. Actualizar la configuración de Hermes.

Para Telegram, BotFather permite revocar el token del bot.


Ollama en la VPS

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 -h

y:

lscpu

Si 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.


Comandos de referencia

Hermes

hermes --version
hermes doctor
hermes
hermes model

Telegram Gateway

hermes gateway
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway stop
hermes gateway status
hermes gateway restart

Logs

journalctl --user -u hermes-gateway -f

Configuración

hermes config get

Archivos de configuración

~/.hermes/config.yaml
~/.hermes/.env

Referencias oficiales


Autor

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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment