README.es.md
El agente de IA con mejora continua creado por Nous Research. Es el único agente con un bucle de aprendizaje integrado: crea habilidades a partir de la experiencia, las mejora durante el uso, se impulsa a sí mismo a persistir el conocimiento, busca en sus propias conversaciones pasadas y construye un modelo cada vez más profundo de quién eres a lo largo de las sesiones. Ejecútalo en un VPS de $5, un clúster de GPUs o infraestructura sin servidor que cuesta casi nada cuando está inactivo. No está atado a tu laptop — habla con él desde Telegram mientras trabaja en una VM en la nube.
Usa cualquier modelo que quieras — Nous Portal, OpenRouter (más de 200 modelos), NovitaAI, NVIDIA NIM (Nemotron), Xiaomi MiMo, z.ai/GLM, Kimi/Moonshot, MiniMax, Hugging Face, OpenAI, o tu propio endpoint. Cambia con hermes model — sin cambios de código, sin dependencias.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Nota: En Windows nativo, Hermes funciona sin WSL — la CLI, el gateway, la TUI y las herramientas funcionan de forma nativa. Si prefieres usar WSL2, el comando de Linux/macOS de arriba también funciona allí. ¿Encontraste un error? Por favor crea un issue.
Ejecuta esto en PowerShell:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
El instalador se encarga de todo: uv, Python 3.11, Node.js, ripgrep, ffmpeg, y un Git Bash portátil (MinGit, descomprimido en %LOCALAPPDATA%\hermes\git — no requiere administrador, completamente aislado de cualquier instalación de Git del sistema). Hermes usa este Git Bash incluido para ejecutar comandos de shell.
Si ya tienes Git instalado, el instalador lo detecta y lo usa en su lugar. De lo contrario, una descarga de ~45MB de MinGit es todo lo que necesitas — no tocará ni interferirá con ningún Git del sistema.
Android / Termux: La ruta manual probada está documentada en la guía de Termux. En Termux, Hermes instala el extra
.[termux]curado porque el extra completo.[all]actualmente incluye dependencias de voz incompatibles con Android.Windows: Windows nativo es totalmente compatible — el comando de PowerShell de arriba instala todo. Si prefieres usar WSL2, el comando de Linux también funciona allí. La instalación nativa de Windows se encuentra en
%LOCALAPPDATA%\hermes; WSL2 instala en~/.hermescomo en Linux.
Después de la instalación:
source ~/.bashrc # recargar shell (o: source ~/.zshrc)
hermes # ¡empieza a chatear!
hermes # CLI interactiva — inicia una conversación
hermes model # Elige tu proveedor y modelo LLM
hermes tools # Configura qué herramientas están habilitadas
hermes config set # Establece valores de configuración individuales
hermes gateway # Inicia el gateway de mensajería (Telegram, Discord, etc.)
hermes setup # Ejecuta el asistente de configuración completo
hermes claw migrate # Migra desde OpenClaw (si vienes de OpenClaw)
hermes update # Actualiza a la última versión
hermes doctor # Diagnostica cualquier problema
Hermes funciona con cualquier proveedor que quieras — eso no cambiará. Pero si prefieres no recopilar cinco claves API separadas para el modelo, búsqueda web, generación de imágenes, TTS y un navegador en la nube, Nous Portal las cubre todas bajo una sola suscripción:
/model <nombre>Un comando desde una instalación nueva:
hermes setup --portal
Esto te autentica vía OAuth, establece Nous como tu proveedor y activa el Tool Gateway. Comprueba qué está conectado en cualquier momento con hermes portal info. Detalles completos en la página de documentación del Tool Gateway.
Puedes seguir usando tus propias claves por herramienta cuando quieras — el gateway es por backend, no todo o nada.
Hermes tiene dos puntos de entrada: inicia la interfaz de terminal con hermes, o ejecuta el gateway y habla con él desde Telegram, Discord, Slack, WhatsApp, Signal o Email. Una vez en una conversación, muchos comandos de barra son compartidos entre ambas interfaces.
| Acción | CLI | Plataformas de mensajería |
|---|---|---|
| Empezar a chatear | hermes | Ejecuta hermes gateway setup + hermes gateway start, luego envía un mensaje al bot |
| Nueva conversación | /new o /reset | /new o /reset |
| Cambiar modelo | /model [proveedor:modelo] | /model [proveedor:modelo] |
| Establecer personalidad | /personality [nombre] | /personality [nombre] |
| Reintentar o deshacer último turno | /retry, /undo | /retry, /undo |
| Comprimir contexto / ver uso | /compress, /usage, /insights [--days N] | /compress, /usage, /insights [days] |
| Explorar habilidades | /skills o /<nombre-habilidad> | /<nombre-habilidad> |
| Interrumpir trabajo actual | Ctrl+C o enviar un nuevo mensaje | /stop o enviar un nuevo mensaje |
| Estado específico de plataforma | /platforms | /status, /sethome |
Para las listas de comandos completas, consulta la guía de CLI y la guía del Gateway de Mensajería.
Toda la documentación está en hermes-agent.nousresearch.com/docs:
| Sección | Contenido |
|---|---|
| Inicio rápido | Instalar → configurar → primera conversación en 2 minutos |
| Uso de CLI | Comandos, atajos de teclado, personalidades, sesiones |
| Configuración | Archivo de configuración, proveedores, modelos, todas las opciones |
| Gateway de Mensajería | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| Seguridad | Aprobación de comandos, emparejamiento por DM, aislamiento en contenedor |
| Herramientas y Toolsets | Más de 40 herramientas, sistema de toolsets, backends de terminal |
| Sistema de Habilidades | Memoria procedimental, Skills Hub, creación de habilidades |
| Memoria | Memoria persistente, perfiles de usuario, mejores prácticas |
| Integración MCP | Conecta cualquier servidor MCP para capacidades extendidas |
| Programación Cron | Tareas programadas con entrega a plataforma |
| Archivos de Contexto | Contexto de proyecto que da forma a cada conversación |
| Arquitectura | Estructura del proyecto, bucle del agente, clases principales |
| Contribuir | Configuración de desarrollo, proceso de PR, estilo de código |
| Referencia de CLI | Todos los comandos y flags |
| Variables de Entorno | Referencia completa de variables de entorno |
Si vienes de OpenClaw, Hermes puede importar automáticamente tu configuración, memorias, habilidades y claves API.
Durante la configuración inicial: El asistente de configuración (hermes setup) detecta automáticamente ~/.openclaw y ofrece migrar antes de que comience la configuración.
En cualquier momento después de instalar:
hermes claw migrate # Migración interactiva (preset completo)
hermes claw migrate --dry-run # Vista previa de qué se migraría
hermes claw migrate --preset user-data # Migrar sin secretos
hermes claw migrate --overwrite # Sobreescribir conflictos existentes
Qué se importa:
~/.hermes/skills/openclaw-imports/--workspace-target)Consulta hermes claw migrate --help para todas las opciones, o usa la habilidad openclaw-migration para una migración guiada interactiva por el agente con vistas previas de dry-run.
¡Las contribuciones son bienvenidas! Consulta la Guía de Contribución para la configuración del desarrollo, el estilo de código y el proceso de PR.
Inicio rápido para colaboradores — clona y comienza con setup-hermes.sh:
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
./setup-hermes.sh # instala uv, crea venv, instala .[all], enlaza ~/.local/bin/hermes
./hermes # detecta automáticamente el venv, no necesitas hacer `source` primero
Ruta manual (equivalente a lo anterior):
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv .venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh
MIT — ver LICENSE.
Creado por Nous Research.