Hermes Agent para principiantes: tu propio asistente de IA en Telegram y WhatsApp

La mayoría de la gente conoce la IA a través de una página web: escribes una pregunta, te da una respuesta, y en cuanto cierras la pestaña se olvida de ti por completo. Hermes Agent es otra forma de esa misma idea. Piénsalo menos como una máquina expendedora y más como contratar a un asistente: vive en un lugar que tú controlas, recuerda lo que le dijiste la semana pasada, y le escribes desde las apps de chat que ya tienes en el teléfono. Lo creó Nous Research, es de código abierto (o sea, el código es público y de uso libre), y lo puedes correr sin pagarle ni un centavo a Nous. Solo pagas por el "cerebro" de IA que le conectes, y hasta para eso hay opciones gratis. Esta guía está pensada para alguien que nunca ha instalado una herramienta de desarrollador. Vamos a explicar cada término técnico la primera vez que aparezca, y al final vas a tener tu propio asistente respondiéndote en Telegram y WhatsApp.

01 · Qué es Hermes Agent realmente

Dejemos de lado las palabras de moda. Hermes Agent es un programa, un software, que corres en una computadora. Todo su trabajo es ser un agente: un ayudante que no solo conversa, sino que de verdad hace cosas por ti, paso a paso, hasta terminar una tarea.

Va la analogía. Un chatbot básico es como un desconocido sabio que conoces una sola vez: útil en el momento, pero arrancas de cero cada vez. Hermes se parece más a un asistente personal que de verdad tienes contratado. Tres cosas lo hacen distinto:

• Recuerda. Su memoria se mantiene de una conversación a otra. Dile el lunes cómo te gustan tus reportes y el viernes todavía lo sabe. (La mayoría de las webs de chat se olvidan de todo apenas las cierras.)
• Aprende sus propios atajos. Cuando da con una buena forma de hacer algo, la guarda como un skill reutilizable, como una tarjeta de receta que se escribe a sí mismo, y la próxima vez sigue la receta en vez de reinventarla. En palabras de Nous Research, "nunca olvida cómo resolvió un problema."
• Vive en tu cancha. Corre en una computadora que tú controlas: tu laptop o un servidor pequeño que rentes. Eso es una ventaja de privacidad y control. Tu asistente no es una pestaña en la web de otra persona.

Para funcionar, Hermes necesita un "cerebro", el modelo de IA que de verdad piensa. Tú no lo construyes; conectas Hermes a un proveedor y le das una clave (de eso hablamos enseguida). Hermes es compatible con muchos proveedores, incluyendo Claude de Anthropic, OpenAI, OpenRouter, Hugging Face, y el propio Nous Portal de Nous Research.

02 · Para qué te sirve

Lo concreto le gana a lo abstracto, así que aquí van cosas reales que la gente hace con él:

• Un asistente personal en el bolsillo. Le escribes por Telegram o WhatsApp como le escribirías a un colega: "resúmeme este artículo", "redáctame una respuesta a este correo", "recuérdame qué decidimos sobre el presupuesto".
• Cosas que corren solas, a una hora fija. Le puedes pedir, en español de todos los días, que haga algo cada mañana, como "mándame un resumen de noticias a las 8am", y te lo entrega en el chat sin que muevas un dedo. (El nombre técnico de programar tareas por hora es cron, pero no tienes que aprenderlo.)
• Buscar cosas en vivo. Puede buscar en la web, leer páginas, ver imágenes y hasta generar imágenes, útil para "búscame tres artículos recientes sobre X" o "¿qué dice esta captura de pantalla?".
• Delegar en otros ayudantes. Para trabajos más grandes puede levantar pequeños sub-ayudantes, cada uno trabajando en su propia caja aislada y en paralelo, como un jefe que reparte partes de un proyecto entre un equipo pequeño.

03 · Qué necesitas antes de empezar

Una lista corta. Nada de esto es del otro mundo:

1. Una computadora donde correrlo. Funciona en Linux, macOS (las Mac de Apple), Windows (con un ayudante llamado WSL2, o de forma nativa) y hasta en teléfonos Android (con una app llamada Termux). Una laptop normal sirve de sobra para probarlo.
2. Una key de un proveedor de IA, también llamada API key. Es el enchufe del "cerebro". Una API key es una contraseña secreta larga que le permite a Hermes hablar con el modelo de una empresa de IA en tu nombre. La consigues registrándote con un proveedor: Claude (Anthropic), OpenAI, OpenRouter o Nous Portal, entre otros.
3. Unos treinta minutos y ganas de copiar y pegar unos cuantos comandos en una terminal (una terminal es esa ventana de puro texto donde escribes comandos en vez de hacer clic en botones).

Una nota sobre el costo, dicha de frente. El software de Hermes en sí es gratis (código abierto, licencia MIT, una licencia permisiva que le deja a cualquiera usarlo libremente). Por lo que sí podrías pagar es por el cerebro de IA: cada proveedor cobra por el uso. Nous Portal anuncia una estructura de niveles llamada Free, Plus, Super, Ultra, donde los niveles de pago incluyen créditos mensuales y acceso a más de 300 modelos y herramientas.

04 · Instalar Hermes (la configuración inicial, una sola vez)

Esta es la parte que se ve aterradora y no lo es. Vas a pegar una sola línea en tu terminal, y un instalador (un script que te deja todo listo) hace el trabajo pesado. Descarga Hermes y las piezas de apoyo que necesita, sin pedirte permisos de administrador.

En Mac, Linux, Windows-con-WSL2 o Termux, pega esta sola línea:

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

En Windows (PowerShell), el equivalente es:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

(El instalador de Windows es generoso: trae todo lo que Hermes necesita y no pide permisos de administrador.)

Cuando termine, recarga tu terminal para que detecte el programa nuevo. Pega la línea que corresponda a tu caso:

source ~/.bashrc   # o: source ~/.zshrc

Ahora corre el asistente de configuración, un flujo guiado de preguntas y respuestas que configura Hermes por ti:

hermes setup

Te va a preguntar qué proveedor de IA quieres y cuál es tu API key. Pégala cuando te la pida. Hay otros comandos que vale la pena conocer (no los necesitas todos hoy):

• hermes model elige qué cerebro de IA usar.
• hermes tools activa habilidades extra como la búsqueda web.
• hermes gateway prende el "conmutador" que conecta tus apps de chat (este lo vas a usar mucho).
• hermes doctor es un autodiagnóstico que te dice qué está mal configurado cuando algo falla.

Una vez que Hermes esté corriendo, también puedes escribir slash-commands dentro del chat con él, como /new (empezar de cero), /reset, /skills (ver lo que ha aprendido) o /usage (revisar cuánto has gastado).

05 · Conectar Hermes a Telegram (el camino fácil)

Telegram es el lugar más amigable para empezar: es gratis, Telegram lo soporta oficialmente para bots, y no hay riesgo de que te bloqueen. Un bot, aquí, es una cuenta automática a la que le escribes como si fuera una persona.

Paso 1, crea el bot. En Telegram, abre el chat con @BotFather (el bot oficial de Telegram para crear bots). Mándale el mensaje /newbot. Te pide un nombre visible y luego un username que tiene que terminar en "bot". Cuando termines, BotFather te entrega un código secreto largo llamado token. Se ve algo así como 123456789:ABCdefGHI.... Trata ese token como la llave de tu casa: cualquiera que lo tenga puede controlar tu bot, así que guárdalo bien.

Paso 2, encuentra tu propio ID de usuario. Hermes necesita saber que tú tienes permiso para hablarle (para que los desconocidos no puedan). En Telegram, escríbele a @userinfobot; te responde con tu ID numérico de usuario, un número pelado, no tu @username. Copia ese número.

Paso 3, cuéntale a Hermes. La forma más cómoda es correr el asistente del gateway:

hermes gateway setup

Elige Telegram, luego pega tu token del bot y tu ID numérico cuando te los pida. (Si algún día quieres que varias personas lo usen, listas sus IDs separados por comas.)

Paso 4, préndelo y salúdalo. Arranca el conmutador:

hermes gateway

Ahora abre Telegram y escríbele a tu bot nuevo. Debería responderte. Y ya está. Tienes un asistente de IA funcionando en el bolsillo.

Un extra pequeño: si agregas el bot a un grupo, Telegram les esconde a los bots la mayoría de los mensajes por defecto (es un ajuste de privacidad). Para que vea todo en un grupo, abre @BotFather, escoge tu bot, ve a Bot Settings, luego a Group Privacy, y apágalo. El detalle que casi todos pasan por alto: después de cambiar ese ajuste tienes que sacar el bot del grupo y volverlo a agregar, si no, el cambio no toma efecto.

06 · Conectar Hermes a WhatsApp (funciona, pero con cuidado)

Con WhatsApp se puede, pero viene con advertencias honestas, así que lee esta sección antes de lanzarte.

La advertencia grande, primero. WhatsApp no recibe con los brazos abiertos a bots de terceros como este. Hermes se conecta haciéndose pasar por un "dispositivo vinculado", igual que funciona WhatsApp Web. Como es no oficial, hay dos reglas que importan de verdad: usa un segundo número de teléfono dedicado, nunca tu WhatsApp personal, y no le escribas a gente que no te haya escrito primero. Romper cualquiera de las dos es buscarte un ban.

Qué necesitas: un segundo número de teléfono para el bot, más un teléfono con WhatsApp instalado para escanear un código. Entre las opciones gratis o baratas para un segundo número están Google Voice (gratis, solo en EE.UU.), un SIM prepago (unos cuantos dólares) o una app de VoIP como TextNow.

Paso 1, arranca el asistente de WhatsApp.

hermes whatsapp

Te pregunta si quieres modo bot (un asistente aparte en su propio número, la opción de siempre) o modo self-chat. Instala las piezas necesarias y luego muestra un código QR (ese cuadrito de barras) ahí mismo en tu terminal.

Paso 2, vincúlalo. En el teléfono que tiene el número del bot, abre WhatsApp, ve a Configuración, luego a Dispositivos vinculados, toca Vincular un dispositivo y apunta la cámara al código QR de tu terminal. Eso los empareja.

Paso 3, define quién tiene permiso. Abre el archivo de configuración de Hermes (.hermes/.env) y asegúrate de que tenga líneas como estas. Vienen a decir "WhatsApp está prendido, es un bot, y este es quién puede hablarle":

WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot
WHATSAPP_ALLOWED_USERS=15551234567

(Ese número es el número completo de la persona permitida, sin el signo de más; separa varios con comas, o usa un solo asterisco para permitir a todo el mundo, lo cual no te recomendamos.)

Paso 4, prende el gateway igual que antes:

hermes gateway

Ahora un mensaje desde tu número permitido le llega al bot, y este te responde.

07 · Los errores que todos cometen (y cómo esquivarlos)

Hay unas cuantas cosas con las que tropieza casi todo principiante. Conocerlas de antemano te ahorra una tarde entera:

• El gateway tiene que seguir corriendo. Los mensajes solo fluyen mientras Hermes esté "prendido". Cierras la terminal y se detiene, como desenchufar un teléfono. Para un asistente siempre encendido, instálalo como un servicio de fondo para que aguante los reinicios (Hermes tiene un comando para eso, hermes gateway install).
• Telegram es la opción segura por defecto. Es oficial, gratis, te puede escribir primero (buenísimo para esos resúmenes diarios) y no te va a costar un ban. Quédate con él salvo que necesites WhatsApp por algo específico.
• Para WhatsApp, la regla del número dedicado no es opcional. Tu número personal sumado a automatización no oficial es la receta perfecta para que te baneen la cuenta. Gasta los pocos dólares en un segundo número.
• Mantén tus secretos en secreto. Tu token del bot y esa carpeta de sesión de WhatsApp dan, cada uno, control total. Nunca pegues un token en un chat público ni en una captura de pantalla, ni lo subas a código que vayas a compartir. (En Ilustrari construimos un gestor de secretos, Infuse, justamente porque "¿dónde guardo estas claves de forma segura?" es una pregunta con la que todo builder se topa. Pero para un solo bot personal, basta con mantenerlos fuera de la vista pública.)
• Las notas de voz necesitan una pieza extra. Tal como viene, Hermes no transcribe mensajes de voz hasta que le agregas un proveedor de speech-to-text, y necesita un programita llamado ffmpeg para mandar respuestas de voz como audio que se pueda reproducir. Si eso te interesa, configúralo; si no, ignóralo.

No busques que quede perfecto en la primera corrida. Pon a hablar Telegram, mándale una petición de verdad, y de ahí vas creciendo.

Puedes encontrar Hermes Agent, su documentación y la app de escritorio en el sitio oficial: https://hermes-agent.nousresearch.com/ (opens in new tab). También hay una versión de escritorio descargable (para Mac, Windows y Linux) con las mismas funciones, por si prefieres no vivir en la terminal.