Como instalar o Hermes Agent na VPS com aplicativo pronto e hermes setup

Para instalar o Hermes Agent sem montar o ambiente do zero, use o aplicativo pré-configurado da VPS da Hostinger. Na página de VPS da Hostinger, o Hermes Agent aparece na categoria IA/ML. Segundo a página do Hermes Agent na Hostinger, ele é implantado com um clique a partir de um template Docker pronto. Depois disso, você roda hermes setup --portal, que faz o login OAuth e configura o provedor de modelo e as ferramentas sem editar YAML, conforme a documentação oficial de configuração.

O Hermes Agent é um projeto da Nous Research, com código no repositório NousResearch/hermes-agent e documentação em hermes-agent.nousresearch.com/docs. A Hostinger o descreve como um agente de IA que se aprimora sozinho, com painel de administração no navegador e mensagens em várias plataformas.

O que você precisa antes de instalar o Hermes Agent na VPS

A lista é curta, mas completa. São três coisas:

• Um plano de VPS da Hostinger. Segundo a página do Hermes Agent na Hostinger, os planos incluem o terminal web da VPS e o Hostinger Agent sem custo extra.
• Um navegador. O hermes setup --portal abre o login OAuth em portal.nousresearch.com, e é por lá que você autoriza o acesso.
• Acesso a uma conta no Nous Portal. É nela que você autoriza o provedor de modelo e as ferramentas do Tool Gateway durante o hermes setup --portal.

Antes de seguir, se liga numa confusão MUITO comum. São quatro coisas diferentes:

• O template Docker na VPS: o aplicativo pronto que a Hostinger instala no seu servidor.
• O software Hermes Agent: o agente em si, com repositório oficial no GitHub.
• O provedor e o modelo de IA: quem processa as respostas do agente, definido na configuração.
• O Hermes Agent gerenciado da Hostinger: um produto separado, com setup sem manutenção.

Só esse produto gerenciado anuncia créditos de IA pré-configurados. Pagar a VPS, por si só, não comprova que você tem créditos de IA incluídos.

Então pense na VPS como o terreno e no modelo como a energia elétrica. O template constrói a casa, mas a conta de luz é outro contrato. Se o custo do modelo te preocupa, vale entender como gastar menos por tarefa antes de escolher o provedor.

Passo a passo: do aplicativo pronto ao hermes setup

São seis passos, do servidor vazio até a configuração conferida. Cada um tem o resultado esperado e o tropeço mais comum.

1. Escolha o caminho de instalação da VPS

A VPS da Hostinger oferece três caminhos, todos instaláveis com um clique: um sistema operacional Linux, um painel de controle ou um aplicativo pré-configurado (fonte).

Por que isso importa? Porque cada caminho define quanto trabalho fica com você:

• Aplicativo pré-configurado: entrega o template Docker do Hermes pronto. É o caminho deste tutorial.
• Só o sistema operacional: você recebe o Linux limpo e monta todo o ambiente na mão.
• Painel de controle: atende outro tipo de gestão do servidor, não a instalação do agente.

Resultado esperado: você sabe que vai usar o aplicativo pré-configurado.

Erro comum deste passo: escolher apenas o sistema operacional e acabar montando na mão aquilo que o template já entrega pronto.

2. Implante o Hermes Agent pela categoria IA/ML

   Entre os aplicativos pré-configurados, procure o Hermes Agent na categoria IA/ML. A página do aplicativo descreve a implantação como um clique a partir de um template Docker, sem instalação manual.

   Resultado esperado: o template Docker do Hermes implantado na sua VPS.

   Erro comum deste passo: confundir o template em VPS com o Hermes Agent gerenciado e esperar créditos de IA que esse plano não anuncia.

3. Rode o hermes setup --portal

Agora vem a parte que tira o YAML do seu caminho. Execute o comando no terminal do ambiente onde o Hermes está instalado:

hermes setup --portal

Segundo a documentação de configuração, esse comando faz cinco coisas:

• abre o navegador em portal.nousresearch.com para o login OAuth;
• guarda o refresh token em ~/.hermes/auth.json;
• define model.provider: nous no config.yaml;
• escolhe um modelo agêntico padrão;
• ativa o Tool Gateway, com busca web, geração de imagem, TTS e automação de navegador.

É tipo aquele "next, next e finish", só que no terminal. Um único OAuth resolve provedor e ferramentas de uma vez.

Resultado esperado: um config.yaml funcional e o arquivo ~/.hermes/auth.json criado.

Erro comum deste passo: procurar o token dentro do config.yaml. Ele fica no auth.json, e isso é de propósito: a documentação separa credenciais de configuração.

4. Entenda a estrutura de ~/.hermes

   Saber onde cada coisa mora evita MUITA dor de cabeça depois. A documentação oficial descreve a pasta assim:

   ~/.hermes/
   ├── config.yaml   # configurações: modelo, terminal, TTS, compressão etc.
   ├── .env          # chaves de API e segredos (modo 0600)
   ├── auth.json     # credenciais OAuth de provedores, como o Nous Portal
   ├── SOUL.md       # identidade principal do agente (posição 1 no system prompt)
   ├── memories/     # memória persistente: MEMORY.md, USER.md
   ├── skills/       # skills criadas pelo agente, geridas pela ferramenta skill_manage
   ├── cron/         # tarefas agendadas
   ├── sessions/     # sessões do gateway
   └── logs/         # errors.log e gateway.log, com segredos ocultados automaticamente

   E quando o mesmo ajuste aparece em dois lugares, quem ganha? A ordem de precedência é esta:

5. argumentos de CLI;
6. ~/.hermes/config.yaml;
7. ~/.hermes/.env;
8. padrões internos.

   Essa pasta também é o que você leva junto quando troca de servidor. O guia de migrar o Hermes Agent parte exatamente dessa estrutura.

   Resultado esperado: você sabe onde ficam segredos, configuração, identidade e memória do agente.

   Erro comum deste passo: colocar chave de API no config.yaml. Segredo vai no .env, que tem permissão 0600, e o resto vai no config.yaml.

9. Confira a configuração

   Dois comandos resolvem a checagem. O primeiro mostra a configuração atual e o segundo aponta opções ausentes:

   hermes config
   hermes config check

   Para ler ou mudar um valor específico, a documentação traz estes exemplos:

   hermes config get model
   hermes config set terminal.backend docker

   O hermes config set já manda cada valor pro arquivo certo: chave de API vai para o .env e o restante vai para o config.yaml. Se o config check acusar opções faltando, o hermes config migrate adiciona essas opções de forma interativa.

   Resultado esperado: hermes config get model mostra o modelo configurado e o hermes config check não aponta pendências.

   Erro comum deste passo: atualizar o Hermes e não rodar o hermes config check. A documentação indica esse comando justamente para depois das atualizações.

10. Opere e mantenha o agente

Com o agente rodando, a manutenção passa a ser do servidor. Segundo a página do Hermes Agent na Hostinger, os planos de VPS incluem firewall integrado, backups automáticos semanais gratuitos e ferramentas de gerenciamento de Docker.

Use o firewall para expor só o que precisa e conte com os backups semanais como rede de proteção para a pasta ~/.hermes. A mesma página lembra que, hospedando o agente na sua VPS, as chaves de API, o histórico de conversas e o contexto ficam na sua própria infraestrutura.

Quer separar usos diferentes? Cada perfil nomeado é uma home isolada, com config.yaml, .env, SOUL.md, memórias, sessões, skills e tarefas cron próprios. Dá pra separar perfis de trabalho e pessoal sem misturar memória e credenciais.

Resultado esperado: agente protegido por firewall, coberto por backup e organizado por perfil quando necessário.

Erro comum deste passo: tratar backup e firewall como "depois eu vejo". Já que o .env e o auth.json guardam credenciais, a VPS vira o cofre delas.

Como foi a checagem de conexão no vídeo do Hermes Desktop

No vídeo "Hermes Desktop: O App Que Roda Agente IA Local OU Em VPS", eu mostro o Hermes que já rodava numa VPS sendo conectado ao app desktop.

Lá, a porta usada foi a 8642: a mesma na configuração do .env, no teste com curl e no Server URL do app.

Aí fiz um curl local nessa porta, e a resposta voltou com status ok e a lista de agentes e plataformas.

Próximo passo depois de instalar o Hermes Agent

Abra o ~/.hermes/SOUL.md e escreva a identidade do seu agente. Ele ocupa a posição 1 no system prompt, então é ali que o Hermes deixa de ser genérico e vira o SEU agente.

Depois, transforme o hermes config check em hábito: rodou atualização, rodou o check. Se aparecer pendência, o hermes config migrate resolve.

Para ajustes além do básico, a seção de configuração da documentação oficial é a referência. Bora colocar o agente pra trabalhar 🙂.

Acompanhe os tutoriais do Hora de Codar no YouTube. Se quiser aprofundar o contexto, veja Hermes Agent: O Agente de IA que APRENDE Sozinho (Tutorial Completo).

Transparência: a Hostinger é parceira da Hora de Codar, e é nas VPS dela que rodam o nosso blog e os nossos sistemas. Esta recomendação vem do que usamos todo dia.