Um roteiro prático e visual para sair de uma VPS Ubuntu 24.04 zerada até um Hermes Agent funcionando, validado, persistente e pronto para conversar por terminal, dashboard ou gateway.
$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash # instala Hermes Agent $ hermes setup # escolhe provider/modelo e ferramentas $ hermes doctor ✓ ambiente pronto para o primeiro voo
Hermes não é só um chat. Ele é um agente com memória, ferramentas, terminal, navegador, tarefas agendadas e canais de conversa. Pense nele como uma cabine de comando na VPS.
No fim, o Bruno consegue rodar `hermes`, configurar um modelo, chamar ferramentas e iniciar um gateway persistente.
Segredos ficam em `.env` ou no setup interativo. Nunca cole API key em página, print ou comando compartilhado.
Cada etapa tem comando de teste. Não considere instalado até `hermes doctor` e uma pergunta real passarem.
Execute em ordem. Os blocos têm botão para copiar. Onde aparece `SEU_USUARIO`, troque pelo usuário real da VPS.
Use SSH com chave, atualize pacotes e instale utilitários que o Hermes costuma usar.
sudo apt update sudo apt -y upgrade sudo apt install -y curl git jq tmux ripgrep fd-find build-essential python3 python3-venv python3-pip ca-certificates gnupg ufw fail2ban sudo ufw allow OpenSSH sudo ufw --force enable
Use o instalador oficial do projeto. Ao final, abra um novo shell se o PATH ainda não reconhecer `hermes`.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash exec $SHELL -l hermes --version
O caminho mais seguro é o wizard. Ele evita erro de YAML e ajuda a escolher provider/modelo.
hermes setup hermes model hermes doctor
Faça uma pergunta com tarefa real, mas de baixo risco. A ideia é testar modelo, ferramentas e resposta.
hermes chat -q "Explique em 5 linhas onde estou rodando e liste 3 próximos passos seguros para configurar esta VPS." hermes chat -q "Use ferramentas para verificar o sistema operacional e depois resuma o resultado."
Para um agente de VPS, comece com terminal, arquivos, web, skills e cron. Evite dar permissões que você ainda não entende.
hermes tools list hermes tools enable terminal hermes tools enable file hermes tools enable web hermes tools enable skills hermes tools enable cronjob
O gateway permite conversar com Hermes por plataformas como Telegram/Discord/API. O `linger` mantém o serviço vivo após logout.
sudo loginctl enable-linger $USER hermes gateway setup hermes gateway install hermes gateway start hermes gateway status journalctl --user -u hermes-gateway -n 80 --no-pager
Se o Bruno quiser dashboard web ou domínio próprio, use NGINX + TLS. Se for só Telegram/terminal, pode pular esta parte.
Suba localmente antes de expor na internet.
hermes dashboard --host 127.0.0.1 --port 9119 --no-open curl -I http://127.0.0.1:9119/
Exemplo para `hermes.seudominio.com`. Ajuste domínio, certificado e porta.
server {
listen 443 ssl http2;
server_name hermes.seudominio.com;
ssl_certificate /etc/letsencrypt/live/hermes.seudominio.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/hermes.seudominio.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:9119/;
proxy_http_version 1.1;
proxy_set_header Host 127.0.0.1:9119;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}Se algum item falhar, pare e corrija antes de chamar de pronto.
Atalhos de diagnóstico para não cair em rabbit holes.
Abra novo shell com `exec $SHELL -l` ou confira se `~/.local/bin` está no PATH.
Rode `hermes setup` de novo. Nunca cole API key em comando que vai para documentação.
Use `sudo loginctl enable-linger $USER` e instale com `hermes gateway install`.
Limpe cookies do domínio e reinicie oauth2-proxy se você mudou `cookie_secret`.
Habilite toolset e abra nova sessão: alterações de ferramentas não entram no meio do contexto.
No Ubuntu 24.04, evite instalar pacotes globais com pip. Use venv, uv ou o instalador oficial.
O caminho feliz é: preparar VPS → instalar Hermes → rodar setup → validar terminal → instalar gateway → proteger exposição web. Se uma etapa não foi validada com comando real, ela ainda não está pronta.
sudo apt update && sudo apt -y upgrade sudo apt install -y curl git jq tmux ripgrep python3 python3-venv ca-certificates curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash exec $SHELL -l hermes setup hermes doctor hermes chat -q "Faça um smoke test desta instalação do Hermes." sudo loginctl enable-linger $USER hermes gateway setup hermes gateway install && hermes gateway start && hermes gateway status