Hermes Agent: la guía definitiva (instalación, modelo gratis y memoria)

La guía definitiva de Hermes Agent

Si buscas un agente de IA que trabaje para ti de verdad — que recuerde lo que hacéis, aprenda de tu forma de trabajar y ejecute tareas solo — Hermes es probablemente la mejor opción open source que hay ahora mismo. En esta guía lo montamos de principio a fin: qué es, cómo instalarlo en un servidor propio, cómo conectarle la app de escritorio, cómo usar modelos gratis, cómo delegarle tareas completas con Kanban, cómo darle memoria persistente y cómo enchufarlo a Telegram y WhatsApp.

Es una guía larga a propósito. Al terminarla tendrás tu Hermes funcionando aunque nunca hayas montado un agente.

Qué es Hermes (y por qué es distinto)

Hermes es un agente de IA de código abierto de Nous Research (los mismos de la serie de modelos Hermes). La idea central: cuanto más lo usas, más listo se vuelve contigo. No es un chatbot que olvida todo al cerrar; es un asistente que convive con tu trabajo. Sus rasgos clave:

• Sistema de skills: cuando le pides algo que no sabe hacer, busca la habilidad; si no existe, se la crea (por ejemplo, escribiendo un script de Python). Y guarda lo aprendido para la próxima vez.
• Memoria persistente: cada cierto número de interacciones almacena lo importante y la va afinando para adaptarse a ti (tus preferencias, tu contexto, tus proyectos).
• Personalidad configurable: defines cómo quieres que se comporte y se comunique, en un archivo que persiste.
• Poder agéntico real: viene con decenas de herramientas de base (control de archivos, terminal, búsqueda web, visión/OCR, generación de imágenes…) y se amplía con integraciones MCP (email, Notion, Airtable y mucho más).
• Multicanal: hablas con él por terminal, app de escritorio, Telegram, WhatsApp, Discord, email… todos apuntando al mismo agente.

Seguridad: por qué se instala en un VPS

Hermes es potente, así que conviene montarlo con cabeza:

• Instálalo en un VPS (servidor) donde no tengas nada más, y dale alcance de forma gradual: empieza con poco y amplía a medida que te fías.
• Usa aislamiento con Docker.
• Trae un sistema de aprobación por comandos: nada “peligroso” se ejecuta sin que tú des el visto bueno. Testea el alcance antes de darle más permisos.

Paso 1 — Instalar Hermes en un VPS

Necesitas un VPS con Ubuntu 24.04 (o superior). En el vídeo se usa Hostinger, que va sobrado para esto. Con el servidor listo y acceso a la terminal del panel:

1. Pega el comando de instalación rápida que encontrarás en la web/documentación oficial de Hermes y lánzalo en la terminal. Tarda alrededor de un minuto.
2. Al acabar aparece la pantalla de configuración: elige Quick setup → Enter.
3. Provider (proveedor de IA): elige con cuál arrancar. Puedes usar tu suscripción de OpenAI (Codex), Grok, Claude… o directamente un modelo gratis (lo vemos en el paso 4).
4. Autenticación: se abre una URL, te autenticas con tu cuenta, copias el código que te dan y lo pegas en la terminal. Login OK.
5. Elige modelo. (Si luego no sabes cómo cambiarlo, basta con preguntárselo a Hermes o usar hermes model.)
6. Plataforma de mensajería: te pregunta si quieres conectar una. Lo más cómodo para empezar es Telegram.

Si algo no queda bien configurado “al vuelo”, sal con Ctrl + C y ejecuta hermes setup para volver a la configuración.

Conectar Telegram (con BotFather)

1. En hermes setup, elige mensajería y pídele el token de bot de Telegram.
2. En Telegram, busca BotFather → Start → crea un bot nuevo → ponle nombre. El nombre de usuario del bot debe terminar en bot.
3. BotFather te da el token → cópialo y pégalo en la terminal (⚠️ al pegar no se ve, pero queda pegado — no lo pegues varias veces) → Enter.
4. Arranca el servicio y escribe hermes: ya debería responderte.
5. Abre el bot en Telegram, dale a Start y te pedirá un pairing code. Aprúebalo con: pairing approve telegram <código>. A partir de ahí te contesta por Telegram. Comandos útiles dentro de una conversación: reset (reinicia esa conversación, no la memoria) y model (cambiar de modelo).

Paso 2 — La app de escritorio conectada al VPS

La terminal está bien, pero la app de escritorio (Hermes Desktop) es mucho más cómoda. El objetivo es instalarla y conectarla al Hermes que vive en tu VPS (no usarla en local).

1. Descarga Hermes Desktop (Mac/Windows/Linux), instala y abre.
2. Te pedirá un proveedor: pon temporalmente Nous Portal (gratis) solo para entrar. Si la conexión falla, vuelve a pulsar el botón hasta que coincidan los códigos (bug conocido).
3. Ve a Ajustes → Gateway y cambia la conexión de local a Remote.
4. Abre un túnel SSH desde tu ordenador al VPS con ssh -L <puerto> (el puente que comunica tu equipo con el servidor). En otra terminal, obtén el token de conexión que Hermes guarda en el VPS.
5. En la app, la Remote URL empieza por http:// (es el localhost del túnel); pega el token y pulsa Test remote → conectado. Guarda y reconecta.
6. Verás todo el histórico de tu Hermes del VPS. Compruébalo preguntándole “¿dónde estás instalado?”: debe responder que corre en tu VPS Linux, no en local.

⚠️ Deja SIEMPRE abierta la terminal del túnel SSH (ssh -L) mientras quieras hablar con el Hermes del VPS desde la app. Minimízala, no la cierres. La segunda terminal (la del token) sí puedes cerrarla.

Paso 3 — Modelos y proveedores (incluido el proxy)

Hermes es agnóstico de modelo: conectas el proveedor que prefieras. Con las versiones recientes puedes conectar varios por OAuth (como OpenAI o Grok), sin pelearte con API keys. Y hay una pieza muy útil:

• hermes proxy levanta un puente local: conectas tus suscripciones (OpenAI, Grok, Claude…) a Hermes y luego apuntas otras herramientas (por ejemplo, un CLI de código) a ese proxy en vez de a la API oficial. Así trabajas con cualquiera de tus modelos conectados desde otras apps.

Para ver o cambiar el modelo activo: hermes model.

Paso 4 — Un modelo potente y GRATIS: DeepSeek V4 vía Nous Research

Una de las mejores bazas: como Nous Research son los creadores de Hermes, puedes conectar su API y usar un modelo gratis (a día del vídeo, DeepSeek V4 flash), sin depender de terceros ni de tu suscripción de pago.

1. Entra a tu VPS (ssh hermes o tu comando) y ejecuta hermes model.
2. Selecciona la opción Nous Portal (muévete con las flechas hasta que se ilumine → Enter).
3. Te da una URL y un código: abre la URL, pega el código.
4. Elige el plan Free → Subscribe and connect. Te pedirá tarjeta (es gratis, no cobran nada en el plan free).
5. Elige el modelo gratuito disponible (DeepSeek V4 flash) y listo: ya conversas con él.

Nous libera modelos gratuitos cada cierto tiempo. Y si algún día quieres más volumen, tienen planes de pago (20 $, 100 $, 200 $) con la misma conexión que acabas de aprender.

Paso 5 — Delegar tareas completas con Kanban

El Kanban de Hermes es de lo más práctico: le das una tarea grande y él la divide en subtareas que ejecuta en segundo plano, con estados (por hacer → en curso → bloqueado → review → hecho).

Ejemplo real: “Haz una auditoría completa de este repositorio y entrégame el informe en HTML.” En unos segundos crea la tarea padre, la parte en 4 subtareas (arquitectura, dependencias, configuración…) y trabaja ~20-25 minutos entregando Markdown por subtarea. Al terminar el padre, consolida el informe HTML y te da la ruta exacta del archivo. Ideal para auditar proyectos propios o de clientes sin estar encima.

Paso 6 — Memoria persistente GRATIS (con Obsidian)

Además de la memoria interna, puedes darle a Hermes una base de conocimiento propia y gratuita conectando Obsidian (tus notas) con el VPS, usando GitHub como puente: Obsidian (tu equipo) ⇄ GitHub privado ⇄ Hermes (VPS), sincronizado en los dos sentidos cada pocos minutos. Así el agente lee y escribe en tus propias notas: le dices “guarda esto en Obsidian” y queda archivado; escribes tú una nota y le llega al agente.

El montaje completo (crear el vault, el repo privado, las claves SSH, el plugin Git de Obsidian y dejar que Hermes termine la sincronización solo) lo tienes paso a paso aquí:

👉 Cómo conectar Obsidian con Hermes en un VPS (memoria bidireccional)

Paso 7 — Canales: Telegram y WhatsApp oficial

Ya tienes Telegram del paso 1. El canal que cambia el juego para un negocio es WhatsApp, pero hay que hacerlo por la vía oficial (WhatsApp Cloud API de Meta), nunca con puentes no oficiales tipo Baileys — esos acaban con el número baneado.

La conexión oficial completa (app de Meta, los 4 datos, webhook con túnel de Cloudflare, token permanente y las reglas de Meta que debes conocer antes de producción) la tienes desglosada aquí:

👉 Hermes + WhatsApp oficial: monta un agente de IA en el WhatsApp de tu negocio

Mantenerlo al día: novedades y actualizaciones

Hermes se actualiza rápido. Para actualizar, en la terminal:

• hermes update → actualiza a la última versión.
• hermes dashboard → panel para monitorizar modelos, logs, tareas programadas (crons) y skills.
• hermes version → te dice tu versión y cuántos commits vas por detrás.

Entre versiones ha ido ganando cosas muy útiles: instalación modular más rápida, arranque más ágil, nuevos proveedores por OAuth, más canales de mensajería (Teams, Line, Signal…), nuevas skills (Hugging Face, finanzas) y refuerzos de seguridad. Y en la 0.17 llegaron los subagentes en paralelo, el Telegram integrado en el escritorio, los crons por chat, la edición de imagen y los perfiles con memoria separada. Todo eso, en detalle, aquí:

👉 Hermes Agent 0.17: subagentes, Telegram y crons por chat

Al actualizar la app de escritorio, recuerda: no basta con actualizar el VPS; hay que actualizar también la app (rueda → About → Update, o por terminal con hermes version / update), porque la interfaz nueva es la que trae las funciones nuevas. Cierra y reabre la app tras actualizar.

Errores típicos y consejos que ahorran horas

• La terminal del túnel SSH no puede cerrarse. Si cierras la ventana del ssh -L, pierdes la conexión de la app con el VPS. Minimízala.
• El token de Telegram no se ve al pegarlo, pero se pega. No lo pegues varias veces o meterás basura.
• El nombre del bot de Telegram debe acabar en bot.
• reset no borra la memoria, solo la conversación actual. La memoria vive aparte.
• Deja que Hermes haga el trabajo técnico. En casi todos los pasos “de terminal”, puedes pegarle lo que llevas hecho y pedirle que lo termine él (crear scripts, reiniciar el gateway, configurar la sincronización). Es más rápido y más seguro que hacerlo a mano.
• Cuando algo raro pase, mándale una captura. El truco recurrente del vídeo: ante un error, pásale la imagen del mensaje y pídele que lo diagnostique. Detecta la causa, reinicia lo que haga falta y lo soluciona.
• Empieza con alcance corto. Da permisos poco a poco. El sistema de aprobación por comandos está para protegerte.

Para qué sirve todo esto en un negocio

Con Hermes montado y conectado tienes, en la práctica, un empleado digital que no duerme:

• Soporte 24/7, reserva de citas y cualificación de leads por WhatsApp y Telegram.
• Asistente interno para tu equipo, con memoria de tus proyectos (Obsidian).
• Tareas programadas (informes diarios de noticias, monitorización del servidor, resúmenes…).
• Auditorías y trabajos grandes delegados vía Kanban.
• Chatbots personalizados por empresa, cada uno con su perfil.

Conclusión

Hermes junta tres cosas que, por separado, ya serían valiosas: memoria que no se pierde, autonomía para ejecutar tareas y multicanal para hablar contigo por donde quieras. Y todo open source, en tu propia infraestructura y con opción de modelos gratis. Montarlo requiere un rato la primera vez, pero a partir de ahí tienes un asistente que trabaja para ti en automático.

En ExpertBrain montamos exactamente este tipo de agentes autónomos y self-hosted para empresas y organismos — con memoria, tareas programadas, WhatsApp oficial y automatización real en producción. Si quieres uno para tu negocio (o montárselo a tus clientes), hablemos.