Como rodar o Hermes Agent 24/7: VPS ou hospedado

Resposta curta. O Hermes Agent responde no Telegram e no Discord e executa suas tarefas agendadas só enquanto o processo do gateway está rodando, então um agente 24/7 precisa de uma máquina que fique sempre ligada. No seu próprio VPS: um servidor Linux com pelo menos 2 GB de RAM e o script de instalação da Nous Research, executado como usuário comum por SSH (ele inicia o assistente de configuração e instala o gateway como serviço), e depois sudo loginctl enable-linger $USER para o serviço iniciar junto com o sistema; você roda hermes update e mantém o servidor seguro. Ou alugue um servidor que roda o Hermes Agent para você, em que o painel cuida da instalação, das atualizações e das reinicializações e você só cola uma chave e um token de bot.

Verificado em 7 de novembro de 2026, correto para o Hermes Agent v0.23.0.

Este guia usa a documentação do próprio Hermes Agent (hermes-agent.nousresearch.com/docs) e o que medimos rodando a v0.23.0 em nossos próprios servidores. Para ir direto à opção hospedada, veja a opção 3.

Por que um notebook não basta

O gateway de mensagens do Hermes Agent é um único processo de longa duração que atende todos os apps de chat e o agendador. Quando o notebook entra em suspensão, reinicia ou perde a rede, o agente para de responder e as tarefas agendadas não rodam. Para um servidor sem tela, a documentação do Hermes Agent descreve um serviço que inicia com o sistema e continua ativo depois que você sai da sessão.

O que você precisa

Você também precisa de uma chave de API de um provedor de IA (veja qual chave de provedor de IA usar) e de um app de chat para conversar com ele, como um bot do Telegram ou do Discord. Mais sobre memória em quanta memória o Hermes Agent precisa.

Opção 1: seu próprio VPS com o script de instalação

1. Crie o servidor com Ubuntu e pelo menos 2 GB de RAM, e conecte por SSH. A página de Docker do Hermes Agent avisa que o console de navegador de alguns provedores estraga caracteres colados como : e @; o SSH evita isso.
2. Use um usuário comum, não o root. A documentação do Hermes Agent manda executar o instalador com o usuário que vai rodar o serviço. A ferramenta de terminal do agente executa comandos nesta máquina com esse usuário, então reserve essa conta para o agente.
3. Instale. O instalador instala a última versão estável:

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

   Para deixar a instalação menor, a opção --skip-browser dispensa o Chromium dele, então a automação local do navegador fica desligada até você rodar hermes pm install chromium.
4. Configure. Quando executado por SSH, o instalador inicia o assistente de configuração sozinho: ele pede sua chave de IA, seus tokens de bot e os IDs de usuário autorizados a falar com o agente. Veja Telegram e Discord. Depois você pode rodá-lo de novo com hermes setup, ou passo a passo com hermes model e hermes gateway setup.
5. Rode como serviço. No final o instalador instala o gateway como serviço de usuário, se a configuração ainda não tiver feito isso; se você pulou essa etapa, rode hermes gateway install. Depois, uma única vez, faça-o iniciar com o sistema e continuar rodando depois que você sair da sessão:

   sudo loginctl enable-linger $USER
   hermes gateway status
   journalctl --user -u hermes-gateway -f

   A documentação do Hermes Agent recomenda esse serviço de usuário com linger para um servidor sem tela: ele inicia com o sistema, e as atualizações podem reiniciá-lo sem root. A unidade que o Hermes Agent escreve reinicia o gateway quando ele para de forma inesperada e depois de um /restart feito pelo chat. A documentação também descreve um serviço do sistema inteiro (hermes gateway install --system), mas aí cada reinicialização precisa de root, e ela alerta contra manter os dois tipos instalados.
6. Atualize com hermes update. Ele acompanha as versões estáveis, pausa o serviço, atualiza e o inicia de novo. As versões são frequentes (v0.22.5 em 23 de outubro, v0.22.6 em 2 de novembro, v0.22.7 em 3 de novembro e v0.23.0 em 5 de novembro de 2026), e no nosso teste uma atualização precisou de mais memória que a instalação.

Opção 2: seu próprio servidor com Docker

O Hermes Agent publica uma imagem oficial, nousresearch/hermes-agent, com todos os dados em uma pasta que você monta em /opt/data. Rode o assistente de configuração uma vez e depois o gateway em segundo plano:

mkdir -p ~/.hermes
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup
docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data nousresearch/hermes-agent gateway run

A documentação também publica a porta 8642, para o servidor de API e a verificação de saúde do Hermes Agent; ela diz que é opcional se você só usa apps de chat como Telegram e Discord. Instalações com Docker não aceitam hermes update: você atualiza baixando uma imagem nova e recriando o contêiner. Dentro da imagem, um supervisor de processos reinicia o gateway se ele cair.

Como manter seguro um agente hospedado por você

• Permita só a você. Sem lista de permitidos, o Hermes Agent nega acesso a todo mundo, o que é seguro. Nunca defina GATEWAY_ALLOW_ALL_USERS=true em um agente que pode executar comandos.
• Mantenha o painel web fora da internet. A documentação do Hermes Agent diz que o login com usuário e senha dele “não é adequado para exposição direta à internet pública”; para implantações públicas, ela oferece o login com Nous Portal ou OpenID Connect. No seu próprio VPS, o mais simples é acessá-lo por um túnel SSH.
• Deixe o servidor de API desligado a menos que precise dele. Ele vem desligado por padrão e, quando ligado, escuta em 127.0.0.1.
• Saiba no que o agente pode mexer. Com o terminal local padrão, os comandos rodam no próprio servidor, com o usuário que executa o Hermes Agent. Ele confere os comandos contra uma lista de padrões perigosos e, no modo “smart” padrão, pede a um modelo que os avalie; os duvidosos chegam a você no chat para aprovação. A lista de verificação de produção do Hermes Agent recomenda rodar os comandos em um contêiner (terminal.backend: docker no config.yaml).
• Faça backup de ~/.hermes: ali ficam as configurações, as chaves, a memória, as habilidades e as sessões.

Opção 3: um servidor que roda isso para você

Um servidor Hermes Agent da PlayNHost faz por você as etapas acima:

• Instalação: a primeira inicialização executa o instalador da própria Nous Research, sem as ferramentas de navegador; nos nossos testes levou cerca de 2,5 a 4 minutos.
• Atualizações: cada inicialização procura uma versão estável nova e a instala antes (cerca de 20 segundos quando não há nada novo). Se uma atualização falha, inicia a versão que você já tinha. Você pode desligar isso em Atualizar o Hermes Agent a cada inicialização, em Código, Configurações.
• Reinicializações: uma reinicialização ou atualização pedida pelo chat é iniciada de novo por você, e se o agente parar sozinho o painel o inicia outra vez em cerca de um minuto. Em Reinícios você também pode agendar uma reinicialização diária.
• Segurança: só os IDs de usuário da página Agente podem falar com o agente; nada no servidor escuta na internet; o WhatsApp é recusado; o agente é parado se abrir uma porta ou deixar mais alguém entrar.
• Sua parte: cole uma chave de provedor de IA e um token de bot do Telegram ou do Discord na aba Agente, adicione seu ID de usuário e clique em Iniciar. Suas chaves e tokens são guardados criptografados e nunca mais são exibidos.

O que você abre mão em comparação com o seu próprio VPS: não há linha de comando (nem comandos hermes, nem login do Nous Portal, nem aprovações de pareamento), nem painel web, nem automação de navegador, só Telegram e Discord, e um agente por servidor (os perfis do Hermes Agent são recusados). Você ainda pode editar os arquivos do agente em Files, e o log dele é .hermes/logs/gateway.log.

VPS ou hospedado: qual escolher

Nossa opinião: escolha um VPS se quer todos os recursos do Hermes Agent ou já administra servidores; escolha a opção hospedada se quer um agente de Telegram ou Discord sem a manutenção. O Hermes Agent em si é gratuito e de licença MIT nos dois casos; a documentação da Nous Research alerta que ninguém legítimo pede que você pague pelo agente em si. Uma hospedagem cobra pelo servidor, não pelo agente. Próximo passo: criar um servidor Hermes Agent.

A PlayNHost não é afiliada à Nous Research. O Hermes Agent é um software de código aberto sob a licença MIT.