Hermes Agent es un agente de IA de código abierto de Nous Research que se ejecuta desde la terminal, se conecta con distintos proveedores de modelos, recuerda contexto útil entre sesiones y se puede ampliar con herramientas, skills, puertas de enlace de mensajería y automatización. Esta guía te ayuda a instalar Hermes. No necesitas instalar Python ni Node.js manualmente para usar el instalador estándar en macOS o Windows, ya que el instalador oficial se encarga de las dependencias principales.
Antes de instalar Hermes Agent
Hermes Agent es un software orientado a la terminal, por lo que lo instalarás desde la línea de comandos. Elige la sección correspondiente a tu computadora:
macOS: abre Terminal desde Aplicaciones > Utilidades > Terminal, o presiona Command + Space y busca "Terminal".
Windows: primero instala WSL2, abre la terminal de tu distribución de Linux y luego sigue el comando para Linux.
También necesitas Git. Comprueba si Git está instalado:
Resultado esperado:
Si aparece git: command not found, instala Git primero:
Si no tienes Homebrew en macOS, instala Git desde Apple Command Line Tools ejecutando:
Paso 1: Instala Hermes Agent en macOS o Windows
En la terminal, copia y pega el comando del instalador oficial:
El instalador descarga Hermes Agent, prepara su entorno de Python, instala las dependencias necesarias y agrega el comando hermes a la ruta de tu shell. En una instalación de usuario normal, los datos de Hermes se almacenan en ~/.hermes/.
Cuando termine el comando, recarga tu shell:
Si usas Zsh, algo habitual en macOS, ejecuta:
Resultado esperado:
Ahora confirma que el comando de Hermes Agent esté disponible:
Resultado esperado:
El número de versión exacto puede cambiar a medida que se actualiza Hermes Agent.
Paso 2: Configura tu proveedor de modelos
Hermes Agent necesita un proveedor de modelos antes de poder responder o usar herramientas. La configuración interactiva es la opción más sencilla para principiantes:
El asistente te permite elegir un proveedor como Kimi/Moonshot. No configures el enrutamiento, la alternativa de respaldo, la puerta de enlace ni cron hasta que funcione un chat básico.
Selecciona el modelo predeterminado. Kimi K3 es el modelo insignia más reciente de Kimi; si principalmente buscas programar, kimi-k2.7-code es una mejor opción.
Si ya sabes el valor que quieres establecer, puedes usar hermes config set. Por ejemplo:
Si no tienes una api-key, Kimi puede ser una buena opción.
Paso 1: Activa tu Kimi API
Antes de usar Kimi API con Hermes Agent, activa tu Kimi API Key en Kimi Platform. Recomendamos $20 o más para desbloquear el acceso al nivel 2, que reduce la latencia y ofrece un rendimiento más estable en tareas complejas de varios pasos
Paso 2: Crea tu Kimi API Key
Ve a la sección API Keys en Kimi Platform y haz clic en Create API Key. Recuerda copiar tu clave de API y guardarla de forma segura, ya que solo se muestra una vez al crearla.
Paso 3: Ingresa tu clave de API
Pega tu clave de Kimi API y conecta Hermes Agent.
Paso 3: Inicia Hermes Agent
Una vez configurado el modelo, inicia la CLI clásica:
O prueba la interfaz de terminal más reciente:
Deberías ver una pantalla de bienvenida o un prompt que muestre el proveedor/modelo seleccionado. Pruébalo con una solicitud simple:
Así se ve cuando funciona correctamente:
Si Hermes Agent se abre, pero muestra errores de modelo o autenticación, ejecuta:
Luego vuelve a elegir tu proveedor y verifica la clave de API o el inicio de sesión mediante OAuth.
Paso 4: Convierte Hermes Agent en un bot
Al igual que OpenClaw, Hermes Agent también puede funcionar como bot y conectarse a tus apps de chat:
Después de la configuración, revisa el estado de la puerta de enlace:
Usa la puerta de enlace solo después de que tu proveedor de modelos funcione en la terminal. Si la CLI no puede completar un chat básico, el bot normalmente fallará por la misma razón.
Problemas comunes al instalar Hermes Agent
hermes: command not found
Causa: tu terminal todavía no ha recargado el cambio en PATH.
Solución:
O bien:
Luego prueba:
git: command not found
Causa: falta Git.
Solución en Ubuntu, Debian o WSL2:
Solución en macOS con Homebrew:
Clave de API no configurada
Causa: Hermes Agent está instalado, pero no se configuró ninguna clave de proveedor ni inicio de sesión.
Solución:
O configura una clave manualmente:
hermes doctor informa una configuración faltante o desactualizada
Causa: es posible que tu archivo de configuración esté incompleto después de una actualización.
Solución:
El endpoint personalizado se conecta, pero da malas respuestas
Causa: la URL base, el nombre del modelo o la longitud de contexto son incorrectos.
Solución: primero prueba el endpoint en un cliente independiente, confirma que sea compatible con OpenAI y asegúrate de que el modelo admita al menos 64K de contexto para los flujos de trabajo normales de Hermes Agent.
Referencia rápida de comandos
Conclusión
La forma más sencilla de instalar Hermes Agent es usar el instalador oficial de una sola línea, recargar la shell, ejecutar hermes model y verificar la configuración con un chat real y hermes doctor. Mantén simple la configuración inicial: una máquina, un proveedor y una conversación que funcione. Cuando el asistente base de Hermes Agent sea estable, podrás ampliarlo de forma segura con aislamiento mediante Docker, bots de puerta de enlace, habilidades, automatizaciones programadas y proveedores de modelos personalizados.
Preguntas frecuentes
~/.hermes/ y puede ampliarse con habilidades, memoria, tareas programadas y puertas de enlace de mensajería.iex (irm https://hermes-agent.nousresearch.com/install.ps1) en PowerShell o usar el paquete de escritorio MSIX. WSL2 sigue siendo una alternativa opcional.hermes model, elige un proveedor, como Kimi, inicia hermes, prueba un chat normal, ejecuta hermes doctor y confirma que hermes --continue reanude tu sesión. Después, agrega aislamiento con Docker, skills, servidores MCP, voz, cron o una puerta de enlace de mensajería según lo necesites.