Cómo instalar y usar Hermes Agent gratis: una guía práctica

Hermes Agent apareció en mi radar hace unas semanas, y después de revisar a fondo el repositorio de GitHub (37.5k estrellas, licencia MIT, creado por Nous Research), me di cuenta de que hace algo que la mayoría de agentes de IA no hacen: se mejora cuánto más lo usas. No en el sentido vago de "el modelo mejora" — literalmente construye habilidades a partir de tus interacciones, recuerda lo que funcionó y perfecciona esas habilidades con el tiempo. Solo eso ya vale la pena echarle un vistazo.

Lo que me convenció del todo: funciona en un VPS de $5. No necesitas GPU a menos que quieras una. Y puedes conectarlo a Telegram, Discord, Slack, WhatsApp y una docena de plataformas más. Recomendamos usar LightNode como proveedor de VPS — su facturación por hora empieza en $0.013/hora, algo difícil de superar para experimentar con IA autoalojada.

Tabla de contenidos

1. Qué hace realmente Hermes Agent
2. Requisitos del sistema
3. Instalación
4. Configurar un proveedor de modelos gratis
5. Configuración
6. Ejecutar tu primera sesión
7. Conectar a plataformas de mensajería
8. Funciones clave que vale la pena conocer
9. Solución de problemas
10. Para cerrar

Qué hace realmente Hermes Agent

La mayoría de agentes de IA siguen el mismo patrón: envías un prompt, ejecutan algunas herramientas, devuelven un resultado y lo olvidan todo. Hermes Agent toma un enfoque distinto. Tiene un ciclo de aprendizaje integrado:

1. Le das una tarea
2. Determina qué habilidades se necesitan
3. Si una habilidad no existe, la crea
4. Usa la habilidad, evalúa el resultado y guarda lo que funcionó
5. La próxima vez que pidas algo similar, recupera esa habilidad perfeccionada

Esto significa que el agente realmente mejora con el uso, no solo porque el modelo subyacente recibió una actualización. Tus flujos de trabajo específicos, tu código base, tus hábitos — aprende esos patrones.

Además del ciclo de aprendizaje, Hermes Agent viene con 47 herramientas integradas, es compatible con la integración MCP (Model Context Protocol) para ampliar capacidades, y puede delegar tareas a subagentes. También tiene un programador cron para tareas recurrentes y un modo de voz si prefieres ir sin manos.

Requisitos del sistema

Antes de instalar, asegúrate de que tu sistema cumple con lo básico:

• SO: Linux (Ubuntu 20.04+ recomendado), macOS (12+) o Windows vía WSL2
• Python: 3.10 o superior
• RAM: 2GB mínimo, 4GB recomendado
• Disco: ~500MB para el agente en sí
• Red: Acceso a internet para llamadas a la API del modelo

Para usuarios de Android, Termux también funciona. Windows nativo no es compatible — necesitas WSL2.

Si lo despliegas en un VPS, un servidor de $5/mes con 1 vCPU y 1GB de RAM lo maneja bien para uso ligero. Cargas de trabajo más pesadas (múltiples plataformas de mensajería, tareas cron frecuentes) se benefician de 2GB+.

Instalación

Hay dos formas de instalar Hermes Agent. La forma rápida se encarga de todo. La forma manual te da más control.

Método 1: instalación en una línea (recomendado)

Abre tu terminal y ejecuta:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Este script hace el trabajo pesado: verifica dependencias, configura un entorno virtual, clona el repositorio, instala paquetes y ejecuta el asistente de configuración inicial. En un Ubuntu limpio, todo el proceso toma unos 2-3 minutos.

Cuando termine, verifica la instalación:

hermes --version

Deberías ver el número de versión. Si recibes un error de "command not found", reinicia tu shell o ejecuta source ~/.bashrc (o ~/.zshrc si usas zsh).

Método 2: instalación manual

Si prefieres saber exactamente qué se instala en tu máquina, o si la instalación de una línea falla por alguna razón:

# Clone the repo
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Create and activate a virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run the setup wizard
python setup.py

El asistente de configuración te guía por la selección del proveedor de modelos, ingreso de la API key y configuración básica. Siempre puedes volver a ejecutarlo más tarde con hermes setup.

Configurar un proveedor de modelos gratis

Hermes Agent no incluye su propio modelo. Se conecta a proveedores externos. Las buenas noticias: varios proveedores ofrecen planes gratuitos que funcionan con Hermes Agent.

Opción 1: OpenRouter (la opción gratis más fácil)

OpenRouter te da acceso a más de 200 modelos, y varios de ellos son gratis. Este es el camino que recomiendo para empezar.

1. Crea una cuenta en openrouter.ai
2. Genera una API key desde tu panel
3. Busca modelos gratis — busca modelos etiquetados como "free" en el catálogo

Los modelos gratuitos comunes en OpenRouter incluyen variantes de Llama, Mistral y Qwen. Los modelos disponibles rotan, así que revisa el catálogo actual.

Durante el asistente de configuración de Hermes Agent, selecciona "OpenRouter" como tu proveedor y pega tu API key cuando te lo pida.

Opción 2: Nous Portal

Nous Research tiene su propio portal de inferencia. Ocasionalmente ofrece créditos gratis para nuevos usuarios, y los modelos disponibles ahí están ajustados específicamente para cargas de trabajo de agentes.

1. Visita nousresearch.com y regístrate
2. Revisa tu panel para ver si tienes créditos gratis asignados
3. Usa la API key proporcionada en la configuración de Hermes Agent

Opción 3: otros proveedores

Hermes Agent también es compatible con:

• z.ai / GLM: Plataforma de IA china con un plan gratuito
• Kimi / Moonshot: Otra opción con uso gratuito limitado
• MiniMax: Plan gratuito disponible para uso ligero
• Cualquier endpoint compatible con OpenAI: Si tienes acceso a otros proveedores, puedes conectarlos

Para configurar un endpoint personalizado, necesitarás la URL base y una API key. El asistente de configuración se encarga de esto, o puedes editar el archivo de configuración directamente (se cubre en la siguiente sección).

Configuración

Hermes Agent guarda su configuración en ~/.hermes/config.toml. Después de ejecutar el asistente de configuración, encontrarás algo como esto:

[model]
provider = "openrouter"
api_key = "sk-or-v1-..."
model = "meta-llama/llama-3.3-70b-instruct:free"

[agent]
name = "Hermes"
memory = true
skills_dir = "~/.hermes/skills"

[messaging]
# Configure messaging platforms here
# telegram_token = ""
# discord_token = ""

Opciones de configuración clave

Configuración del modelo: Cambia de modelo o proveedor en cualquier momento. Si quieres probar un modelo gratuito diferente en OpenRouter, simplemente actualiza el campo model. También puedes cambiar de proveedor completamente — cambia provider a "openai" o "nous" y actualiza la API key correspondientemente.

Memoria: Mantén memory = true. Esto es lo que activa el ciclo de aprendizaje. El agente guarda el historial de conversaciones y las mejoras de habilidades en ~/.hermes/memory/.

Directorio de habilidades: Aquí es donde se guardan las habilidades aprendidas. Puedes explorar ~/.hermes/skills/ para ver qué ha aprendido el agente. Las habilidades se guardan como archivos JSON y se pueden editar manualmente si quieres afinarlas.

Cambiar modelos desde la CLI

No tienes que editar el archivo de configuración cada vez. Hermes Agent tiene comandos integrados para esto:

# List available models for your current provider
hermes model list

# Switch to a specific model
hermes model set meta-llama/llama-3.3-70b-instruct:free

# Check what model you're currently using
hermes model show

Verificación de estado

Ejecuta esto después de cualquier cambio de configuración para asegurarte de que todo esté correctamente conectado:

hermes doctor

Verifica tu API key, disponibilidad del modelo, conectividad de red y estado del sistema de habilidades. Si algo está mal, te dice exactamente qué corregir.

Ejecutar tu primera sesión

Una vez configurado, inicia una sesión:

hermes chat

Esto abre un REPL interactivo. Prueba algo simple primero:

You: What tools do you have available?
Hermes: I have access to 47 built-in tools including:
- file_read / file_write (file operations)
- shell_exec (run shell commands)
- web_search / web_fetch (web access)
- code_search (search codebases)
- calendar / reminders (scheduling)
- ...and more. I can also use MCP tools if configured.

Luego dale una tarea real:

You: Create a Python script that monitors a directory for new files and logs their names to a file called new_files.log

Hermes: I'll create that for you.
[creates watch_dir.py with inotify or polling-based implementation]
[tests the script]
The script is ready at ./watch_dir.py. Run it with python watch_dir.py /path/to/watch

La primera vez que pidas algo, el agente construye la habilidad desde cero. Pide algo similar después, y reutilizará la versión perfeccionada. Puedes ver esto en acción revisando el directorio de habilidades después de unas cuantas sesiones.

Conectar a plataformas de mensajería

Una de las características destacadas de Hermes Agent es el soporte de plataformas. Puedes hablar con él a través de más de 15 plataformas de mensajería, no solo por la CLI.

Configuración de Telegram

1. Envía un mensaje a @BotFather en Telegram para crear un nuevo bot
2. Copia el token del bot
3. Añádelo a tu configuración:

hermes gateway add telegram --token "YOUR_BOT_TOKEN"

4. Inicia la pasarela:

hermes gateway start telegram

Ahora puedes chatear con tu agente directamente en Telegram. Mantiene la misma memoria y habilidades que tus sesiones de CLI.

Configuración de Discord

1. Crea un bot en el Portal de Desarrolladores de Discord
2. Activa el Message Content Intent
3. Copia el token del bot
4. Configura:

hermes gateway add discord --token "YOUR_BOT_TOKEN"
hermes gateway start discord

Otras plataformas compatibles

El mismo patrón aplica para todas las plataformas. Usa hermes gateway add <plataforma> con las credenciales necesarias:

• Slack: Requiere una Slack App con scopes de bot
• WhatsApp: Usa la WhatsApp Business API o un puente no oficial
• Signal: Requiere configuración de signal-cli
• Matrix: Necesita una cuenta de bot de Matrix
• Mattermost: Token de acceso personal
• Email: Credenciales IMAP/SMTP
• SMS: Twilio o un proveedor similar
• DingTalk / Feishu / WeCom: Para plataformas de mensajería chinas

Ejecuta hermes gateway list para ver todas las plataformas disponibles y su estado.

Funciones clave que vale la pena conocer

Hub de habilidades

Hermes Agent tiene un repositorio comunitario de habilidades. Explora e instala habilidades que otras personas han creado:

# Browse available community skills
hermes skills browse

# Install a specific skill
hermes skills install web-scraper

# List your installed skills
hermes skills list

Esto es útil si no quieres esperar a que el agente aprenda desde cero. Alguien ya probablemente ha creado una habilidad para tareas comunes como extracción web, pruebas de API o análisis de documentos.

Programación con cron

Configura tareas recurrentes sin cron externo:

hermes cron add "0 9 * * *" "Summarize yesterday's git commits and post to #dev-channel"

El agente maneja la programación internamente y usa sus habilidades para ejecutar la tarea.

Modo de voz

Si prefieres ir sin manos:

hermes chat --voice

Esto usa el micrófono y altavoces de tu sistema. Funciona mejor con modelos que manejan entrada de audio, aunque también puede usar una capa local de voz a texto.

Delegación a subagentes

Para tareas complejas de múltiples pasos, Hermes Agent puede crear subagentes:

You: Research the top 5 VPS providers, compare their pricing, and create a summary document

Hermes: I'll delegate this to subagents for parallel research.
[spawns subagents for each provider]
[collects results]
[generates comparison document]

Los subagentes comparten la memoria y el sistema de habilidades del agente principal, así que se benefician de todo lo que el agente principal ha aprendido.

Solución de problemas

"command not found: hermes"

El script de instalación añade Hermes a tu PATH, pero tu shell actual puede no haberlo detectado. Solución:

source ~/.bashrc  # or ~/.zshrc

Si eso no funciona, verifica si ~/.local/bin/hermes existe y añádelo a tu PATH manualmente:

export PATH="$HOME/.local/bin:$PATH"

Errores de API key

Ejecuta hermes doctor primero. Te dirá si tu API key es inválida, ha expirado o si el modelo que seleccionaste no está disponible. Soluciones comunes:

• Para OpenRouter: Revisa tu clave en openrouter.ai/keys
• Los modelos gratuitos a veces tienen límites de uso — prueba un modelo gratuito diferente
• Asegúrate de que no haya espacios en blanco al final de tu API key

El modelo no responde

Los modelos del plan gratuito tienen límites de uso. Si alcanzas uno:

hermes model list    # see what's available
hermes model set <different-free-model>  # switch

Uso alto de memoria

Si la memoria del agente crece demasiado (verifica con du -sh ~/.hermes/memory/), puedes limpiar entradas antiguas:

hermes memory prune --older-than 30d

Esto mantiene las interacciones y habilidades recientes pero elimina los registros de conversación mayores a 30 días.

Problemas de conexión de la pasarela

Para plataformas de mensajería, asegúrate de que el proceso de la pasarela esté ejecutándose:

hermes gateway status

Si una pasarela se desconecta constantemente, revisa tu red y reiníciala:

hermes gateway restart telegram

Para cerrar

Hermes Agent hace algo que no he visto en otros agentes de código abierto: realmente aprende de tus patrones de uso y mejora con el tiempo, sin que tengas que definir flujos de trabajo manualmente o escribir plugins personalizados. El sistema de habilidades es el verdadero diferenciador — tareas que toman 10 minutos la primera vez toman 30 segundos la quinta vez.

El hecho de que funcione en hardware económico y se conecte a proveedores de modelos gratuitos significa que puedes tener un agente de IA personal funcionando 24/7 por un costo cercano a cero. Conéctalo a Telegram o Discord, y tendrás un asistente siempre disponible que recuerda tus preferencias, tu código base y tus flujos de trabajo.

Para empezar:

1. Elige un VPS (o usa tu máquina local) — LightNode funciona bien para esto
2. Ejecuta el instalador de una línea
3. Regístrate en OpenRouter y consigue un modelo gratis
4. Empieza a chatear

El repositorio de GitHub tiene documentación detallada, y la comunidad es activa si encuentras problemas. Dale un fin de semana — para el lunes, tendrás un agente que ya empezó a construir habilidades específicas para tu trabajo.