Pon Hermes a funcionar
Hermes Agent v0.8.0 se instala en unos 60 segundos en Linux, macOS o WSL2. Un comando curl, y el instalador se encarga de uv, Python 3.11, Node.js, ripgrep y ffmpeg por ti.
checklist Requisitos del sistema
Solo necesitas git como requisito — Python 3.11, Node.js v22, uv, ripgrep y ffmpeg los instala el script
Linux, macOS, WSL2 en Windows o Android vía Termux. Windows nativo no es compatible.
2 GB de RAM mínimo; más si usas modelos locales
~1 GB para el agente, su venv, módulos de Node y skills integrados
Opcional: Docker, SSH, Daytona, Singularity o Modal para ejecución de comandos en sandbox
Se requiere conexión a internet para APIs de modelos en la nube. Los modelos locales vía endpoint compatible con OpenAI funcionan offline.
El comando de una línea de la documentación oficial. Recomendado para la mayoría de usuarios en Linux, macOS o WSL2. Docs de instalación arrow_forward
WSL2 (Windows)
Windows nativo no es compatible. Ejecuta esto dentro de una shell WSL2 después de 'wsl --install'.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash macOS / Linux / WSL2
Solo necesitas git como requisito — el instalador se encarga de uv, Python 3.11, Node.js v22, ripgrep y ffmpeg.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash verified Verifica tu instalación
Ejecuta los comandos de verificación listados en la documentación oficial.
hermes version Muestra la versión instalada (debería ser 0.8.0 o posterior).
hermes doctor Ejecuta un diagnóstico — Python, uv, dependencias, archivos de configuración y conectividad.
hermes status Muestra tu configuración actual: proveedor de modelos, herramientas habilitadas y gateways conectados.
settings Configuración inicial
Después de instalar, recarga tu shell y ejecuta los tres comandos de configuración de la documentación.
Elige un proveedor de modelos
Ejecuta 'hermes model' para elegir un proveedor. El README lista Nous Portal, OpenRouter, z.ai/GLM, Kimi/Moonshot, MiniMax, OpenAI y endpoints personalizados. Anthropic y Mistral también vienen como dependencias.
Habilita las herramientas que quieras
Ejecuta 'hermes tools' para configurar cuáles de las 47 herramientas integradas están habilitadas. Puedes agregar o quitar después.
Ejecuta el asistente de configuración completo
Ejecuta 'hermes setup' para recorrer el asistente completo, incluyendo API keys y conexión de gateways de chat (Telegram, Discord, Slack, WhatsApp, Signal, Email).
Envía un mensaje de prueba
Prueba 'hermes chat -q "¡Hola! ¿Qué herramientas tienes disponibles?"' — directamente del quickstart oficial.
.env — La configuración vive en ~/.hermes/ — config.yaml para ajustes principales, .env para API keys, más subdirectorios para sesiones, logs, memorias, skills y cron jobs. Consulta la referencia de variables de entorno en hermes-agent.nousresearch.com/docs/reference/environment-variables.
cloud Despliegue en VPS / servidor
Hermes funciona en cualquier VPS Linux con 2 GB de RAM y ~1 GB de disco. El mismo comando de una línea funciona por SSH.
Conéctate a tu servidor por SSH
Cualquier distro Linux sirve — Ubuntu, Debian, CentOS, Arch, etc.
ssh user@tu-ip-del-servidor Ejecuta el instalador
El script auto-detecta tu distro, instala Python 3.11 vía uv y configura todas las dependencias.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Habilita un backend de sandbox
En infraestructura compartida, configura uno de los backends de sandbox (Docker, SSH, Daytona, Singularity o Modal) para que los comandos de shell de Hermes se ejecuten aislados. Consulta el README para la configuración de cada backend.
Configura tu API key y lanza
Elige un proveedor de modelos e inicia Hermes. Usa tmux o screen para persistencia — el proceso se ejecuta en primer plano.
hermes model && hermes Tip — Para un daemon persistente, ejecuta Hermes dentro de tmux/screen o escribe un archivo de unidad systemd. Consulta la documentación oficial para la configuración de daemon.
system_update_alt Actualizar Hermes
El README documenta un actualizador integrado: 'hermes update'. No hay paquete publicado en PyPI ni imagen Docker, así que otras rutas de actualización pasan por git. Guía de actualización arrow_forward
hermes update cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]" curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash # Aún no hay imagen Docker oficial publicada Consulta github.com/NousResearch/hermes-agent/releases para ver qué hay en cada versión.
delete_forever Desinstalar Hermes
Hermes se instala en ~/.hermes/hermes-agent/ y crea un symlink del binario en ~/.local/bin/hermes. Eliminar ambos toma dos comandos. Notas de desinstalación arrow_forward
rm ~/.local/bin/hermes rm -rf ~/.hermes/hermes-agent rm -rf ~/.hermes/hermes-agent # No hay imagen Docker oficial que eliminar Eliminar datos de usuario (opcional)
Esto borra tus sesiones, memorias, skills, cron jobs y API keys. Haz respaldo de lo que necesites antes.
rm -rf ~/.hermes # Ejecuta dentro de tu shell WSL — Windows nativo no es compatible build Solución de problemas
Sacado de la tabla de solución de problemas de la documentación de instalación y errores comunes del script. Más tips de solución de problemas arrow_forward
¿Necesitas ayuda?
Únete al Discord de Nous Research para soporte de instalación y solución de problemas de la comunidad.