Skip to content

Hermes Agent

Hermes Agent: Tu asistente de IA completo

Hermes Agent es un agente de IA que vive en tu terminal y puede hacer casi cualquier cosa: escribir código, buscar en la web, manejar archivos, ejecutar comandos, recordar preferencias, e incluso delegar tareas a sub-agentes.

[!NOTE] Conflicto de interés: Este curso fue creado parcialmente con Hermes Agent. Obviamente somos parciales, pero también honestos sobre sus limitaciones.

Arquitectura

┌──────────────────────────────────────────────┐
│ HERMES AGENT │
├──────────────────────────────────────────────┤
│ │
│ 🧠 LLM (configurable) │
│ → OpenRouter, OpenAI, Anthropic, local │
│ │
│ 🛠️ Herramientas nativas │
│ → Terminal (bash) │
│ → Archivos (read, write, patch) │
│ → Browser (navegar, clic, screenshots) │
│ → Búsqueda web │
│ → Código (execute_code) │
│ → Memoria persistente │
│ → Cron (tareas programadas) │
│ │
│ 📋 Skills (procedimientos aprendidos) │
│ → Skills pre-instaladas │
│ → Skills custom del usuario │
│ → Skills de comunidad │
│ │
│ 🔄 Delegación (sub-agentes) │
│ → Divide tareas complejas │
│ → Ejecuta en paralelo │
│ → Aísla contexto │
│ │
│ 📝 Memoria a largo plazo │
│ → Preferencias del usuario │
│ → Convenciones del proyecto │
│ → Lecciones aprendidas │
│ │
│ 🔌 MCP (Model Context Protocol) │
│ → Herramientas adicionales via plugins │
│ → Home Assistant, Spotify, etc. │
│ │
└──────────────────────────────────────────────┘

Instalación

Terminal window
# Instalar Hermes Agent
pip install hermes-agent
# O con el instalador
curl -fsSL https://hermes-agent.nousresearch.com/install | bash
# Configurar proveedor de IA
hermes config set provider openrouter
hermes config set api_key $OPENROUTER_API_KEY

Configuración

Hermes se configura via config.yaml o comandos CLI:

~/.hermes/config.yaml
provider: openrouter
model: google/gemini-2.0-flash-exp:free # Modelo principal (¡gratis!)
# Proveedor de respaldo
fallback_provider: anthropic
fallback_model: claude-sonnet-4
# Memoria
memory:
enabled: true
# Skills
skills:
- creative/ascii-art
- software-development/debugging

Comandos básicos

Terminal window
# Iniciar sesión interactiva
hermes chat
# Enviar un mensaje directo
hermes "Crea un script de Python que ordene archivos por fecha"
# Ejecutar un skill
hermes skill:code-review src/main.py
# Ver memoria
hermes memory list
# Ver skills disponibles
hermes skills list

Skills: El superpoder de Hermes

Las skills son procedimientos predefinidos que Hermes puede cargar bajo demanda:

Terminal window
# Ver skills disponibles
hermes skills list
# Instalar un skill
hermes skills install creative/ascii-art
# Crear un skill propio
hermes skills create mi-skill

Ejemplo de una skill:

~/.hermes/skills/code-review/SKILL.md
name: code-review
description: Review code for bugs, security issues, and best practices
trigger: "review this code" or "code review"
steps:
1. Read the file
2. Check for common bugs (null refs, race conditions)
3. Check for security issues (SQL injection, XSS)
4. Suggest improvements
5. Generate a summary

Memoria: Hermes te recuerda

Hermes guarda información entre sesiones:

Sesión 1:
Tú: "Siempre uso tabs, no spaces"
Hermes: [Guarda en memoria: "Usuario prefiere tabs sobre spaces"]
Sesión 2 (días después):
Tú: "Formatea este proyecto"
Hermes: [Usa tabs porque lo recuerda de la memoria]

Delegación: Trabajo en paralelo

Hermes puede crear sub-agentes para tareas complejas:

Tú: "Analiza la base de código, escribe tests, y fix los bugs"
Hermes:
[Delegando a sub-agente 1] Analizando base de código...
[Delegando a sub-agente 2] Escribiendo tests...
[Delegando a sub-agente 3] Fixing bugs encontrados...
Todos completados. Resumen:
- 3 bugs encontrados y corregidos
- 15 tests escritos, todos pasando
- 2 refactorings sugeridos

Casos de uso prácticos

1. Desarrollo de software

Tú: "Crea una API REST con FastAPI para gestionar tareas"
Hermes: [Crea el proyecto, escribe el código, instala dependencias, prueba endpoints]

2. Escritura de contenido

Tú: "Escribe un artículo sobre IA generativa para mi blog"
Hermes: [Investiga, escribe el artículo, revisa, formatea en Markdown]

3. Automatización

Tú: "Todos los días a las 9am, revisa mis emails y resúmelos"
Hermes: [Configura cron job, revisa emails, genera resumen]

4. Investigación

Tú: "Investiga los mejores modelos de IA gratuitos en 2025"
Hermes: [Busca en web, sintetiza info, genera reporte con tabla comparativa]

Modelos compatibles

Hermes funciona con cualquier proveedor a través de OpenRouter:

ProveedorModeloGratis?Nota
OpenRoutergemini-2.0-flash-expRecomendado para empezar
OpenRouterdeepseek-r1Buen razonamiento
OpenAIgpt-4o-miniNo ($0.15/1M)Mejor relación calidad/precio
Anthropicclaude-sonnet-4No ($3/1M)Mejor escritura
Localollama run llama3Privacidad máxima, requiere GPU

Lo mejor y lo peor

Lo mejor

  • All-in-one: Terminal, archivos, web, browser, código
  • Memoria: Recuerda tus preferencias
  • Skills: Extendible con procedimientos custom
  • Delegación: Tareas paralelas con sub-agentes
  • Gratuito: Si usas modelos free de OpenRouter

Lo peor

  • Requiere terminal: No es para todos (aunque hay interfaz web)
  • Puede ser lento: Agentes hacen múltiples llamadas
  • Puede cometer errores: Como cualquier agente
  • Configuración inicial: Necesitas API key y config

[!TIP] Empieza con el modelo gratuito de OpenRouter (gemini-2.0-flash-exp:free). Si necesitas más potencia, sube a gpt-4o-mini ($0.15/1M tokens) o deepseek-r1 (también gratis).