Blog

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

Ashley Innocent

Ashley Innocent

30 March 2026

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

En resumen: Hermes Agent es un asistente de IA de código abierto que recuerda lo que aprende y se vuelve más inteligente con el tiempo. Instálelo con un solo comando, configure su proveedor de LLM y comience a chatear a través de la CLI, Telegram, Discord o su IDE. Esta guía cubre la instalación, configuración, uso diario, funciones avanzadas y cómo aprovechar al máximo Hermes.

botón

¿Qué es Hermes Agent?

Hermes Agent es un asistente de IA personal creado por NousResearch que funciona 24/7, recuerda todo lo que aprende y se vuelve más capaz con el tiempo. A diferencia de ChatGPT o Claude, que comienzan desde cero cada conversación, Hermes construye un modelo persistente de su trabajo, proyectos y preferencias.

Capacidades clave:

Quién debería usar Hermes:

Instalación: Paso a paso

Requisitos previos

Instalación rápida (recomendado)

La forma más rápida de instalar Hermes:

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

Este script:

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

Después de la instalación, recargue su shell:

source ~/.bashrc  # Para bash
source ~/.zshrc   # Para zsh

Verifique la instalación:

hermes --version

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

Instalación manual (para desarrolladores)

Si desea más control sobre la instalación:

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

# Instale uv (si no está ya instalado)
curl -LsSf https://astral.sh/uv/install.sh | sh

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

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

# Ejecute pruebas para verificar la instalación
python -m pytest tests/ -q

Instalar con soporte de entrenamiento de RL

Si planea entrenar modelos personalizados:

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

# Instale con dependencias de entrenamiento
uv pip install -e "./tinker-atropos"

Configuración inicial

Ejecutar el asistente de configuración

Los usuarios primerizos deben ejecutar la configuración interactiva:

hermes setup

El asistente le guiará a través de:

  1. Elegir su proveedor de LLM — OpenRouter, Anthropic, OpenAI, etc.
  2. Configurar claves API — Almacenadas de forma segura en ~/.hermes/.env
  3. Configurar la memoria — Habilitar/deshabilitar la memoria persistente
  4. Backend de terminal — Opciones locales, Docker, SSH o en la nube
  5. Configuración de pasarela — Integración con Telegram, Discord, Slack (opcional)

Configuración manual

Si prefiere la configuración manual, edite el archivo de configuración:

hermes config edit

O use comandos 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 (se guarda automáticamente en ~/.hermes/.env)
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

Ubicación del archivo de configuración

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

~/.hermes/
├── config.yaml      # Configuración principal
├── .env             # Claves API (¡no compartir!)
├── memory/          # Almacenamiento de memoria persistente
├── skills/          # Habilidades instaladas
└── plugins/         # Complementos personalizados

Verifique su configuración

Ejecute la verificación de estado:

hermes doctor

Esto verifica:

Elegir su proveedor de LLM

Hermes soporta más de 200 modelos a través de múltiples proveedores. Así es como puede elegir:

OpenRouter (recomendado para principiantes)

Por qué: Una única clave API da acceso a más de 200 modelos. Nivel gratuito disponible.

Configuración:

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...

Modelos populares en OpenRouter:

Modelo

Caso de uso

Costo

anthropic/claude-opus-4

Codificación compleja, razonamiento

$$$

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

Por qué: La mejor codificación y razonamiento. Acceso directo a los últimos modelos Claude.

Configuración:

hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4

OpenAI Directo

Por qué: Modelos GPT-4o y o1 para casos de uso específicos.

Configuración:

hermes config set model openai
hermes config set OPENAI_API_KEY sk-...

Modelos locales (Ollama)

Por qué: Gratuito, privado, capaz de funcionar sin conexión.

Configuración:

# Instalar Ollama primero: https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Ejemplos de configuración del modelo

Enrutamiento inteligente (modelo costoso para tareas complejas, barato para tareas simples):

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

Control de costos (establecer límites de gasto):

model:
  budget:
    daily_limit: 5.00  # USD
    monthly_limit: 100.00

Uso básico: Modo CLI

Iniciar Hermes

La forma más sencilla de usar Hermes:

hermes

Verá un banner de bienvenida y podrá empezar a chatear inmediatamente.

Comandos básicos

Dentro de Hermes, puede:

Chatear de forma natural:

> Hey, can you help me write a Python function to parse JSON?

Usar comandos de barra:

> /help          # Mostrar todos los comandos
> /skills        # Explorar habilidades disponibles
> /memory        # Ver estado de la memoria
> /config        # Ver/editar configuración
> /clear         # Borrar conversación actual
> /history       # Ver conversaciones anteriores

Asignar tareas basadas en archivos:

> Look at the file ./src/main.py and refactor the database connection

Ejecutar comandos de terminal:

> Run: npm install && npm run build

Hermes le pedirá confirmación antes de ejecutar cualquier comando.

Shell persistente

A diferencia de otras herramientas de IA, Hermes mantiene el estado del shell entre comandos:

> cd /my/project && source venv/bin/activate
> python src/main.py  # Se ejecuta en la misma sesión de shell

El entorno virtual permanece activo para los comandos subsiguientes.

Trabajar con archivos

Leer archivos:

> Show me the contents of config.yaml

Editar archivos:

> In main.py, change the database port from 5432 to 5433

Crear nuevos archivos:

> Create a new file called utils.py with helper functions for date formatting

Flujos de trabajo de varios pasos

Hermes sobresale en tareas complejas y de varios pasos:

> I need to add user authentication to my Flask app. Can you:
> 1. Set up the database models
> 2. Create login/logout endpoints
> 3. Add JWT token generation
> 4. Write tests for the auth flow

Hermes trabajará en cada paso, pidiendo confirmación a lo largo del proceso.

Pasarela de mensajería: Telegram, Discord, Slack

Hermes puede funcionar como un bot en múltiples plataformas de mensajería, para que pueda interactuar con él desde su teléfono o el chat de su equipo.

Configuración de Telegram

1. Crear un bot:

2. Configurar Hermes:

hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

3. Iniciar la pasarela:

hermes gateway setup telegram
hermes gateway start

4. Empezar a chatear:

Configuración de Discord

1. Crear una aplicación de Discord:

2. Invitar al bot a su servidor:

3. Configurar Hermes:

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

4. Usar en Discord:

Configuración de Slack

1. Crear una aplicación de Slack:

2. Instalar en el espacio de trabajo y copiar token

3. Configurar Hermes:

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

Uso multiplataforma

Puede ejecutar múltiples pasarelas simultáneamente:

hermes gateway start --all

Hermes sincroniza el estado de la conversación en todas las plataformas.

Integración con IDE: VS Code, JetBrains

Hermes se integra directamente con su editor de código a través del Protocolo de Comunicación de Agentes (ACP).

Integración con VS Code

1. Instalar la extensión ACP:

2. Configurar Hermes como backend:

hermes acp start

3. Usar en VS Code:

Integración con JetBrains (IntelliJ, PyCharm, etc.)

1. Instalar el plugin ACP:

2. Iniciar el servidor ACP de Hermes:

hermes acp start

3. Configurar en JetBrains:

Editor Zed

Zed tiene soporte ACP nativo:

1. Configure en la configuración de Zed:

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

2. Iniciar Hermes:

hermes acp start

Sistema de memoria y aprendizaje

El superpoder de Hermes es su arquitectura de memoria. Así es como se usa de manera efectiva.

Tipos de memoria

Memoria episódica: Almacena conversaciones y sesiones específicas. Puede buscar y recuperar interacciones pasadas.

> /memory search "database migration"

Memoria semántica: Construye grafos de conocimiento sobre sus proyectos, preferencias y patrones.

> /memory projects

Memoria procedimental (habilidades): Crea habilidades reutilizables a partir de tareas repetidas.

> /skills list

Búsqueda de sesión

Encuentre trabajo pasado relevante con búsqueda semántica:

> /memory search "How did we handle JWT expiration last week?"

Hermes busca en todo su historial y resume los resultados.

Sugerencias de memoria

Hermes muestra proactivamente información relevante:

[Hermes]: I noticed you're working on the auth system. Last Tuesday you
mentioned a problem with JWT expiration. Want to revisit that?

Compresión de contexto

Hermes comprime automáticamente el contexto para evitar alcanzar los límites:

Esto permite conversaciones indefinidas sin gestión manual del contexto.

Exportar y respaldar

Exportar memoria:

hermes memory export ~/backup/hermes-memory.json

Importar memoria:

hermes memory import ~/backup/hermes-memory.json

Habilidades y complementos

¿Qué son las habilidades?

Las habilidades son flujos de trabajo reutilizables que Hermes puede ejecutar. Piense en ellas como macros para tareas complejas.

Las habilidades integradas incluyen:

Explorar e instalar habilidades

Ver habilidades disponibles:

> /skills list

Instalar una habilidad:

> /skills install code_review

Usar una habilidad:

> /skills run code_review ./src/auth.py

Habilidades personalizadas

Cree habilidades personalizadas 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):
        # Aquí va la lógica de su habilidad
        return "Habilidad ejecutada con éxito"

Sistema de complementos

Los complementos extienden Hermes con herramientas, comandos y ganchos personalizados.

Crear un complemento:

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

class MyCustomTool(Tool):
    name = "my_tool"
    description = "Una herramienta personalizada para tareas específicas"

    def run(self, **kwargs):
        # Aquí va la lógica de la herramienta
        return {"result": "success"}

Tipos de complementos:

Funciones avanzadas

Programación Cron

Programar tareas automatizadas:

# Pedir a Hermes que cree una tarea programada
> Configura un resumen diario de mis notificaciones de GitHub a las 9am

O configure manualmente en config.yaml:

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

Delegación de subagentes

Hermes puede generar subagentes para trabajo paralelo:

> I need you to review all the PRs in my repo and summarize the changes

Hermes generará múltiples subagentes para trabajar en paralelo y luego sintetizará los resultados.

Modo de voz

Pulsar para hablar en CLI:

hermes --voice

Notas de voz en Telegram/Discord:

Canales de voz de Discord:

Control del navegador

Hermes se integra con Browser Use CLI 2.0 para la automatización web:

> Go to github.com and find the top 5 trending Python repos

O conéctese a Chrome en vivo a través de CDP:

hermes browser connect --cdp

Integración MCP

Hermes soporta servidores del Protocolo de Contexto de Modelo (MCP):

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

Modo Worktree

Ejecute Hermes en un worktree de Git aislado:

hermes -w

Múltiples agentes pueden trabajar en el mismo repositorio concurrentemente sin conflictos.

Ejecutar otros agentes dentro de Hermes

Hermes puede ejecutar otros agentes de IA como subagentes:

> Use claude-code to review this pull request

Esto es útil para aprovechar agentes especializados para tareas específicas.

Resolución de problemas

Problemas comunes

"Clave API no encontrada"

# Verificar que la clave API esté configurada
hermes config get OPENROUTER_API_KEY

# Reestablecer si es necesario
hermes config set OPENROUTER_API_KEY sk-or-...

"Modelo no disponible"

# Listar modelos disponibles
hermes models list

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

"Fallo al iniciar la pasarela"

# Comprobar estado de la pasarela
hermes gateway status

# Reiniciar pasarela
hermes gateway stop
hermes gateway start

"Corrupción de memoria detectada"

# Copia de seguridad de la memoria actual
hermes memory export ~/backup/memory-backup.json

# Reiniciar memoria
hermes memory reset

# Reimportar si es necesario
hermes memory import ~/backup/memory-backup.json

Obtener ayuda

Ayuda integrada:

> /help

Ver registros:

hermes logs tail --follow

Ejecutar diagnósticos:

hermes doctor

Preguntas frecuentes

¿Cuánto cuesta ejecutar Hermes?

Hermes en sí es gratuito. Solo paga por el uso de LLM. Los costos típicos son:

El uso de modelos locales (Ollama) es gratuito pero requiere hardware.

¿Puede Hermes funcionar 24/7?

Sí. Despliegue Hermes en un VPS:

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

# Ejecutar como servicio systemd
hermes service install
hermes service start

¿Es Hermes adecuado para uso empresarial?

Sí. Las funciones empresariales incluyen:

¿Cómo migro de OpenClaw?

hermes claw migrate --dry-run  # Vista previa
hermes claw migrate            # Migración completa
hermes doctor                  # Verificar

¿Puedo usar Hermes sin internet?

Sí, con modelos locales:

# Instalar Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Descargar un modelo
ollama pull qwen2.5-coder:32b

# Configurar Hermes
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

¿Cuál es la diferencia entre Hermes y ChatGPT?

Característica

Hermes

ChatGPT

Memoria

Persistente, buscable

Solo por sesión

Despliegue

Autoalojado, 24/7

Solo en la nube

Elección de modelo

Más de 200 modelos

Solo GPT

Extensibilidad

Plugins, habilidades

Limitado

Costo

Pagar solo por el uso

Suscripción

Privacidad

Usted controla los datos

OpenAI almacena datos

¿Cómo hago una copia de seguridad de mis datos de Hermes?

# Exportar todo
hermes export --all ~/backup/hermes-full-backup.tar.gz

¿Puede Hermes acceder a mis archivos locales?

Hermes solo puede acceder a los archivos que usted referencia explícitamente o a los directorios a los que ha concedido permiso. Por defecto, no tiene acceso a su sistema de archivos.

💡
¿Desea probar APIs como parte de su flujo de trabajo de desarrollo impulsado por IA? Eche un vistazo a Apidog, la plataforma de desarrollo de APIs todo en uno para diseñar, probar y documentar APIs.
botón

Practica el diseño de API en Apidog

Descubre una forma más fácil de construir y usar APIs

Registrarse gratisDescargar