Antes de empezar
Necesitas cuatro cosas. Nada más.
| Qué | Detalle |
|---|---|
| Una computadora | Windows 10/11, macOS o Linux. La PC tiene que estar encendida y con internet para que el agente responda: el cerebro corre en tu máquina, no en la nube. |
| Una cuenta de Telegram | La tuya. El bot se crea en dos minutos con @BotFather y es gratis. |
| Acceso a un modelo de IA | Dos caminos: suscripción a Nous Portal (la más simple, un solo cobro) o una API key de pago por uso (DeepSeek, OpenRouter, OpenAI, Anthropic, Google…). |
| Ganas de leer dos avisos | El agente puede ejecutar comandos en tu PC. No es un juguete: se le dan permisos con cabeza, y eso se explica en el paso 5. |
Instalar Hermes Agent
El instalador descarga Python y las dependencias por su cuenta. No hay que preparar nada antes.
Windows
Abre PowerShell (menú Inicio → escribe “PowerShell” → clic derecho → Ejecutar como administrador solo si te lo pide) y pega:
irm https://hermes-agent.nousresearch.com/install.ps1 | iex
Si PowerShell bloquea el script por política de ejecución, corre primero:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
macOS y Linux (o WSL en Windows)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Al terminar, cierra y vuelve a abrir la terminal para que tome el comando. Comprueba que quedó:
hermes --version
Dónde queda todo instalado
Vale la pena saberlo desde el principio, porque ahí están las claves, la memoria y los respaldos:
| Carpeta | Qué guarda |
|---|---|
%LOCALAPPDATA%\hermes\ (Windows)~/.hermes/ (Mac/Linux) | Configuración, sesiones, memoria, skills, perfiles y los secretos en .env. |
…\hermes\config.yaml | Ajustes (modelo, proveedor, plataformas). Nunca se edita a mano: se cambia con hermes config set. |
…\hermes\.env | Las API keys. Este archivo no se comparte ni se sube a ningún lado. |
…\hermes\profiles\<nombre>\ | Cada agente extra tiene su propia carpeta, con su memoria y sus skills separadas. |
Conectar el modelo de IA
El asistente pregunta qué proveedor usar y guarda la clave en .env. No hay que tocar archivos.
hermes setup model
Te va a ofrecer, entre otras:
- Nous Portal — inicio de sesión en el navegador, sin pegar claves. Lo más cómodo si no quieres pensar en consumo.
- OpenRouter — una sola clave para casi todos los modelos.
- DeepSeek — la opción más económica por uso; es la que yo tengo puesta.
- OpenAI, Anthropic, Google AI Studio — las clásicas.
Si eliges una API key, pégala cuando la pida. Al final comprueba que responde:
hermes status
Puedes cambiar de modelo cuando quieras con hermes model, y poner uno de respaldo con hermes fallback para cuando el principal falle.
Crear el bot de Telegram
Esto se hace en Telegram, desde tu teléfono o el escritorio:
- Abre el chat con @BotFather (el oficial, con el check azul).
- Escribe
/newbot. - Te pide un nombre visible (ej. Mi Agente) y luego un usuario que debe terminar en
bot(ej. mi_agente_bot). - Te devuelve un token parecido a
7891234567:AAH…. Eso es la contraseña del bot: no se lo pases a nadie ni lo pegues en capturas.
Conectar el bot al agente
hermes gateway setup
Elige Telegram, pega el token y, cuando pregunte por el usuario autorizado, pon tu ID numérico de Telegram (no tu @usuario). Para saberlo, escríbele a @userinfobot: te responde un número de 9 o 10 cifras.
El token del bot queda guardado en el archivo .env (nunca en config.yaml), y la lista de autorizados
se ve así, con allowed_chats vacío si no se configuró:
hermes config get telegram
Si allowed_chats aparece entre comillas con tu número, está bien configurado. Si aparece vacío, el bot acepta
mensajes de cualquiera: vuelve a correr hermes setup gateway.
Probarlo antes de dejarlo fijo
Primero en primer plano, para ver los mensajes de error en la propia ventana:
hermes gateway run
Abre Telegram, busca tu bot y escríbele “hola”. Debe contestar en segundos. Prueba algo del equipo:
dime en qué carpeta estoy y qué archivos hay
Cuando funcione, detenlo con Ctrl + C y déjalo como servicio en segundo plano:
hermes gateway install hermes gateway start hermes gateway status
Gateway: running y Platforms: Telegram ya tienes un agente que vive en tu PC y te atiende desde el teléfono.Permisos: darle libertad con frenos
El agente pide aprobación antes de ejecutar comandos delicados. Hay tres formas de trabajar, y conviene empezar por la del medio:
| Modo | Cómo se comporta | Cuándo usarlo |
|---|---|---|
| Preguntar (por defecto) | Antes de un comando riesgoso te muestra qué va a hacer y espera tu “sí”. | Siempre al principio, y para alguien que recién empieza. |
| Aprobación inteligente | Deja pasar lo inocuo (leer archivos, listar carpetas) y pregunta solo por lo que puede romper algo. | El equilibrio recomendado para el día a día. |
Sin preguntar (--yolo) | Ejecuta todo sin consultar. | Solo en una máquina de pruebas, nunca en la PC del trabajo. |
hermes setup tools
Recomendaciones que no negociaría:
- Instalarlo con la cuenta normal del usuario, no como administrador.
- Que el bot sea solo para él: un ID autorizado y nada más.
- Hacer copia de la carpeta
hermesde vez en cuando (ahí están memoria y sesiones). - Si algún día le presta la PC a alguien,
hermes pausedetiene el agente sin desinstalarlo.
Un segundo agente (opcional)
Cada agente extra es un perfil: memoria distinta, skills distintas, y su propio bot de Telegram. Así se puede tener uno para trabajo, otro para la casa, y que no se mezclen.
hermes profile create asistente hermes profile list
Luego, dentro de ese perfil: crear otro bot con @BotFather (token nuevo, no el anterior) y configurarlo.
hermes --profile asistente gateway setup hermes --profile asistente gateway install hermes gateway list
Que arranque solo con la PC
hermes gateway install deja el servicio registrado en el sistema (en Windows crea una tarea programada).
Si tras reiniciar no responde, revisa:
hermes gateway status schtasks /query /tn "Hermes_Gateway"
En Windows, la tarea debe estar Habilitada y ejecutarse con el usuario que la instaló. Si aparece deshabilitada, se abre el Programador de tareas, se busca Hermes_Gateway y se marca “Ejecutar con el usuario haya iniciado sesión”.
Si algo no funciona
| Síntoma | Causa habitual | Solución |
|---|---|---|
| Le escribo al bot y no contesta | El gateway está detenido o el token es de otro bot | hermes gateway status y luego hermes gateway restart |
| Contesta “no autorizado” | Tu ID no está en la lista | Repetir hermes gateway setup y poner el ID de @userinfobot |
| Error 401 o “invalid api key” | La clave del modelo está mal o venció | hermes setup model de nuevo |
| Se queda pensando y no termina | Proveedor caído o sin saldo | hermes status; cambiar de modelo con hermes model |
| No encuentra un archivo de la PC | Está trabajando en otra carpeta | Decirle la ruta completa, o usar /cwd en el chat |
| Después de reiniciar no responde | La tarea de arranque está deshabilitada | Ver el paso 8 |
Los comandos que vas a usar más
hermes # abrir el agente en la terminal hermes status # cómo está todo hermes gateway status # si el bot está vivo hermes gateway restart # reiniciarlo hermes model # cambiar de modelo hermes profile list # qué agentes tienes hermes pause # freno de emergencia
Checklist final
hermes --help.