Como instalar o Hermes Agent em um Mac mini

O que é o Hermes Agent

O Hermes Agent é um agente de código aberto da Nous Research, sob a licença MIT. Ele guarda memória entre sessões e escreve as próprias skills conforme aprende o seu trabalho. Um gateway conecta o agente ao Telegram, Discord, WhatsApp e outros apps de chat (github.com/NousResearch/hermes-agent, outubro de 2026).

Você pode usar como um chat no terminal, como outros agentes de programação. Ou pode deixar o gateway rodando e mandar mensagens pelo celular. Esse segundo jeito é o motivo de as pessoas quererem o agente em um Mac sempre ligado.

Requisitos

• Apple silicon. A documentação de instalação diz que o instalador para macOS é só para Apple silicon, e Macs Intel não são suportados (outubro de 2026).
• Python 3.11 a 3.14, git e curl. O instalador prepara o próprio Python, Node, ffmpeg e ripgrep, então um Mac limpo serve.
• Um modelo. O Hermes funciona com Anthropic, OpenAI, OpenRouter, Nous Portal e muitos outros. A documentação de provedores lista API keys, login pelo navegador e alguns planos de assinatura. Ele também aceita qualquer endpoint local compatível com a OpenAI, como o Ollama.

Instale

Este é o comando documentado para macOS. Recarregue o shell depois.

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

Para um script ou um shell remoto, o instalador aceita flags que pulam as perguntas e as ferramentas opcionais de navegador e de uso do computador. Usamos essas flags no nosso teste.

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

Rodamos duas vezes em máquinas macOS 26 hospedadas pelo GitHub em 2 de outubro de 2026. Levou cerca de 2 minutos em uma vez e 6,5 minutos na outra, quase tudo em downloads. A verificação de versão mostrou isto.

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

Ajuda saber o que foi parar onde. O instalador clonou o código em uma pasta hermes na sua pasta pessoal. Ele colocou cópias próprias do Python 3.14.7, Node, ffmpeg e ripgrep em uma pasta tools dentro dela. O comando hermes foi para a pasta local bin da sua pasta pessoal. Ele também adicionou 58 skills incluídas, entre elas skills para Apple Notes, Reminders e iMessage. Elas são um motivo para rodar o Hermes em um Mac e não em uma máquina Linux.

Agora escolha um modelo e rode o assistente de configuração.

hermes model
hermes setup
hermes doctor

Vem do OpenClaw? O README lista um comando que importa as suas configurações do OpenClaw.

hermes claw migrate

Mantenha o gateway rodando 24/7

Primeiro conecte os seus apps de chat. Depois instale o gateway como serviço. No macOS isso é um agente do launchd.

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

Rodamos o comando de instalação em uma máquina de teste sem nenhum app de chat configurado ainda. O usuário dela se chama runner. A verificação de status confirmou que o launchd estava rodando o 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.

O arquivo de serviço está configurado para rodar ao carregar, então ele volta a cada login. Ele também reinicia o gateway se ele sair com erro. Um detalhe da documentação de mensagens. Se você instalar ferramentas novas depois, rode o comando de instalação de novo para o serviço pegar o novo PATH.

Como qualquer LaunchAgent, ele precisa de um usuário logado. Ative o login automático e depois desligue o repouso.

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

Para uma sessão de terminal que sobrevive a uma queda de conexão, rode o agente interativo dentro do tmux. Os passos estão no nosso guia de tmux. Eles funcionam do mesmo jeito para o Hermes.

Notas de segurança

• O gateway recusa todo mundo até você permitir. Defina uma lista de permissão de IDs de usuário, ou aprove pessoas uma por vez com códigos de pareamento. Os códigos expiram depois de uma hora.
• As aprovações têm três modos: manual, smart e off. Off é o mesmo que a flag yolo. Deixe em manual até confiar na sua configuração.
• Guarde as API keys no arquivo env da pasta hermes, legível só por você. Nunca faça commit dele.
• Para mais isolamento, a documentação de segurança mostra como rodar comandos em um contêiner Docker em vez de no próprio Mac.

# in ~/.hermes/.env
TELEGRAM_ALLOWED_USERS=123456789

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

Algumas proteções valem até no modo yolo, segundo a documentação. Uma lista de bloqueio fixa impede comandos como apagar recursivamente o disco inteiro. As ferramentas de arquivo se recusam a escrever nas pastas ssh e aws.

Rodando em um Mac da MacRun

Nosso plano agente dá a você um Mac mini dedicado com o repouso desligado. A sessão de login volta sozinha depois de reinicializar. O Claude Code e o Codex vêm pré-instalados. O Hermes não. Você instala com o script acima usando o seu acesso de administrador. Se você apontar o Hermes para um modelo na nuvem, o M6 básico de 16 GB sobra.

Quem não deve alugar um Mac para isso. O Hermes também roda no Linux. Se você não precisa de Xcode, Apple Notes ou iMessage, um servidor Linux sai mais barato. No plano agente, o Hermes pode trabalhar nas suas próprias contas, incluindo o seu email, calendário e chats. Mensagens em massa ou não solicitadas não são permitidas, conforme a nossa política de uso aceitável.

Veja o que o plano agente inclui na página do Mac para agentes.