Si todavía usas la IA solo para preguntarle cosas, te estás perdiendo la mitad.
Hermes es un agente: no te dice cómo hacer algo, lo hace. Y desde hoy lo puedes mover gratis, porque OpenCode acaba de liberar DeepSeek V4.1 Flash sin costo. Lo anunciaron esta madrugada y ya lleva más de 700 mil vistas.
Te cuento qué es, para qué lo uso yo y cómo dejarlo funcionando en tu PC, con acceso desde Telegram.
Qué es Hermes
Hermes Agent es un agente de IA open source de Nous Research. Gratis, licencia MIT.
La diferencia con un chatbot es simple: un chatbot te responde con pasos que tú tienes que seguir. Un agente piensa, usa herramientas (la terminal, el navegador, tus archivos), revisa el resultado y sigue hasta terminar. Y recuerda lo que aprendió para la próxima.
Además, Hermes:
- Tiene memoria. Aprende tus proyectos y tus preferencias, y crea sus propias "skills" para reutilizar lo que ya resolvió.
- Programa tareas. Le dices "todos los días a las 8 mándame un resumen de X" y lo hace solo, sin que estés.
- Te habla por donde quieras. Telegram, Discord, Slack, WhatsApp o la terminal, siempre el mismo agente con la misma memoria.
Por qué correrlo en tu PC cambia todo
Acá está la gracia. Un agente en la nube solo ve lo que le subes. Hermes corre en tu equipo y en tu red, así que puede tocar lo que tú tocas: tus carpetas, tu correo, tu terminal, tu router.
Más control, más cosas que puede hacer por ti.
Para qué lo uso yo
- Optimizar mi red. Le pido que revise por qué el Wi-Fi anda lento, que mida, que encuentre el problema y lo corrija.
- Optimizar la PC. Procesos que se comen la RAM, programas que arrancan solos sin que los necesite, espacio en disco que se fue no sé dónde.
- Mi correo. Le di acceso a mi correo electrónico: clasifica, resume y me avisa de lo que de verdad importa.
- Ordenar carpetas. Descargas, capturas y documentos sueltos, ordenados por tipo y fecha, sin que yo mueva un dedo.
Lo que está haciendo la gente
Algunos ejemplos reales de los últimos meses, sacados de Reddit, X y de las historias que recopila el propio proyecto:
- Una constructora le pasa 11 grupos de WhatsApp a Hermes, y este resume 82 mensajes en tres líneas.
- Una empresa de mantenimiento de piscinas (más de 450 piscinas y 400 servicios a la semana) usa Hermes para detectar reportes mal hechos mientras las rutas siguen en curso y avisar por Telegram.
- Una tienda familiar de coleccionables lo corre en un VPS de 12 dólares para revisar el correo y vigilar el stock de más de 4,000 productos.
- Un agente inmobiliario lo conectó a Google Workspace y QuickBooks y, según cuentan, se ahorró unos 18 mil dólares al año en contabilidad.
- Razorpay, la fintech india, le dio un Hermes propio a cada uno de sus más de 220 empleados.
- Y mi favorito: un usuario con 28 tareas programadas, una de ellas a las 3 de la mañana, que revisa las conversaciones del día y le deja listo el contexto para el día siguiente.
Antes de empezar
No necesitas saber programar. Necesitas:
- Una Mac (macOS 12 o superior), una PC con Linux, o una PC con Windows 10 u 11.
- Unos 30 minutos.
- Telegram en tu celular, si quieres hablarle a Hermes desde la calle. Es opcional.
Vas a usar la terminal. No te asustes: es solo una ventana donde pegas un texto y presionas Enter. Así la abres:
- Mac: presiona Cmd + Espacio, escribe "Terminal" y Enter.
- Linux: Ctrl + Alt + T.
- Windows: en este tutorial vas a usar Ubuntu dentro de Windows. Te explico cómo en el paso 1.
Para pegar: Cmd + V en Mac, Ctrl + Shift + V en Linux y Ubuntu. Después de pegar, siempre Enter.
El plan, en una línea
Vas a instalar tres piezas: Hermes (el agente), OpenCode (el que tiene el modelo gratis) y un puente entre los dos. Suena a mucho, pero cada una es un comando. No necesitas crear cuentas ni pagar nada.
Instala Hermes
Paso 1: Solo en Windows: instala Ubuntu (WSL)
Si usas Mac o Linux, salta al paso 2.
En Windows vamos a usar WSL, una función oficial de Microsoft que te da un Linux dentro de Windows. La propia documentación de OpenCode la recomienda, y el puente que vamos a usar está probado en Mac y Linux.
- Abre el menú Inicio, escribe "PowerShell", haz clic derecho → Ejecutar como administrador.
- Pega esto y presiona Enter:
wsl --install
- Cuando termine, reinicia la PC.
- Abre el menú Inicio y busca Ubuntu. La primera vez te pide crear un usuario y una contraseña (la contraseña no se ve mientras la escribes: es normal).
Desde ahora, en Windows, todos los comandos de este tutorial van en esa ventana de Ubuntu.
Paso 2: Instala Hermes
En tu terminal (o en Ubuntu, si estás en Windows), pega:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Vas a ver muchas líneas pasando: es normal, está descargando todo lo que necesita. Espera a que termine.
¿Prefieres ventanitas en vez de terminal? Cuando termines todo, hermes desktop abre la app de escritorio de Hermes sobre esta misma instalación.
Paso 3: Comprueba que quedó instalado
Cierra la terminal y ábrela de nuevo (este paso se olvida mucho). Luego escribe:
hermes doctor
Te muestra un chequeo de todo. Si ves command not found, cierra y abre la terminal otra vez: casi siempre es eso.
Instala OpenCode y prueba el modelo gratis
OpenCode es el programa que tiene acceso al modelo gratis. Hermes lo va a usar por detrás.
Paso 4: Instala OpenCode
En la misma terminal:
curl -fsSL https://opencode.ai/install | bash
En Mac también puedes usar Homebrew, si lo tienes: brew install anomalyco/tap/opencode.
Cuando termine, cierra y abre la terminal otra vez.
Paso 5: Prueba DeepSeek gratis, sin cuenta
Antes de conectar nada, comprueba que el modelo gratis te responde:
opencode run -m opencode/deepseek-v4.1-flash-free "hola"
Si te contesta, listo: OpenCode ya puede usar DeepSeek V4.1 Flash Free. No te pidió cuenta ni API key, y no hace falta. Yo lo probé hoy en una instalación limpia, sin ninguna sesión iniciada, y respondió al toque.
Un detalle: si no eliges el modelo, OpenCode usa otro por defecto (Big Pickle). Por eso en el paso 7 vas a elegir DeepSeek a mano.
El puente entre Hermes y OpenCode
¿Qué es ACP y por qué lo necesitas?
ACP (Agent Client Protocol) es un idioma estándar para que un programa le hable a un agente. En vez de que Hermes llame directo a los servidores de OpenCode, Hermes abre OpenCode en tu PC y le pasa los pedidos. Para OpenCode, el pedido viene desde adentro, y su plan gratis lo acepta.
Esto importa porque OpenCode empezó a rechazar las llamadas directas a sus modelos free. Lo comprobé: si llamas directo a su servidor, responde que el plan gratis "solo se puede usar desde dentro de OpenCode". Hermes incluso retiró su proveedor gratis de OpenCode por eso.
El puente es un plugin de la comunidad, hermes-opencode-acp, open source y con licencia MIT. Su autor dice que lo usa a diario. Nous Research está preparando su propio cliente ACP dentro de Hermes; cuando salga, el plugin dejará de hacer falta y la configuración seguirá sirviendo.
Paso 6: Instala el puente
Pega estos comandos uno por uno (Enter después de cada uno):
git clone https://github.com/jovylle/hermes-opencode-acp.git ~/hermes-opencode-acp
~/hermes-opencode-acp/install-plugin.sh
hermes plugins enable --no-allow-tool-override opencode-acp-provider
hermes plugins validate ~/.hermes/plugins/model-providers/opencode-acp
El primero descarga el plugin, el segundo lo copia a la carpeta de Hermes, el tercero lo activa y el cuarto revisa que esté bien.
Ojo con el tercero: --no-allow-tool-override significa que el plugin no puede reemplazar herramientas internas de Hermes, como la que ejecuta comandos o escribe archivos. Este plugin solo conecta el modelo, no necesita ese permiso, así que mejor no dárselo. Si escribes el comando sin esa parte, Hermes te lo pregunta: responde que no.
El cuarto termina con Validation passed. Antes vas a ver un par de advertencias amarillas (⚠): son normales en un plugin de la comunidad.
Si el primero dice que no encuentra git: en Mac acepta la instalación que te ofrece; en Ubuntu o Linux corre sudo apt install git y repite.
Elige DeepSeek V4.1 Flash Free
Paso 7: Selecciona el modelo
En la terminal:
hermes model
Se abre una lista larga de proveedores, cada uno con un número. Escribe el número y presiona Enter.
- Busca opencode-acp (está casi al final de la lista) y elige su número. Ojo: no es la opción "OpenCode ▸", esa es para los planes de pago.
- Aparece la lista de modelos que te da OpenCode. Busca
opencode/deepseek-v4.1-flash-freey escribe su número. El número puede cambiar de una PC a otra: guíate por el nombre. - Al final te pregunta el "reasoning effort" (cuánto piensa antes de responder). Presiona Enter para dejar el valor que viene marcado.
Si todo salió bien, verás: Default model set to: opencode/deepseek-v4.1-flash-free (via opencode-acp).
Paso 8: Dile a Hermes el límite real
Este paso es corto pero importante. Hermes cree que este modelo tiene 1 millón de tokens de contexto, porque es lo que tiene la versión de pago. La versión free llega a 200k. Si no se lo dices, Hermes no resume la conversación a tiempo y choca con el límite.
hermes config set model.context_length 200000
Cuando abras Hermes, en la barra de abajo vas a ver algo como 27K/200K: eso confirma que ya lo sabe.
Paso 9: Tu primera tarea
Escribe hermes y Enter. La primera vez te pregunta si quieres compartir datos de uso con Nous ("Help improve Hermes?"): elige la opción que prefieras escribiendo su número. Yo elegí 3. No thanks.
Ya estás hablando con tu agente. Pídele algo de verdad, no un "hola":
Revisa mi carpeta de Descargas y dime qué puedo borrar
Fíjate que no te da instrucciones: va a revisar la carpeta él mismo y te va a mostrar lo que encontró. Esa es la diferencia con un chatbot. Cuando lo probé con una carpeta de prueba, revisó cada archivo, detectó un duplicado comparando su contenido y me dijo qué borrar y por qué, sin borrar nada porque se lo pedí así.
Telegram: tu agente en el bolsillo
Esta es la parte que más uso. Con Telegram le escribes a Hermes desde la calle y tu PC hace el trabajo en casa. Toma unos cinco minutos.
Paso 10: Crea tu bot con BotFather
En Telegram busca @BotFather (es el bot oficial de Telegram para crear bots, tiene el check azul). Escríbele /newbot y te va a pedir dos cosas:
- Un nombre, el que verás en el chat. Por ejemplo: "Mi Hermes".
- Un usuario, que tiene que terminar en
bot. Por ejemplo:mi_hermes_bot.
Al final te responde con un token, que se ve así: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Es la API key de tu bot: igual de secreta.
Paso 11: Consigue tu número de usuario
Busca @userinfobot en Telegram y escríbele cualquier cosa. Te responde con tu Id, un número como 123456789. Hermes lo usa para que solo tú puedas darle órdenes.
Paso 12: Conecta Telegram a Hermes
En la terminal:
hermes gateway setup
Elige Telegram, pega el token del bot y tu número de usuario. Luego enciende la conexión:
hermes gateway
Ahora ve a Telegram, abre el chat con tu bot y mándale un "hola". Debería responderte en segundos.
Paso 13: Déjalo encendido siempre
Con hermes gateway la conexión dura mientras la terminal esté abierta. Para que funcione siempre, incluso después de reiniciar:
hermes gateway install
Si alguna vez cambias de modelo o actualizas el plugin, reinícialo con hermes gateway restart.
Ojo: tu PC tiene que estar encendida y sin suspender. Si la PC duerme, Hermes también.
Si algo no funciona
"hermes: command not found" o "opencode: command not found". Cierra la terminal y ábrela de nuevo. Si sigue, corre hermes doctor.
"Could not find the OpenCode CLI command". Hermes no encuentra OpenCode: repite el paso 4 y comprueba con opencode run "hola".
La lista de modelos sale vacía. Corre opencode models. Si tampoco muestra nada, revisa que OpenCode funcione solo con el comando del paso 5.
En la barra de abajo dice /1M en vez de /200K. Te faltó el paso 8: corre hermes config set model.context_length 200000.
No aparece opencode-acp en hermes model. El plugin no quedó activado: repite el paso 6 y fíjate que el último comando diga Validation passed.
Hermes responde, pero con otro modelo. OpenCode usa Big Pickle por defecto. Repite el paso 7 y elige opencode/deepseek-v4.1-flash-free.
El modelo gratis dejó de aparecer. OpenCode rota su lista de modelos free cada cierto tiempo y DeepSeek está gratis "por tiempo limitado". Corre opencode models para ver cuáles hay hoy.
El bot de Telegram no responde. Revisa tres cosas: que tu PC esté encendida, que hermes gateway siga corriendo (o que lo hayas instalado con hermes gateway install) y que tu número de usuario esté bien puesto.
Actualizaste Hermes y algo dejó de andar. Vuelve a correr ~/hermes-opencode-acp/install-plugin.sh y hermes plugins validate ~/.hermes/plugins/model-providers/opencode-acp.
Extra: la API key, para cuando quieras más
Para el modelo gratis no la necesitas. Pero si algún día quieres modelos de pago de OpenCode (por ejemplo DeepSeek con 1 millón de contexto), te va a tocar crear una. Te explico qué es y cómo se saca.
¿Qué es una API key?
Piensa en la tarjeta de un gimnasio. Cada vez que entras, la pasas por el lector y el gimnasio sabe que eres tú, que tu membresía está activa y te deja pasar.
Una API key es eso, pero para programas. Es una contraseña larga que se envía con cada pedido para que OpenCode sepa que viene de tu cuenta.
Dos cosas importantes:
- Es secreta. Quien tenga tu API key usa tu cuenta. No la publiques, no la mandes por chat y cuidado con las capturas de pantalla.
- Se puede reemplazar. Si crees que se filtró, la borras y creas otra en dos clics.
Cómo conseguirla, paso a paso
Paso A: Crea tu cuenta en la consola de OpenCode
Entra a opencode.ai/console. Vas a ver tres botones: Continue with Google, Continue with GitHub y Continue with email. Elige el que te sea más cómodo. Si es tu primera vez, abajo dice Create account.
Paso B: Crea la API key
Dentro de la consola, busca la sección API Keys y toca Create API Key. Si te pide un nombre, ponle algo que reconozcas, como "Hermes".
Los modelos de pago se cobran por uso, así que OpenCode te va a pedir agregar un método de pago o saldo.
Paso C: Cópiala y guárdala
La API key se ve como una sola línea larga de letras y números mezclados, sin espacios. Algo así (esta es inventada, la tuya será distinta):
x8Kq2mV9pR4tL7wZ3nB6yH1cF5dJ0sA
Cópiala con el botón de copiar. No la escribas a mano: un solo carácter mal y no funciona. Guárdala en tu gestor de contraseñas o en una nota segura.
Paso D: Pégala en OpenCode
En la terminal:
opencode auth login
Te aparece una lista de proveedores. Muévete con las flechas ↑ ↓, elige OpenCode Zen (puede aparecer simplemente como opencode) y presiona Enter. Pega tu API key y Enter otra vez. Puede que no veas nada al pegar: muchos programas ocultan las claves por seguridad. Es normal.
Desde ahí, los modelos de pago aparecen en la lista de hermes model, junto a los gratis.
El límite: 200k de contexto (y cómo se arregla)
El modelo DeepSeek normal tiene una ventana de contexto de 1 millón de tokens. La versión free viene con 200k.
¿Qué significa? El contexto es la "memoria de corto plazo" de la conversación: todo lo que hablaron y todo lo que el agente leyó. 200k tokens son unas 150 mil palabras, que parece muchísimo, pero un agente lo llena rápido: cada archivo que abre, cada correo que lee y cada log que revisa entra ahí.
Y ojo: solo las instrucciones y herramientas de Hermes ya ocupan unos 27k tokens desde el primer mensaje. Te quedan unos 170k para trabajar.
Cuando se llena, pasan dos cosas:
- El agente empieza a olvidar lo del inicio de la conversación. Hermes resume solo cuando va por la mitad (por eso el paso 8 es clave: con 200k configurado, resume alrededor de los 100k), pero en sesiones muy largas igual se nota.
- Si llega al tope, el plan gratis rechaza la siguiente petición.
La solución es un comando:
/new
Empiezas una conversación nueva, con el contexto en cero: el puente ACP detecta el cambio y también reinicia la sesión de OpenCode. Lo probé: le di una palabra clave, la recordó, escribí /new y ya no la sabía. Y lo bueno: la memoria y las skills de Hermes se quedan. No olvida quién eres ni lo que aprendió, solo limpia la mesa. Si prefieres no cortar la conversación, /compress resume lo anterior y te libera espacio.
Mi regla: una tarea, una sesión. Terminaste de ordenar las carpetas, /new, y pasas al correo.
¿Vale la pena?
Totalmente. Es una gran manera de dar el salto a la IA agéntica, la que hace cosas por ti en vez de solo responderte. Y qué mejor que hacerlo gratis.
Instálalo este fin de semana, dale una tarea aburrida que vengas postergando y me cuentas qué tal. 🙌
