Colección

Hermes: tu primer agente de IA, gratis con OpenCode y DeepSeek

, 15 min de lectura

Compártelo en tu historia

Imagen para historia: Hermes: tu primer agente de IA, gratis con OpenCode y DeepSeek
  1. Comparte o descarga la imagen y súbela a tu historia.
  2. Copia el enlace y pégalo con el sticker «Enlace».
Descargar imagen

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.

Chatbot¿Cómo limpio mi PC?1. Abre el Administrador…2. Busca archivos…Te dice qué hacer.Lo haces tú.AgentePiensaActúaRevisaRecuerdalo hace
El chatbot te dice qué hacer. El agente lo hace, revisa y vuelve a intentar.

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.

ArchivosCorreoTu redTerminalNavegadorTelegramHermesen tu PC
Hermes vive en tu PC: desde ahí llega a tus archivos, tu correo, tu red y tu terminal.

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:

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.

  1. Abre el menú Inicio, escribe "PowerShell", haz clic derecho → Ejecutar como administrador.
  2. Pega esto y presiona Enter:
wsl --install
  1. Cuando termine, reinicia la PC.
  2. 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.

$ curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash→ Instalando dependencias…→ Creando ~/.hermes✓ Hermes Agent instalado$ hermes model? Proveedor: opencode-acp? Modelo: opencode/deepseek-v4.1-flash-free
Instalar, elegir proveedor, elegir modelo. Así se ve cuando todo sale bien.

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.

antes: llamada directaHermesplan gratis“solo desde dentro de OpenCode”ahora: por ACPtodo esto corre en tu PCHermesACPOpenCodecon tu API keyDeepSeek V4.1Flash Free
La ruta directa al plan gratis está cerrada. Por ACP, Hermes usa OpenCode en tu PC y el pedido entra desde adentro.

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.

  1. 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.
  2. Aparece la lista de modelos que te da OpenCode. Busca opencode/deepseek-v4.1-flash-free y escribe su número. El número puede cambiar de una PC a otra: guíate por el nombre.
  3. 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:

  1. Un nombre, el que verás en el chat. Por ejemplo: "Mi Hermes".
  2. 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.

Hermes · TelegramMi Wi-Fi anda lentoRevisé tu red: el canal 6está saturado. Lo cambio?DaleListo: canal 11. Pingde 48 ms a 12 ms.Tu PC en casaHermes trabajando
Ejemplo ilustrativo: le escribes desde el celular y tu PC hace el trabajo en casa.

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.

OpenCodeen tu PCDeepSeeken sus servidores (el cerebro)“Esta llave es tuya, pasa”tu pedido + tu API keyla respuesta
Cada pedido viaja con tu API key. OpenCode la revisa, ve que eres tú y responde.

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.

API Keys+ Create API KeyHermesx8Kq2mV9pR4tL7wZ3nB6yH1cF5dJ0sACopiar✓ Copiada al portapapelesclave de ejemplo, inventada
Maqueta de cómo se ve: la clave en una línea y un botón para copiarla. La clave del ejemplo es inventada.

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.

Contexto de la conversación200k gratis1M en el modelo de pagolleno: empieza a olvidar lo del inicio/newMemoria y skills: se quedan
La barra se llena hacia los 200k. Un /new la vacía y lo importante se queda.

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