Hermes Agent es un agente de IA de código abierto de Nous Research que se ejecuta desde tu terminal, se conecta a distintos proveedores de modelos, recuerda contexto útil entre sesiones y se puede ampliar con herramientas, skills, pasarelas de mensajería y automatizaciones. Esta guía te ayuda a saber cómo instalar Hermes. No necesitas instalar manualmente Python ni Node.js para el instalador estándar en macOS o Windows, porque el instalador oficial se encarga de las dependencias principales por ti.
Antes de instalar Hermes Agent
Hermes Agent es un software orientado a la terminal, así que lo instalarás desde una línea de comandos. Elige la sección que corresponda a tu computadora:
macOS: abre Terminal desde Aplicaciones > Utilidades > Terminal, o presiona Command + Espacio y busca "Terminal."
Windows: instala primero WSL2, abre la terminal de tu distribución de Linux y luego sigue el comando de Linux.
También necesitas Git. Verifica si Git está instalado:
Resultado esperado:
Si ves git: command not found, instala Git primero:
Si no tienes Homebrew en macOS, instala Git desde las Apple Command Line Tools ejecutando:
Paso 1: Instala Hermes Agent en macOS o Windows
En tu terminal, copia y pega el comando oficial de instalación:
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 normal de usuario, los datos de Hermes se almacenan en ~/.hermes/.
Cuando el comando termine, recarga tu shell:
Si usas Zsh, algo común en macOS, ejecuta:
Resultado esperado:
Ahora confirma que el comando de Hermes Agent esté disponible:
Resultado esperado:
El número exacto de versión puede cambiar a medida que Hermes Agent se actualiza.
Paso 2: Configura tu proveedor de modelos
Hermes Agent necesita un proveedor de modelos antes de poder responder o usar herramientas. La configuración más sencilla para principiantes es interactiva:
El asistente te permite elegir un proveedor como Kimi/Moonshot. No configures enrutamiento, respaldo (fallback), gateway ni cron hasta que un chat básico funcione.
Selecciona el modelo predeterminado. kimi-k2.6 es, hasta ahora, el modelo más avanzado de Kimi.
Si ya sabes qué valor 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 API de Kimi
Antes de usar la API de Kimi con Hermes Agent, activa tu clave de la API de Kimi en la Plataforma abierta de Kimi. Recomendamos $20 o más para desbloquear el acceso Tier 2, que reduce la latencia y ofrece un rendimiento más estable para tareas complejas de varios pasos.
Paso 2: Crea tu clave de la API de Kimi
Ve a la sección API Keys en la Plataforma abierta de Kimi 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 la API de Kimi y conecta Hermes Agent.
Paso 3: Inicia Hermes Agent
Una vez configurado el modelo, inicia la CLI clásica:
O prueba la nueva interfaz de terminal:
Deberías ver una pantalla de bienvenida o un prompt que muestre el proveedor/modelo seleccionado. Pruébalo con una solicitud simple:
El éxito se ve así:
Si Hermes Agent se abre pero responde con 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 de OAuth.
Paso 4: convierte Hermes Agent en un bot
Igual que OpenClaw, Hermes Agent también puede funcionar como un bot y conectarse a tus aplicaciones de chat:
Después de la configuración, revisa el estado del gateway:
Usa el gateway solo después de que tu proveedor de modelo 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 aún no ha recargado el cambio en el PATH.
Solución:
O bien:
Luego intenta:
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 hay una clave de proveedor o inicio de sesión configurado.
Solución:
O configura una clave manualmente:
hermes doctor reporta configuración faltante o desactualizada
Causa: tu archivo de configuración puede estar incompleto después de una actualización.
Solución:
El endpoint personalizado se conecta pero da respuestas incorrectas
Causa: la URL base, el nombre del modelo o la longitud del contexto son incorrectos.
Solución: prueba primero el endpoint en un cliente separado, 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 fácil de instalar Hermes Agent es usar el instalador oficial de una sola línea, recargar tu shell, ejecutar hermes model y verificar la configuración con un chat real más hermes doctor. Mantén tu primera configuración simple: una máquina, un proveedor, una conversación funcionando. Una vez que el asistente base de Hermes Agent sea estable, puedes ampliarlo de forma segura con aislamiento mediante Docker, bots de gateway, habilidades, automatizaciones programadas y proveedores de modelos personalizados.
Preguntas frecuentes
~/.hermes/ y se puede ampliar con habilidades, memoria, tareas programadas y pasarelas de mensajería.hermes model, elige un proveedor, como Kimi, inicia hermes, prueba un chat normal, ejecuta hermes doctor y confirma que hermes --continue reanuda tu sesión. Después de eso, agrega aislamiento con Docker, habilidades, servidores MCP, voz, tareas programadas (cron) o una pasarela de mensajería según lo necesites.