Guía

Instalar Hermes Agent en un Mac mini

Hermes Agent se instala en un Mac con Apple silicon con un solo script. El script prepara su propio Python y sus herramientas. Después, dos comandos eligen un modelo y convierten el gateway de mensajería en un servicio de launchd. Aquí tienes los pasos oficiales, lo que imprimió nuestra instalación de prueba y cómo mantenerlo activo a todas horas.

Qué es Hermes Agent

Hermes Agent es un agente de código abierto de Nous Research, con licencia MIT. Guarda memoria entre sesiones y escribe sus propias skills a medida que aprende tu trabajo. Un gateway lo conecta a Telegram, Discord, WhatsApp y otras apps de chat (github.com/NousResearch/hermes-agent, octubre de 2026).

Puedes usarlo como chat en la terminal, igual que otros agentes de programación. O puedes dejar el gateway en marcha y escribirle desde el móvil. Esa segunda forma es la razón por la que la gente lo quiere en un Mac siempre encendido.

Requisitos

  • Apple silicon. La documentación de instalación dice que el instalador de macOS es solo para Apple silicon y que los Mac con Intel no son compatibles (octubre de 2026).
  • Python 3.11 a 3.14, git y curl. El instalador prepara su propio Python, Node, ffmpeg y ripgrep, así que un Mac limpio sirve.
  • Un modelo. Hermes funciona con Anthropic, OpenAI, OpenRouter, Nous Portal y muchos otros. Su documentación de proveedores menciona claves de API, inicio de sesión en el navegador y algunos planes de suscripción. También acepta cualquier endpoint local compatible con OpenAI, como Ollama.

Instálalo

Este es el comando documentado para macOS. Recarga tu shell después.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc

Para un script o una shell remota, el instalador acepta opciones que se saltan las preguntas y las herramientas opcionales de navegador y computer use. Las usamos en nuestra prueba.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive --skip-browser --skip-computer-use

Lo ejecutamos dos veces en máquinas macOS 26 alojadas en GitHub el 2 de octubre de 2026. Tardó unos 2 minutos una vez y 6,5 minutos la otra, casi todo en descargas. La comprobación de versión imprimió esto.

$ hermes --version
Hermes Agent v0.21.5+5635.g5bba024 (2026.9.24) · upstream 5bba024d

Conviene saber qué quedó dónde. El instalador clonó el código en una carpeta hermes dentro de tu carpeta de inicio. Puso sus propias copias de Python 3.14.7, Node, ffmpeg y ripgrep en una carpeta tools dentro de ella. El comando hermes fue a la carpeta bin local de tu carpeta de inicio. También añadió 58 skills incluidas, entre ellas algunas para Notas, Recordatorios e iMessage de Apple. Son una razón para ejecutar Hermes en un Mac y no en un equipo Linux.

Ahora elige un modelo y ejecuta el asistente de configuración.

hermes model
hermes setup
hermes doctor

¿Vienes de OpenClaw? El README incluye un comando que importa tus ajustes de OpenClaw.

hermes claw migrate

Mantén el gateway en marcha 24/7

Primero conecta tus apps de chat. Después instala el gateway como servicio. En macOS, eso es un agente de launchd.

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
tail -f ~/.hermes/logs/gateway.log

Ejecutamos el comando de instalación en una máquina de prueba sin ninguna app de chat configurada todavía. Su usuario se llama runner. La comprobación de estado confirmó que launchd estaba ejecutando el gateway.

$ hermes gateway install
Installing launchd service to: /Users/runner/Library/LaunchAgents/ai.hermes.gateway.plist
✓ Service installed and loaded!
$ hermes gateway status
✓ Service definition matches the current Hermes install
✓ Gateway is supervised by launchd (PID 14390)
  Auto-start at login and auto-restart on crash are available.

El archivo del servicio está configurado para ejecutarse al cargarse, así que vuelve en cada inicio de sesión. También reinicia el gateway si termina con un error. Un detalle de la documentación de mensajería. Si instalas herramientas nuevas más adelante, ejecuta otra vez el comando de instalación para que el servicio coja el nuevo PATH.

Como cualquier LaunchAgent, necesita un usuario con la sesión iniciada. Activa el inicio de sesión automático y luego desactiva el reposo.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Para una sesión de terminal que sobreviva a un corte de conexión, ejecuta el agente interactivo dentro de tmux. Los pasos están en nuestra guía de tmux. Funcionan igual con Hermes.

Notas de seguridad

  • El gateway rechaza a todo el mundo hasta que lo permites. Define una lista de IDs de usuario permitidos, o aprueba a las personas una a una con códigos de emparejamiento. Los códigos caducan al cabo de una hora.
  • Las aprobaciones tienen tres modos: manual, smart y off. Off equivale a la opción yolo. Déjalo en manual hasta que confíes en tu configuración.
  • Guarda las claves de API en el archivo env de la carpeta hermes, con permisos de lectura solo para ti. Nunca hagas commit de él.
  • Para más aislamiento, la documentación de seguridad explica cómo ejecutar los comandos en un contenedor Docker en lugar de en el propio Mac.
# in ~/.hermes/.env
TELEGRAM_ALLOWED_USERS=123456789

# or approve one person by pairing code
hermes pairing approve telegram XKGH5N7P
chmod 600 ~/.hermes/.env

Según la documentación, algunas protecciones se mantienen incluso en modo yolo. Una lista de bloqueo fija detiene comandos como un borrado recursivo de todo el disco. Sus herramientas de archivos se niegan a escribir en las carpetas de ssh y aws.

Ejecutarlo en un Mac de MacRun

Nuestro plan de agentes te da un Mac mini dedicado con el reposo desactivado. Su sesión vuelve sola tras un reinicio. Claude Code y Codex vienen preinstalados. Hermes no. Lo instalas con el script de arriba usando tu acceso de administrador. Si conectas Hermes a un modelo en la nube, el M6 base de 16 GB es más que suficiente.

Quién no debería alquilar un Mac para esto. Hermes también funciona en Linux. Si no necesitas Xcode, Notas de Apple ni iMessage, un servidor Linux es más barato. Y MacRun es para trabajo de desarrollo, así que úsalo para programar, compilar y tareas del repositorio, no como asistente personal para tu vida.

Mira qué incluye el plan de agentes en la página del Mac para agentes.

Preguntas frecuentes

¿Hermes Agent funciona en un Mac con Intel?

+

No. La documentación de instalación de Hermes Agent dice que el instalador de macOS solo es compatible con Apple silicon, a fecha de octubre de 2026.

¿Cómo ejecuto Hermes Agent en segundo plano en macOS?

+

Ejecuta hermes gateway install. Crea un agente de launchd que arranca al iniciar sesión. Usa hermes gateway start, stop y status para gestionarlo.

¿Puede Hermes Agent usar un modelo local?

+

Sí. Su documentación de proveedores dice que funciona con cualquier endpoint compatible con OpenAI, incluidos Ollama y LM Studio. Elígelo con hermes model.

¿Dónde guarda Hermes Agent las claves de API?

+

En el archivo env de la carpeta hermes, dentro de tu carpeta de inicio. La documentación de seguridad recomienda aplicarle chmod 600 y no hacer nunca commit de él.

Guías relacionadas