Blog

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

, 10 min de lectura

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:

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

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:

Vas a usar la terminal un par de veces. No te asustes: es solo una ventana donde pegas un texto y presionas Enter. Así la abres:

Para pegar: Cmd + V en Mac, Ctrl + V (o clic derecho) en Windows. Después de pegar, siempre Enter.

Paso 1: instala Hermes

Hay dos caminos. Si nunca usaste una terminal, empieza por la app.

Paso 1: La app de escritorio (lo más fácil)

Entra a hermes-agent.nousresearch.com y descarga Hermes Desktop:

  • Mac: descarga el archivo .dmg, ábrelo y arrastra Hermes a la carpeta Aplicaciones.
  • Windows: descarga el .exe, ábrelo y sigue el instalador como con cualquier programa.

En Linux no hay instalador de escritorio: usa la terminal (siguiente paso) y luego abre la interfaz con hermes desktop.

Paso 2: O por la terminal (lo más completo)

Abre la terminal, pega el comando de tu sistema y presiona Enter.

Mac y Linux:

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

Windows (en PowerShell):

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

Vas a ver muchas líneas pasando: es normal, está descargando todo lo que necesita. Espera a que termine.

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 algo falta, te dice qué. Si ves command not found o "no se reconoce el comando", 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 Zen? Modelo: deepseek-v4.1-flash-free
Instalar, elegir proveedor, elegir modelo. Menos de cinco minutos.

Paso 2: consigue tu API key de OpenCode

Hermes es el agente, el cuerpo. Pero necesita un cerebro: un modelo de IA que piense por él. Ese cerebro no vive en tu PC, vive en los servidores de OpenCode. Y para usarlo, Hermes necesita tu API key.

¿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 Hermes envía cada vez que le pide algo a OpenCode, para que OpenCode sepa que el pedido viene de tu cuenta.

Hermesen tu PC (el cuerpo)OpenCodeDeepSeek (el cerebro)“Esta llave es tuya, pasa”tu pedido + tu API keyla respuesta
Cada pedido de Hermes viaja con tu API key. OpenCode la revisa, ve que eres tú y responde.

Dos cosas importantes:

Cómo conseguirla, paso a paso

Paso 4: 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 5: 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". Así, si algún día tienes varias, sabes cuál es cuál.

Ojo: el modelo DeepSeek V4.1 Flash Free cuesta $0 mientras dure la promoción, pero OpenCode puede pedirte registrar un método de pago para activar la cuenta.

Paso 6: 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. Si la pierdes, no pasa nada: creas otra.

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 3: conecta Hermes con OpenCode

Hermes ya trae a OpenCode en su lista. Un dato que me gustó: según la documentación de OpenCode, DeepSeek V4.1 Flash Free sigue una política de cero retención, o sea, no usan lo que le mandas para entrenar. Para un agente que va a ver tu correo, eso importa.

Paso 7: Abre el selector de modelos

En la terminal escribe:

hermes model

Se abre un menú. Te mueves con las flechas ↑ ↓ del teclado y eliges con Enter.

Paso 8: Elige OpenCode Zen y pega tu clave

  1. En la lista de proveedores, elige OpenCode Zen.
  2. Cuando te pida la API key, pégala y presiona Enter. Puede que no veas nada al pegar: muchos programas ocultan las claves por seguridad. Es normal.
  3. En la lista de modelos, elige DeepSeek V4.1 Flash Free (deepseek-v4.1-flash-free).

Paso 9: Tu primera tarea

Escribe hermes y Enter. 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.

Paso 4: 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.

¿Usas la app de escritorio? Es todavía más fácil: en Messaging → Telegram hay un botón Create with QR que crea el bot, detecta tu número y lo deja todo configurado.

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

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 "no se reconoce el comando". Cierra la terminal y ábrela de nuevo. Si sigue, corre hermes doctor.

Hermes dice que la API key no es válida. Seguramente se copió incompleta. Vuelve a la consola de OpenCode, cópiala con el botón y repite hermes model.

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.

Para ver el estado de todo: hermes status te dice qué está conectado y qué no.

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

Cuando se llena, pasan dos cosas:

La solución es un comando:

/new

Empiezas una conversación nueva, con el contexto en cero. 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. 🙌