Coloque o Hermes Pra Rodar
O Hermes Agent v0.8.0 instala em cerca de 60 segundos no Linux, macOS ou WSL2. Um comando curl, e o instalador cuida do uv, Python 3.11, Node.js, ripgrep e ffmpeg pra você.
checklist Requisitos do Sistema
Só o git é pré-requisito — Python 3.11, Node.js v22, uv, ripgrep e ffmpeg são instalados pelo script
Linux, macOS, WSL2 no Windows, ou Android via Termux. Windows nativo não é suportado.
2 GB de RAM mínimo; mais se rodar modelos locais
~1 GB para o agente, venv, módulos Node e skills nativos
Opcional: Docker, SSH, Daytona, Singularity ou Modal para execução isolada de comandos
Conexão com internet necessária para APIs de modelo hospedadas. Modelos locais via endpoint compatível com OpenAI funcionam offline.
O comando de uma linha dos docs oficiais. Recomendado pra maioria dos usuários em Linux, macOS ou WSL2. Docs de instalação arrow_forward
WSL2 (Windows)
Windows nativo não é suportado. Execute dentro de um shell WSL2 após 'wsl --install'.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash macOS / Linux / WSL2
Só o git é pré-requisito — o instalador cuida do uv, Python 3.11, Node.js v22, ripgrep e ffmpeg.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash verified Verifique Sua Instalação
Execute os comandos de verificação listados nos docs oficiais.
hermes version Mostra a versão instalada (deve ser 0.8.0 ou posterior).
hermes doctor Roda uma verificação diagnóstica — Python, uv, dependências, arquivos de config e conectividade.
hermes status Mostra sua configuração atual: provedor de modelo, ferramentas habilitadas e gateways conectados.
settings Configuração Inicial
Após a instalação, recarregue o shell e execute os três comandos de setup dos docs.
Escolha um provedor de modelo
Execute 'hermes model' para escolher um provedor. O README lista Nous Portal, OpenRouter, z.ai/GLM, Kimi/Moonshot, MiniMax, OpenAI e endpoints customizados. Anthropic e Mistral também são dependências inclusas.
Habilite as ferramentas que quiser
Execute 'hermes tools' para configurar quais das 47 ferramentas nativas ficam habilitadas. Você pode adicionar ou remover depois.
Execute o assistente completo de setup
Execute 'hermes setup' para percorrer o assistente completo, incluindo API keys e conexões de gateway de chat (Telegram, Discord, Slack, WhatsApp, Signal, Email).
Envie uma mensagem de teste
Tente 'hermes chat -q "Olá! Que ferramentas você tem disponíveis?"' — direto do quickstart oficial.
.env — A config fica em ~/.hermes/ — config.yaml para configurações principais, .env para API keys, mais subdiretórios para sessões, logs, memórias, skills e cron jobs. Veja a referência de env-vars em hermes-agent.nousresearch.com/docs/reference/environment-variables.
cloud Deploy em VPS / Servidor
O Hermes roda em qualquer VPS Linux com 2 GB de RAM e ~1 GB de disco. O mesmo comando de uma linha funciona via SSH.
Conecte ao servidor via SSH
Qualquer distro Linux funciona — Ubuntu, Debian, CentOS, Arch, etc.
ssh user@ip-do-seu-servidor Execute o instalador
O script detecta sua distro automaticamente, instala Python 3.11 via uv e configura todas as dependências.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Habilite um backend de sandbox
Em infraestrutura compartilhada, configure um dos backends de sandbox (Docker, SSH, Daytona, Singularity ou Modal) para que os comandos shell do Hermes rodem isolados. Veja o README para setup específico de cada backend.
Defina sua API key e inicie
Escolha um provedor de modelo e inicie o Hermes. Use tmux ou screen para persistência — o processo roda em foreground.
hermes model && hermes Tip — Para um daemon persistente, rode o Hermes dentro de tmux/screen ou escreva um unit file do systemd. Confira os docs oficiais para setup de daemon.
system_update_alt Atualizando o Hermes
O README documenta um atualizador nativo: 'hermes update'. Não existe pacote PyPI publicado ou imagem Docker, então outros caminhos de atualização passam pelo git. Guia de atualização 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 # Nenhuma imagem Docker oficial publicada ainda Veja github.com/NousResearch/hermes-agent/releases para o que tem em cada versão.
delete_forever Desinstalando o Hermes
O Hermes instala em ~/.hermes/hermes-agent/ e cria symlink do binário em ~/.local/bin/hermes. Remover ambos leva dois comandos. Notas de desinstalação arrow_forward
rm ~/.local/bin/hermes rm -rf ~/.hermes/hermes-agent rm -rf ~/.hermes/hermes-agent # Nenhuma imagem Docker oficial para remover Remover dados do usuário (opcional)
Isso apaga suas sessões, memórias, skills, cron jobs e API keys. Faça backup do que precisar antes.
rm -rf ~/.hermes # Execute dentro do shell WSL — Windows nativo não é suportado build Solução de Problemas
Retirado da tabela de troubleshooting dos docs de instalação e falhas comuns do script. Mais dicas de troubleshooting arrow_forward
Precisa de Ajuda?
Entre no Discord da Nous Research para suporte na instalação e troubleshooting com a comunidade.