Como configurar o Hermes Agent com o Docker

Configurar o Hermes Agent significa implantá-lo como um contêiner Docker em um servidor privado virtual (VPS), rodar o assistente de configuração para escolher um provedor de LLM e confirmar que tudo está funcionando com uma rápida sessão de chat.

Hermes Agent é um agente de IA sempre ativo e auto-aprimorador. Ele aprende com suas interações e desenvolve habilidades reutilizáveis ao longo do tempo. Depois que conclui uma tarefa, usa essa experiência para lidar melhor com outras semelhantes da próxima vez.

Você pode instalar o Hermes Agent diretamente em um servidor usando o instalador curl nativo, mas o Docker funciona melhor para implantações de VPS. Isso mantém o agente isolado do seu sistema host, e atualizar depois é tão simples quanto puxar uma nova imagem.

Veja como configurar o Hermes Agent em um VPS usando o Docker:

• Prepare seu garçom. Compre um VPS com pelo menos 2 núcleos de CPU e 8 GB de RAM. Use uma distribuição Linux como o Ubuntu.
• Abra o contêiner. Use o catálogo de aplicações do Hostinger para uma instalação com um clique, ou extraia a imagem do Docker manualmente se estiver usando outro provedor VPS.
• Configure seu provedor de LLM. Execute o assistente de configuração, selecione um provedor, insira sua chave API e escolha um modelo.
• Teste uma conversa com CLI. Certifique-se de que o agente responda corretamente e possa usar ferramentas antes de adicionar qualquer outra coisa.
• Adicione modelos, conecte um gateway e configure ferramentas. Configure provedores adicionais de LLM, adicione Telegram, Discord ou outras plataformas e ative os conjuntos de ferramentas que precisar.
• Endureça sua missão. Configure a varredura de comandos do Tirith, configure listas de permissões do gateway e adicione regras de firewall para proteger sua configuração.

1. Prepare seu ambiente VPS

Para rodar o Hermes Agent, você precisa de um servidor com distribuição Linux (Ubuntu funciona melhor), além de acesso root e uma conexão de internet estável.

Mire em um plano VPS com pelo menos 2 núcleos de CPU e 8 GB de RAM. Essa configuração lida confortavelmente com o isolamento do Docker e o processo de gateway. O próprio container consome cerca de 1 GB de RAM, ou 2–4 GB se você ativar a automação do navegador.

Após comprar seu VPS, conecte-se a ele via SSH e atualize seus pacotes de sistema:

sudo apt update && sudo apt upgrade -y

Isso ajuda a evitar conflitos de dependência ao instalar os componentes do Docker e do Hermes Agent.

Você também deve garantir e preparar seu VPS. Crie um usuário dedicado, ajuste permissões e ative a autenticação por chave pública para um acesso mais seguro.

2. Implantar o Agente Hermes com Docker

O Docker empacota o Hermes Agent e todas as suas dependências em um único container, então você não precisa instalar Python ou Node.js ou configurar manualmente variáveis de ambiente.

Existem algumas maneiras de fazê-lo rodar, dependendo do seu setup.

Se você ainda não tem um VPS, a opção mais rápida e fácil é usar o template Hermes Agent da Hostinger. Escolha o plano que preferir, complete o pagamento e o sistema instala tudo automaticamente.

Durante a configuração, você criará um nome de usuário e uma senha para acessar o terminal web do Hermes Agent.

Quando a instalação terminar, você chegará ao Docker Manager, onde o Hermes Agent aparece como um projeto Docker. Clique em Abrir ao lado dele, depois faça login usando as credenciais que você criou anteriormente.

Se você já possui um VPS Hostinger, pode implantar o Hermes Agent a partir do hPanel. Vá em VPS → OS & Panel → Sistema Operacional → Alterar o SO, procure por Hermes Agent e selecione para iniciar a instalação.

Quando a instalação terminar, vá para o Docker Manager → Projetos e abra o terminal web do Hermes Agent da mesma forma.

Se você estiver usando outro provedor de VPS, instale o Docker primeiro. Quando estiver pronto, crie um diretório de dados para o Hermes Agent e abra-o:

mkdir -p ~/.hermes

cd ~/.hermes

Depois, implante o contêiner de Agentes Hermes:

docker run -it --rm \

-v ~/.hermes:/opt/data \

nousresearch/hermes-agent setup

A flag -v ~/.hermes:/opt/data monta um diretório host no caminho de dados do contêiner. O Hermes Agent armazena seus arquivos de configuração, chaves de API, sessões, habilidades e memória nesse diretório.

3. Execute o assistente de configuração

Depois que você acessa o terminal web ou executa o container, o assistente de configuração do Hermes Agent é iniciado automaticamente. Pergunta como você quer configurar o agente.

Oferece dois caminhos:

• Configuração rápida. Abrange o provedor, modelo e mensagens. Essa é a melhor opção para a maioria dos usuários.
• Configuração completa. Adiciona seleção de backend do terminal, configurações de comportamento do agente, alternância de ferramentas e configuração de persona.

Vamos usar a configuração rápida aqui. Você pode configurar todo o resto depois, assim nada fica travado. O mago guia você por estes passos:

• Escolha um provedor de LLM. Escolha entre OpenRouter, Anthropic, OpenAI, Nous Portal, Ollama ou um endpoint personalizado.

• Digite sua chave de API. Cole a chave para o provedor escolhido.
• Escolha um modelo. Selecione um dos modelos disponíveis para o provedor escolhido.

• Conecte-se a uma plataforma de mensagens. Escolha Telegram, Discord, Slack, WhatsApp ou outra plataforma. Você pode pular isso por enquanto e testar o chat da CLI primeiro.

O Hermes Agent armazena dados sensíveis, como chaves de API, em ~/.hermes/.env, enquanto dados não sensíveis vão para ~/.hermes/config.yaml.

4. Verificar se o agente Hermes está rodando

Para verificar se o Hermes Agent está rodando corretamente após o assistente de configuração, inicie uma sessão de CLI e verifique se o agente consegue se comunicar com o modelo selecionado:

hermes

Você deve ver um banner de boas-vindas com o modelo selecionado, ferramentas disponíveis e habilidades carregadas.

Teste com um prompt que acione uma ferramenta, tipo “O que tem no meu diretório atual?” Isso confirma que o agente pode responder e executar comandos.

Para sair da sessão, digite /exit. Use Hermes para iniciar uma nova sessão, ou retome a última com Hermes – continue.

Se o agente retorna respostas vazias ou erros de conexão, a causa mais comum é uma chave de API incorreta ou um provedor mal configurado.

Execute a configuração do Hermes novamente para reconfigurar seu provedor e a chave da API. Alternativamente, use o comando Hermes Doctor para escanear todo o seu setup e identificar o problema.

5. Configurar outros modelos, gateways e ferramentas

Quando o chat CLI funcionar, você pode adicionar outro modelo, conectar uma plataforma de mensagens e configurar as ferramentas que seu fluxo de trabalho precisa.

Para adicionar um novo provedor de LLM junto ao que você configurou antes, execute o modelo Hermes. Ele guia você pela seleção do provedor e pela entrada da chave da API, assim como o assistente de configuração.

Depois de configurar vários provedores, alterne entre eles durante a sessão com o comando /model dentro do chat.

O gateway de mensagens permite que você se comunique com o Agente Hermes por meio de plataformas como Telegram, Discord, Slack, WhatsApp, Signal ou e-mail, em vez da linha de código.

Use a configuração do gateway Hermes para conectar sua plataforma preferida e siga as instruções na tela.

Depois de configurar, execute a corrida do gateway Hermes para iniciar o bot. Caso contrário, ele permanece configurado, mas inativo.

O Hermes Agent também inclui ferramentas integradas como execução de terminais, busca na web, acesso ao sistema de arquivos e geração de imagens. Abra a lista de ferramentas com as ferramentas Hermes e depois ative ou desative cada ferramenta conforme suas necessidades.

Note que algumas ferramentas, como busca na web e geração de imagens, exigem suas chaves de API funcionais.

6. Garanta a configuração do seu Agente Hermes

Proteger sua configuração de Agente Hermes cobre tanto as proteções embutidas do agente quanto as regras em nível de servidor que limitam o acesso externo.

O Agente Hermes vem com um scanner de segurança chamado Tirith. Ele verifica todos os comandos do terminal antes da execução. Ele está ativado por padrão e procura riscos como injeção rápida, exfiltração de credenciais e padrões de backdoor SSH.

Se Tirith sinalizar um comando, você verá um resumo do problema. Você pode aprovar ou negar usando /aprovar ou /negar. Para controlar como as aprovações funcionam, edite ~/.hermes/config.yaml:

approvals:

   mode: manual    # manual | smart | off

   timeout: 60 # seconds to wait for user response (default: 60)

• manual. Pede aprovação antes de cada comando potencialmente arriscado.
• inteligente. Aprova automaticamente operações de baixo risco e solicita apenas operações perigosas.
• estranho. Desativa todas as verificações de aprovação.

O gateway de mensagens também precisa de proteção. No mesmo arquivo config.yaml, adicione seu ID de usuário à lista de permitidos para cada plataforma para que só você possa enviar comandos para o bot.

Aqui está um exemplo para o Telegram:

gateway:

   telegram:

      allowed_user_ids:

         - 123456789

Substitua 123456789 pelo seu ID real de usuário do Telegram. Você pode conseguir por mensagem para @userinfobot no Telegram.

Para outras plataformas como Slack ou WhatsApp, substitua o Telegram pelo nome da plataforma e use o formato correto de ID de usuário para esse serviço.

No lado da rede, feche as portas 8642 (servidor API) e 9119 (dashboard) se você usar apenas o Hermes Agent através de plataformas de chat. O gateway cria conexões de saída, então não precisa de tráfego de entrada:

sudo ufw deny 8642

sudo ufw deny 9119

Para se manter atualizado, extraia a imagem mais recente e substitua o contêiner em execução:

docker pull nousresearch/hermes-agent:latest

docker rm -f hermes

docker run -d \

   --name hermes \

   --restart unless-stopped \

   -v ~/.hermes:/opt/data \

   nousresearch/hermes-agent gateway run

Todos os dados ficam no volume montado ~/.hermes, então nada se perde durante as atualizações.

Para usuários de VPS Hostinger, você pode atualizar o container diretamente pelo hPanel. No Docker Manager, encontre seu projeto Hermes Agent, clique no menu de três pontos e selecione Atualizar.

Além disso, proteja seu VPS desativando o login raiz do SSH, configurando o fail2ban para bloquear tentativas repetidas de login e instalando um scanner de malware para detectar ameaças.

Erros comuns ao configurar o Hermes Agent

A maioria dos problemas comuns de configuração do Hermes Agent inclui adicionar recursos antes de verificar o chat CLI, não montar o volume de dados, usar credenciais de API incorretas, pular a lista de permissos do gateway e executar comandos diretamente no host.

• Adicionando recursos antes de verificar o chat da CLI. Conectar o Telegram, habilitar cron jobs ou integrar serviços de terceiros antes de confirmar que o chat CLI funciona torna a solução de problemas mais difícil. Se algo quebrar, você não vai saber onde está o problema. Teste o agente na CLI primeiro, confirme se ele responde e pode usar ferramentas, depois adicione outros recursos.
• Não montando o volume de dados. Se você rodar o container sem -v ~/.hermes:/opt/data, todos os dados (memória, habilidades e configuração) permanecem dentro do container. Quando o contêiner reinicia, tudo está perdido. Sempre inclua a flag de volume ao rodar o container manualmente.
• Usando credenciais de API incorretas ou expiradas. Se a chave API estiver errada ou expirada, o agente não pode se comunicar com o modelo. Confira a chave no painel do seu provedor ou gere uma nova. Depois, rode a configuração do Hermes novamente para atualizar.
• Pulando a lista de permissões do gateway. Se você configurar um bot de mensagens sem adicionar allowed_user_ids no config.yaml, qualquer pessoa que encontrar o nome de usuário do seu bot pode interagir com ele. Adicione seu ID de usuário à lista de permissões para que só você possa acessá-lo.
• Deixando o backend padrão do terminal em um VPS. Por padrão, o agente executa comandos de terminal diretamente no seu servidor. Em um VPS, isso pode afetar todo o seu sistema. Mude para um contêiner sandbox com o Hermes config Terminal.backend docker para que os comandos rodem em um ambiente isolado.

Como gerenciar o Agente Hermes após a configuração

Gerenciar o Hermes Agent após a configuração envolve manter o container e o gateway saudáveis, agendar tarefas recorrentes com o cron e usar o painel web para gerenciar sua instalação.

• Monitorando logs e saúde do gateway. Os registros de contêineres são o primeiro lugar para verificar quando algo parece errado. Execute logs docker hermes para revisar resultados recentes, ou logs docker -f hermes para acompanhar logs em tempo real. Para o gateway, use o status do gateway Hermes para ver quais plataformas estão conectadas, e o gateway Hermes reinicie para reconectar as que caíram.
• Agendar tarefas recorrentes. O cron planner embutido executa tarefas como resumos diários, backups noturnos e relatórios semanais. Ele envia resultados para suas plataformas de mensagens conectadas. Defina os cronogramas com o hermes cron, e o agente cuida da execução automaticamente.
• Acessando o painel web. O painel web é uma interface baseada em navegador para gerenciar a instalação do seu Hermes Agent. Em vez de editar arquivos YAML ou executar comandos via CLI, você pode configurar configurações, gerenciar chaves de API, monitorar sessões e agendar trabalhos cron a partir de uma interface visual. Comece com o comando abaixo e depois abra http://your-server-ip:9119 no seu navegador:

docker run -d \

   --name hermes-dashboard \

   --restart unless-stopped \

   -v ~/.hermes:/opt/data \

   -p 9119:9119 \

   nousresearch/hermes-agent dashboard

O que você pode fazer com o Hermes Agent?

Com o Hermes Agent rodando no seu VPS, você ganha um assistente de IA sempre ligado que pode acessar pelos seus canais de comunicação preferidos a qualquer momento.

O que você faz com ele depende das suas necessidades – seja você um desenvolvedor, um sysadmin ou alguém que quer um assistente pessoal rodando no seu próprio servidor.

Para tarefas de desenvolvimento, você pode pedir ao agente para clonar um repositório, criar um ambiente de staging e rodar testes, tudo a partir de uma mensagem do Telegram enquanto você estiver longe da sua mesa.

Administradores de sistemas podem configurar trabalhos cron usando linguagem natural. Por exemplo, você pode agendar um relatório semanal de uso de disco para ser entregue ao Slack toda segunda-feira de manhã, ou fazer com que o agente monitore um serviço e envie um alerta quando ele cair.

Para uso pessoal, você pode pedir ao agente para enviar um briefing matinal com seu calendário, notícias principais e notificações no GitHub antes do início do seu dia.

Se você quiser exemplos mais avançados, incluindo pipelines de produção de conteúdo, automação de implantação e fluxos de trabalho de pesquisa ou processamento de dados, confira os casos de uso mais populares do Hermes Agent.

Semua konten tutorial di website ini telah melalui peninjauan menyeluruh sesuai padrões editoriais e valores da Hostinger.

O autor

Katerina Bosinaki

Katerina é Gerente de Projetos de Localização na Hostinger, com mais de 5 anos de experiência em gestão de projetos e uma formação de 6 anos como linguista. Ela se dedica a tornar a tecnologia mais acessível, transformando guias complexos em tutoriais claros e fáceis de seguir. No seu tempo livre, quando não está acompanhando as últimas novidades em localização, gosta de assistir a filmes e ler livros.

Mais de Katerina Bosinaki