DEV Community

Cover image for Cómo Utilizar Hermes Agent: Guía Paso a Paso
Roobia
Roobia

Posted on • Originally published at apidog.com

Cómo Utilizar Hermes Agent: Guía Paso a Paso

En resumen: Hermes Agent es un asistente de IA de código abierto que aprende y retiene información, mejorando su inteligencia con el tiempo. Puede instalarlo con un solo comando, configurar su proveedor de LLM y comenzar a chatear desde la CLI, Telegram, Discord o su IDE. Esta guía cubre instalación, configuración, uso diario, funciones avanzadas y cómo sacarle el máximo partido a Hermes.

Prueba Apidog hoy

¿Qué es Hermes Agent?

Hermes Agent es un asistente de IA personal desarrollado por NousResearch, diseñado para funcionar 24/7, recordar lo que aprende y volverse más eficiente con el tiempo. A diferencia de ChatGPT o Claude, Hermes mantiene un modelo persistente de tus proyectos y preferencias.

Hermes Agent Banner

Capacidades clave:

  • Recuerda: Almacena conversaciones, decisiones y código generado.
  • Aprende: Crea habilidades reutilizables para tareas repetitivas.
  • Multiplataforma: Funciona desde CLI, Telegram, Discord, Slack, WhatsApp o IDE.
  • Autoalojado: Corre en tu portátil, VPS de $5 o cualquier nube.
  • Agnóstico al modelo: Acceso a más de 200 modelos vía OpenRouter u otros proveedores.
  • Extensible: Sistema de plugins para herramientas y comandos personalizados.

¿Quién debería usar Hermes?

  • Desarrolladores que quieren un asistente de IA que entienda su código.
  • Equipos que requieren un asistente multiusuario compartido.
  • Usuarios avanzados que buscan automatización 24/7 (cron).
  • Investigadores que entrenan modelos personalizados.

Instalación: Paso a paso

Requisitos previos

  • Sistema operativo: macOS, Linux, Windows (WSL recomendado)
  • Python: 3.10+
  • Git: Para clonar repositorios
  • Clave API: OpenRouter, Anthropic, OpenAI, etc.

Instalación rápida (recomendado)

Instala Hermes con un solo comando:

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

Este script:

  1. Clona el repositorio de Hermes.
  2. Instala uv (gestor de paquetes rápido para Python).
  3. Crea un entorno virtual.
  4. Instala todas las dependencias.
  5. Añade Hermes al PATH.

Recarga tu shell:

source ~/.bashrc  # Para bash
source ~/.zshrc   # Para zsh
Enter fullscreen mode Exit fullscreen mode

Verifica la instalación:

hermes --version
Enter fullscreen mode Exit fullscreen mode

Deberías ver algo como Hermes Agent v0.5.0.

Instalación manual (para desarrolladores)

Para más control:

# Clona el repositorio
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Instala uv (si no lo tienes)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Crea y activa el entorno virtual
uv venv venv --python 3.11
source venv/bin/activate  # Linux/macOS
# o
.\venv\Scripts\activate  # Windows

# Instala Hermes con todas las funciones
uv pip install -e ".[all,dev]"

# Ejecuta pruebas para verificar la instalación
python -m pytest tests/ -q
Enter fullscreen mode Exit fullscreen mode

Instalar con soporte de entrenamiento RL

Si vas a entrenar modelos personalizados:

# Inicializa el submódulo Atropos
git submodule update --init tinker-atropos

# Instala dependencias de entrenamiento
uv pip install -e "./tinker-atropos"
Enter fullscreen mode Exit fullscreen mode

Configuración inicial

Ejecutar el asistente de configuración

Para la primera vez:

hermes setup
Enter fullscreen mode Exit fullscreen mode

El asistente guía por:

  1. Selección de proveedor LLM.
  2. Configuración de claves API (en ~/.hermes/.env).
  3. Configuración de memoria persistente.
  4. Selección de backend de terminal.
  5. Integración opcional con Telegram, Discord, Slack.

Configuración manual

Edita el archivo de configuración:

hermes config edit
Enter fullscreen mode Exit fullscreen mode

O usa la CLI:

# Establecer modelo predeterminado
hermes config set model anthropic/claude-opus-4

# Establecer backend de terminal
hermes config set terminal.backend local

# Establecer claves API
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...
Enter fullscreen mode Exit fullscreen mode

Ubicación del archivo de configuración

Hermes guarda la configuración en ~/.hermes/:

~/.hermes/
├── config.yaml      # Config principal
├── .env             # Claves API
├── memory/          # Memoria persistente
├── skills/          # Habilidades instaladas
└── plugins/         # Plugins personalizados
Enter fullscreen mode Exit fullscreen mode

Verifica tu configuración 

hermes doctor
Enter fullscreen mode Exit fullscreen mode

Esto valida:

  • Configuración general.
  • Conectividad de claves API.
  • Estado de la memoria.
  • Estado de pasarelas (si están activadas).
  • Backend de terminal.

Elegir su proveedor de LLM

Hermes soporta más de 200 modelos. Elige el que mejor se adapte:

OpenRouter (recomendado para principiantes)

Ventajas: Una sola clave API, acceso a 200+ modelos. Nivel gratuito.

Configuración:

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...
Enter fullscreen mode Exit fullscreen mode

Modelos populares en OpenRouter:

Modelo Caso de uso Costo
anthropic/claude-opus-4 Codificación compleja $$$
anthropic/claude-sonnet-4 Rendimiento equilibrado $$
openai/gpt-4o Propósito general $$
google/gemini-pro-1.5 Ventanas de contexto largas $
meta/llama-3-70b Código abierto, rápido $

Anthropic Directo

Ideal para: Codificación y razonamiento avanzados.

Configuración:

hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4
Enter fullscreen mode Exit fullscreen mode

OpenAI Directo

Ideal para: Modelos GPT-4o y variantes.

Configuración:

hermes config set model openai
hermes config set OPENAI_API_KEY sk-...
Enter fullscreen mode Exit fullscreen mode

Modelos locales (Ollama)

Ventajas: Gratuito, privado, sin conexión.

Configuración:

# Instala Ollama: https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b
Enter fullscreen mode Exit fullscreen mode

Ejemplos de configuración del modelo

Enrutamiento inteligente:

model:
  provider: openrouter
  default: anthropic/claude-opus-4
  fallback:
    - anthropic/claude-haiku-4-5
    - openai/gpt-4o-mini
Enter fullscreen mode Exit fullscreen mode

Control de costos:

model:
  budget:
    daily_limit: 5.00  # USD
    monthly_limit: 100.00
Enter fullscreen mode Exit fullscreen mode

Uso básico: Modo CLI

Iniciar Hermes 

hermes
Enter fullscreen mode Exit fullscreen mode

Verás el banner de bienvenida y podrás chatear.

Comandos básicos

Chatear:

> ¿Puedes ayudarme a escribir una función Python para parsear JSON?
Enter fullscreen mode Exit fullscreen mode

Comandos de barra:

> /help
> /skills
> /memory
> /config
> /clear
> /history
Enter fullscreen mode Exit fullscreen mode

Tareas con archivos:

> Revisa el archivo ./src/main.py y refactoriza la conexión a la base de datos
Enter fullscreen mode Exit fullscreen mode

Ejecutar comandos de terminal:

> Run: npm install && npm run build
Enter fullscreen mode Exit fullscreen mode

Hermes siempre pedirá confirmación antes de ejecutar comandos.

Shell persistente

Hermes mantiene el estado del shell:

> cd /mi/proyecto && source venv/bin/activate
> python src/main.py  # En la misma sesión
Enter fullscreen mode Exit fullscreen mode

Trabajar con archivos

Leer:

> Muéstrame el contenido de config.yaml
Enter fullscreen mode Exit fullscreen mode

Editar:

> En main.py, cambia el puerto de la base de datos de 5432 a 5433
Enter fullscreen mode Exit fullscreen mode

Crear:

> Crea un archivo utils.py con funciones para formateo de fechas
Enter fullscreen mode Exit fullscreen mode

Flujos de trabajo de varios pasos 

> Necesito añadir autenticación de usuario a mi app Flask:
> 1. Crea los modelos de base de datos
> 2. Endpoints de login/logout
> 3. JWT tokens
> 4. Pruebas para el flujo de auth
Enter fullscreen mode Exit fullscreen mode

Hermes solicitará confirmación en cada paso.

Pasarela de mensajería: Telegram, Discord, Slack

Interactúa con Hermes como bot en varias plataformas.

Configuración de Telegram

  1. Crear bot: Busca @botfather en Telegram, envía /newbot y copia el token.

  2. Configurar Hermes:

    hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

  3. Iniciar pasarela:

    hermes gateway setup telegram
hermes gateway start

  4. Chatea con el bot: Busca tu bot en Telegram y envía /start.

Configuración de Discord

  1. Crear aplicación: Discord Developer Portal
  2. Crear bot y copiar token.
  3. Invitar al bot a tu servidor.

  4. Configurar Hermes:

    hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start

  5. Usar en Discord: Menciona el bot o usa mensajes directos.

Configuración de Slack

  1. Crear app en: Slack Apps
  2. Añadir permisos de "Bot".
  3. Instalar app y copiar token.

  4. Configurar Hermes:

    hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway start

Uso multiplataforma

Ejecuta varias pasarelas al mismo tiempo:

hermes gateway start --all
Enter fullscreen mode Exit fullscreen mode

Hermes sincroniza el contexto entre plataformas.

Integración con IDE: VS Code, JetBrains

Hermes se conecta al editor vía Agent Communication Protocol (ACP).

VS Code

  1. Instala la extensión ACP: Busca "Agent Communication Protocol" en Extensions.

  2. Inicia Hermes como backend:

    hermes acp start

  3. En VS Code: Selecciona Hermes como agente y chatea desde el editor.

JetBrains (IntelliJ, PyCharm)

  1. Instala plugin ACP: Busca e instala "ACP" en Plugins.

  2. Inicia servidor ACP:

    hermes acp start

  3. Configura en JetBrains: Añade Hermes como backend ACP en Ajustes > Herramientas > Agentes de IA.

Zed

Soporte ACP nativo:

  1. Configura en Zed:

    {
  "agent": {
    "provider": "acp",
    "endpoint": "hermes"
  }
}

  2. Inicia Hermes:

    hermes acp start

Sistema de memoria y aprendizaje

El punto fuerte de Hermes es su arquitectura de memoria.

Tipos de memoria

  • Memoria episódica: Guarda conversaciones y sesiones. Busca con:

    > /memory search "database migration"

  • Memoria semántica: Construye grafos de conocimiento.

    > /memory projects

  • Memoria procedimental (habilidades): Automatiza tareas repetidas.

    > /skills list

Búsqueda de sesión 

> /memory search "How did we handle JWT expiration last week?"
Enter fullscreen mode Exit fullscreen mode

Hermes resume resultados relevantes.

Sugerencias de memoria

Hermes muestra información de contexto cuando detecta temas recurrentes.

Compresión de contexto

Compresión automática para evitar límites de contexto. Configurable.

Exportar y respaldar

Exportar:

hermes memory export ~/backup/hermes-memory.json
Enter fullscreen mode Exit fullscreen mode

Importar:

hermes memory import ~/backup/hermes-memory.json
Enter fullscreen mode Exit fullscreen mode

Habilidades y complementos

¿Qué son las habilidades?

Son flujos de trabajo reutilizables. Ejemplos:

  • code_review: Revisión de código
  • debug_session: Debugging sistemático
  • api_tester: Prueba de APIs
  • git_workflow: Flujos Git
  • documentation: Genera documentación

Explorar e instalar habilidades

Listar:

> /skills list
Enter fullscreen mode Exit fullscreen mode

Instalar:

> /skills install code_review
Enter fullscreen mode Exit fullscreen mode

Usar:

> /skills run code_review ./src/auth.py
Enter fullscreen mode Exit fullscreen mode

Habilidades personalizadas

Crea en ~/.hermes/skills/:

# ~/.hermes/skills/my_skill.py
from hermes.skills import Skill

class MyCustomSkill(Skill):
    name = "my_custom_skill"
    description = "Hace algo útil"

    def execute(self, context):
        # Tu lógica aquí
        return "Habilidad ejecutada con éxito"
Enter fullscreen mode Exit fullscreen mode

Sistema de complementos

Extiende Hermes con herramientas y comandos propios.

# ~/.hermes/plugins/my_tool.py
from hermes.tools import Tool

class MyCustomTool(Tool):
    name = "my_tool"
    description = "Herramienta personalizada"

    def run(self, **kwargs):
        # Lógica de la herramienta
        return {"result": "success"}
Enter fullscreen mode Exit fullscreen mode

Tipos de plugins: Herramientas, comandos, ganchos (eventos).

Funciones avanzadas

Programación Cron

Automatiza tareas:

> Configura un resumen diario de notificaciones de GitHub a las 9am
Enter fullscreen mode Exit fullscreen mode

O en config.yaml:

cron:
  - name: "Resumen diario"
    schedule: "0 9 * * *"
    command: "/skills run github_digest"
    model: "anthropic/claude-haiku-4-5"
Enter fullscreen mode Exit fullscreen mode

Delegación de subagentes

Divide trabajo en paralelo:

> Revisa todos los PRs de mi repo y resume los cambios
Enter fullscreen mode Exit fullscreen mode

Hermes crea subagentes y sintetiza resultados.

Modo de voz

En CLI:

hermes --voice
Enter fullscreen mode Exit fullscreen mode

En Telegram/Discord: Envía nota de voz, Hermes transcribe y responde.

Discord voz: Hermes puede unirse a canales y operar en tiempo real.

Control del navegador

Hermes se integra con Browser Use CLI 2.0:

> Ve a github.com y busca los 5 repos Python en tendencia
Enter fullscreen mode Exit fullscreen mode

O conecta a Chrome vía CDP:

hermes browser connect --cdp
Enter fullscreen mode Exit fullscreen mode

Integración MCP

Soporta servidores Model Context Protocol:

mcp:
  servers:
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
    git:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-git"]
Enter fullscreen mode Exit fullscreen mode

Modo Worktree

Ejecuta Hermes en un worktree Git aislado:

hermes -w
Enter fullscreen mode Exit fullscreen mode

Agentes múltiples pueden trabajar en el mismo repo sin conflictos.

Ejecutar otros agentes dentro de Hermes

Hermes puede usar otros agentes IA como subagentes:

> Usa claude-code para revisar este pull request
Enter fullscreen mode Exit fullscreen mode

Resolución de problemas

Problemas comunes

Clave API no encontrada

hermes config get OPENROUTER_API_KEY
hermes config set OPENROUTER_API_KEY sk-or-...
Enter fullscreen mode Exit fullscreen mode

Modelo no disponible

hermes models list
hermes config set model anthropic/claude-opus-4
Enter fullscreen mode Exit fullscreen mode

Fallo al iniciar la pasarela

hermes gateway status
hermes gateway stop
hermes gateway start
Enter fullscreen mode Exit fullscreen mode

Corrupción de memoria

hermes memory export ~/backup/memory-backup.json
hermes memory reset
hermes memory import ~/backup/memory-backup.json
Enter fullscreen mode Exit fullscreen mode

Obtener ayuda

Ayuda en CLI:

> /help
Enter fullscreen mode Exit fullscreen mode

Ver logs:

hermes logs tail --follow
Enter fullscreen mode Exit fullscreen mode

Diagnósticos:

hermes doctor
Enter fullscreen mode Exit fullscreen mode

Preguntas frecuentes

¿Cuánto cuesta ejecutar Hermes?

Hermes es gratuito, solo pagas el uso de LLM.

  • Ligero: $5-15/mes (OpenRouter)
  • Moderado: $20-50/mes
  • Intensivo: $50-200/mes
  • Modelos locales: Gratis, requiere hardware.

¿Puede Hermes funcionar 24/7?

Sí, en un VPS:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes service install
hermes service start
Enter fullscreen mode Exit fullscreen mode

¿Es Hermes adecuado para empresas?

Sí. Incluye:

  • Multiusuario con sesiones aisladas.
  • Redacción de PII.
  • Seguridad reforzada.
  • Despliegue autoalojado.
  • Auditoría.

¿Cómo migro de OpenClaw? 

hermes claw migrate --dry-run
hermes claw migrate
hermes doctor
Enter fullscreen mode Exit fullscreen mode

¿Puedo usar Hermes sin internet?

Sí, con modelos locales:

curl -fsSL https://ollama.ai/install.sh | sh
ollama pull qwen2.5-coder:32b
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b
Enter fullscreen mode Exit fullscreen mode

¿Diferencias Hermes vs ChatGPT?

Característica Hermes ChatGPT
Memoria Persistente, buscable Por sesión
Despliegue Autoalojado, 24/7 Nube
Modelos 200+ modelos Solo GPT
Extensibilidad Plugins, habilidades Limitado
Costo Pago por uso Suscripción
Privacidad Controlas tus datos OpenAI almacena

¿Cómo hago copia de seguridad de Hermes? 

hermes export --all ~/backup/hermes-full-backup.tar.gz
Enter fullscreen mode Exit fullscreen mode

¿Puede Hermes acceder a mis archivos locales?

Solo accede a los archivos/directorios que indiques explícitamente. Por defecto, no accede a tu sistema de archivos.

💡 ¿Quieres probar APIs como parte de tu flujo de desarrollo impulsado por IA? Mira Apidog, la plataforma todo en uno para diseñar, probar y documentar APIs.

Top comments (0)