Hermes Agent V2: guia completo do agente open source da Nous Research

Em fevereiro de 2026, a Nous Research lançou o Hermes Agent V2 e rapidamente transformou o mercado de agentes de inteligência artificial de código aberto. Com aproximadamente 169 mil estrelas no GitHub, ele se tornou o agente open source mais popular do momento, superando projetos estabelecidos como o OpenClaw, do qual é o sucessor oficial. O motivo é simples: enquanto a maioria das ferramentas similares funciona apenas como um chat avançado, o Hermes Agent opera como um runtime completo de agente autônomo, capaz de ler seu sistema de arquivos, executar comandos no terminal, acessar a web, criar subagentes e até melhorar o próprio comportamento ao longo do tempo.

O que torna esse lançamento relevante agora é a combinação de acessibilidade e poder real. Qualquer pessoa com um VPS (Virtual Private Server, ou seja, um servidor virtual privado na nuvem) de entrada consegue instalar o Hermes em minutos, conectar sua chave de API de qualquer provedor e ter um assistente pessoal rodando 24 horas por dia, respondendo pelo Telegram, Discord ou WhatsApp. Este guia reúne tudo que você precisa saber para sair do zero ao agente em produção, com base nas fontes oficiais.

O que é e como funciona

O Hermes Agent é um framework de agente de IA de código aberto desenvolvido pela Nous Research que roda no seu terminal, em plataformas de mensageria e em IDEs (ambientes de desenvolvimento integrado). Ele pertence à mesma categoria que o Claude Code da Anthropic e o Codex da OpenAI, mas com um foco diferente: enquanto esses são voltados principalmente para escrita de código, o Hermes foi projetado como um assistente pessoal completo, capaz de executar pesquisas longas, responder e-mails, analisar dados e avisar você pelos seus apps de mensagem favoritos.

O funcionamento interno gira em torno de um único loop de conversa que qualquer ponto de entrada pode invocar. Esse loop, implementado no arquivo run_agent.py, executa cinco etapas a cada turno:

• Constrói o prompt do sistema a partir dos arquivos SOUL.md, MEMORY.md, USER.md, skills (habilidades aprendidas) e guias de ferramentas.
• Resolve qual provedor de IA usar, verificando sua autenticação e URL base.
• Chama o provedor em um de três modos de API: chat_completions, codex_responses ou anthropic_messages.
• Despacha as chamadas de ferramentas retornadas pelo modelo por meio do registro central de ferramentas em tools/registry.py.
• Repete o ciclo até o modelo produzir uma resposta final e então persiste a sessão em SQLite com busca de texto completo (FTS5).

Esse loop serve tanto para a interface de linha de comando (CLI) quanto para o gateway de mensageria, o que explica por que os mesmos comandos com barra funcionam no terminal e no Telegram: eles vêm de um registro compartilhado chamado COMMAND_REGISTRY.

Três características distinguem o Hermes de simples chatbots. A primeira é a memória persistente entre sessões: o agente lembra quem você é, suas preferências e lições aprendidas. A segunda é o sistema de skills (habilidades), que são procedimentos reutilizáveis que o próprio agente cria e evolui com base na experiência: quando ele resolve um problema complexo, persiste esse conhecimento para sessões futuras. A terceira é a independência de provedor: você troca de modelo com um único comando sem perder histórico ou configurações.

Toda a configuração fica armazenada em ~/.hermes/, com uma estrutura clara onde cada arquivo tem um papel específico:

~/.hermes/
├── config.yaml        # Configurações gerais (modelo, terminal, compressão etc.)
├── .env               # Chaves de API e segredos
├── auth.json          # Credenciais OAuth (Nous Portal, Codex, Anthropic)
├── SOUL.md            # Identidade primária do agente
├── memories/          # Memória persistente (MEMORY.md, USER.md)
├── skills/            # Skills instalados e criados pelo agente
├── cron/              # Tarefas agendadas
├── sessions/          # Estado das sessões do gateway
└── logs/              # Logs do agente e do gateway (segredos são ocultados)

O que você precisa antes de começar

Antes de instalar, verifique se o seu ambiente atende aos seguintes requisitos, conforme as fontes oficiais:

• Um VPS com Ubuntu 22.04 LTS ou superior (também compatível com Debian 12, macOS e Windows WSL).
• Mínimo de 2 GB de RAM, sendo 4 GB recomendados para sessões longas.
• Python 3.10 ou superior e pip instalados.
• Git instalado.
• Uma chave de API de pelo menos um provedor compatível: OpenRouter, Anthropic, DeepSeek, OpenAI, Google AI, xAI/SuperGrok, Nous Portal, entre outros.
• Opcional: um token de bot do Telegram criado via @BotFather para integrar com o gateway de mensageria.

Sobre a escolha do hardware: o instalador oficial analisa o servidor e baixa automaticamente o que estiver faltando, incluindo uma versão específica de Python, Git, Node, ripgrep (ferramenta de busca rápida em arquivos) e ffmpeg (para mensagens de voz). Por isso, mesmo um VPS com configuração de entrada já é suficiente para começar. Sempre confira os requisitos atualizados na documentação oficial do Hermes Agent, pois o software evolui rapidamente.

Instalação passo a passo

Passo 1: Conecte-se ao VPS e prepare o sistema. Acesse seu servidor por SSH e atualize os pacotes:

ssh usuario@tu-vps-ip
sudo apt update && sudo apt upgrade -y

Instale as dependências necessárias:

sudo apt install -y python3 python3-pip python3-venv git curl wget build-essential ffmpeg

Passo 2: Crie um usuário sem privilégios root. Agentes de IA não funcionam bem rodando como root. Crie um usuário dedicado:

adduser fazt
usermod -aG sudo fazt
groups fazt

Saia da sessão com Ctrl + D e reconecte com o novo usuário:

ssh fazt@TU_IP_DEL_SERVIDOR

Passo 3: Instale o Hermes Agent. A forma recomendada e suportada é o instalador oficial via script. Desde a versão 0.19.0, a instalação via pip install hermes-agent foi descontinuada; o caminho correto é:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Esse script clona o repositório em ~/.hermes/hermes-agent/, cria um ambiente virtual Python com todas as dependências, instala o comando hermes no PATH do sistema e cria a estrutura de diretórios inicial em ~/.hermes/. Durante a instalação, responda y para confirmar as instalações solicitadas.

Passo 4: Recarregue o shell e verifique a instalação. Feche e reabra o terminal ou execute:

source ~/.bashrc

Em seguida, confirme que o Hermes foi instalado corretamente:

hermes --version
hermes doctor

O comando hermes doctor diagnostica sua configuração e aponta problemas de autenticação ou ferramentas faltando.

Passo 5: Configure o provedor de IA. Execute o assistente de configuração interativo:

hermes setup

Ou configure apenas o modelo diretamente:

hermes model

Suas chaves de API ficam salvas em ~/.hermes/.env. Você pode editá-las manualmente:

nano ~/.hermes/.env

Exemplo de arquivo .env:

OPENROUTER_API_KEY=sk-or-v1-tu-clave-aqui
# Ou para DeepSeek:
DEEPSEEK_API_KEY=sk-tu-clave-aqui
# Ou para Anthropic:
ANTHROPIC_API_KEY=sk-ant-tu-clave-aqui

Passo 6: Teste o Hermes no terminal. Antes de configurar o gateway, confirme que tudo funciona:

hermes chat -q "Olá, me dê um resumo do sistema em que estou rodando."

Para iniciar uma sessão interativa completa:

hermes

Dentro da sessão, digite /help para ver todos os comandos disponíveis.

Passo 7: Configure o gateway do Telegram. Crie um bot no Telegram acessando @BotFather, use o comando /newbot e copie o token gerado. Descubra seu ID de usuário acessando @userinfobot. Depois configure o gateway:

hermes gateway setup

Selecione Telegram, cole o token do bot e seu user ID. Teste localmente:

hermes gateway run

Passo 8: Configure como serviço systemd para rodar 24/7. Para produção, instale o Hermes como serviço do sistema operacional:

hermes gateway install

Após isso, controle o serviço com:

hermes gateway start
hermes gateway status
hermes gateway stop
hermes gateway restart

Para evitar que o gateway pare ao fechar a sessão SSH:

sudo loginctl enable-linger $USER

Para acompanhar os logs em tempo real:

journalctl -u hermes-gateway.service -f

Primeiros passos: colocando para trabalhar

Com o Hermes instalado e o gateway ativo, o próximo passo é explorar os comandos essenciais. No terminal, você tem acesso a um conjunto de comandos que controlam toda a operação do agente:

hermes                 # Abre o chat na interface de console
hermes dashboard       # Abre a interface web
hermes setup           # Reconfigura o agente
hermes setup gateway   # Reconfigura o gateway
hermes doctor          # Diagnostica configuração e ferramentas
hermes auth            # Gerencia credenciais

Dentro do chat, os comandos são prefixados com barra:

/new        # Nova sessão
/reset      # Reinicia a sessão atual
/clear      # Limpa a tela
/skills     # Exibe skills disponíveis
/resume     # Retoma uma sessão anterior pelo ID
/model      # Troca de modelo de forma interativa
/compress   # Comprime o contexto manualmente

Para trocar de modelo ou provedor sem perder o histórico da conversa, use /model provider:modelo diretamente no chat. O Hermes suporta cerca de 20 provedores de primeira linha, incluindo Nous Portal, OpenRouter, Anthropic, GitHub Copilot, DeepSeek, Qwen Cloud, Hugging Face, Google, xAI/SuperGrok e endpoints próprios.

Para gerenciar ferramentas (toolsets), use:

hermes tools

Isso abre uma interface interativa para ativar ou desativar conjuntos de ferramentas. Os mais importantes são: terminal (executa comandos no servidor, ativo por padrão), web (busca e extração de conteúdo), file (leitura e escrita de arquivos), vision (análise de imagens), delegation (delega tarefas a subagentes) e cronjob (agenda tarefas periódicas).

5 usos específicos que valem o esforço

1. Monitor de servidor com relatório diário no Telegram. Cenário: você tem um VPS rodando aplicações e quer saber o estado dos serviços todo dia de manhã sem precisar fazer login manualmente. Configure um job agendado com o cron integrado:

hermes cron create "every day at 9am" \
  --prompt "Revise os logs do servidor, uso de CPU e memória e me envie um resumo" \
  --deliver telegram

O Hermes acessa o terminal, executa os comandos de diagnóstico e entrega o relatório formatado no seu bot do Telegram, tudo de forma autônoma.

2. Pesquisa profunda com síntese de fontes múltiplas. Cenário: você precisa de um briefing completo sobre um tema antes de uma reunião, reunindo informações de várias fontes da web. Dentro do chat, ative a ferramenta web e peça:

hermes chat -q "Pesquise as principais notícias sobre regulamentação de IA no Brasil nos últimos 30 dias e me entregue um resumo com as fontes."

O agente acessa a web, extrai conteúdo de múltiplas páginas, sintetiza e entrega com referências. Diferente de um chatbot comum, ele executa múltiplos passos de busca e refinamento antes de responder.

3. Automação de tarefas repetitivas de arquivos. Cenário: toda semana você recebe dezenas de relatórios em PDF numa pasta e precisa extrair informações específicas e consolidar em uma planilha. Com a ferramenta file ativa, instrua o agente:

hermes chat -q "Na pasta ~/relatorios, leia todos os arquivos PDF desta semana, extraia os valores de faturamento e consolide em um CSV chamado resumo_semanal.csv"

O Hermes usa as ferramentas de arquivo e terminal para executar o pipeline completo, inclusive instalando dependências Python necessárias se precisar.

4. Assistente de código com diagnóstico semântico. Cenário: você está depurando um projeto Python e quer um segundo par de olhos que entenda o contexto do repositório inteiro. A partir da versão 0.14.0, o Hermes adiciona diagnósticos semânticos de linguagem (LSP) após edições, verificando erros antes do próximo turno. Aponte o agente para o seu projeto:

hermes chat -q "Analise o repositório em ~/meu-projeto, identifique possíveis bugs no módulo de autenticação e sugira correções"

Ele lê os arquivos relevantes, entende o contexto e propõe mudanças com evidências do próprio código.

5. Gateway multi-plataforma como hub de produtividade pessoal. Cenário: você quer um único agente que responda no Telegram quando está no celular, no Discord quando está com a equipe e por e-mail quando é necessário. O gateway do Hermes suporta 22 plataformas simultaneamente, incluindo Telegram, Discord, Slack, WhatsApp, Signal, Google Chat, LINE e SimpleX Chat. Após configurar cada plataforma via hermes gateway setup, o mesmo agente com a mesma memória e os mesmos skills responde em todos os canais. Você pode criar perfis isolados para contextos diferentes:

hermes profile create trabalho --clone
hermes profile list
hermes profile use trabalho

Limitações, custos e segurança

A autonomia do Hermes é seu maior trunfo e seu maior risco ao mesmo tempo. Por padrão, o agente tem acesso ao terminal do servidor, pode instalar programas, modificar arquivos e executar scripts. Em produção, isso significa que uma instrução maliciosa ou um modelo com alucinação pode causar danos reais ao sistema. Por isso, nunca rode o Hermes como usuário root e limite as permissões do usuário dedicado ao mínimo necessário.

Em termos de custos, o Hermes em si é gratuito e open source, mas você paga pelo modelo de IA que conectar a ele. Os custos variam muito: o DeepSeek é apontado nas fontes como uma das opções mais econômicas com excelente desempenho, enquanto o Claude da Anthropic é indicado para tarefas complexas de codificação mas tende a ser mais caro. O OpenRouter agrega centenas de modelos em uma única chave de API, facilitando a comparação de custos. Para o VPS, o plano mínimo recomendado pelas fontes é de 2 GB de RAM, mas 4 GB são indicados para sessões longas. Avalie os custos do seu provedor de nuvem antes de deixar o agente rodando tarefas pesadas de forma contínua.

Outro ponto de atenção é o modelo auxiliar. O Hermes usa um segundo modelo de IA (chamado de auxiliary LLM) para tarefas de visão, resumo de páginas web, compressão de contexto e consolidação de memória. Por padrão, ele tenta usar o Gemini Flash via detecção automática (OpenRouter, depois Nous Portal, depois Codex). Se nenhum desses estiver configurado, essas funcionalidades degradam silenciosamente sem avisar. Configure explicitamente o modelo auxiliar no config.yaml para evitar surpresas.

Sobre privacidade: todos os logs são gravados em ~/.hermes/logs/ com segredos automaticamente ocultados, mas as conversas e memórias ficam em texto simples no disco. Em ambientes compartilhados, proteja o diretório ~/.hermes/ com permissões adequadas (chmod 700). Sempre confira a documentação oficial atualizada para orientações de segurança, pois o projeto evolui rapidamente.

Perguntas frequentes

O Hermes funciona com modelos locais sem pagar nada? Sim. O Hermes é compatível com qualquer endpoint OpenAI-compatible, incluindo Ollama, vLLM, SGLang, llama.cpp e LM Studio rodando na sua própria máquina. Configure o endpoint personalizado em config.yaml apontando para o endereço local do seu servidor de modelos. A qualidade das respostas vai depender do modelo escolhido, não do Hermes em si.

O que acontece se eu fechar o terminal enquanto o agente executa uma tarefa longa? Se o gateway estiver configurado como serviço systemd com o comando hermes gateway install, ele continua rodando em segundo plano independente da sua sessão SSH. Lembre-se também de executar sudo loginctl enable-linger $USER para evitar que o processo seja encerrado ao desconectar. Para tarefas iniciadas diretamente no terminal interativo, elas serão interrompidas ao fechar a sessão.

Posso usar o Hermes sem nenhuma habilidade técnica de programação? A instalação via script de uma linha é acessível para qualquer pessoa com experiência básica em terminal. O uso cotidiano via Telegram não exige nenhum conhecimento de código. Porém, configurações avançadas como servidores MCP (Model Context Protocol, um padrão para conectar modelos a ferramentas externas), skills personalizados e integrações com APIs de terceiros exigem alguma familiaridade com Python e linha de comando.

Como faço para migrar do OpenClaw para o Hermes? O Hermes é o sucessor oficial do OpenClaw e inclui um comando de migração automática que importa mais de 30 categorias de estado, incluindo conversas, configurações e memórias. Execute:

hermes claw migrate

O processo é automático e preserva seu histórico. Sempre faça um backup do diretório de configurações do OpenClaw antes de migrar, por precaução.

Para quem vale a pena hoje

O Hermes Agent faz sentido hoje para três perfis principais. Para profissionais de tecnologia que gerenciam servidores e infraestrutura, ele elimina trabalho repetitivo de monitoramento, documentação e automação de tarefas, com o diferencial de receber alertas e responder comandos direto pelo Telegram sem precisar abrir um terminal. Para pesquisadores e criadores de conteúdo que precisam sintetizar grandes volumes de informação, a combinação de acesso à web, memória persistente e execução autônoma de tarefas longas é difícil de encontrar em outras ferramentas gratuitas. Para desenvolvedores que querem experimentar o estado da arte em agentes open source, o Hermes é o projeto com maior comunidade ativa e evolução mais rápida do momento, com mais de 2.245 commits e 1.065 PRs fundidos somente entre as versões 0.18.0 e 0.19.0.

Quem deve esperar são equipes que precisam de garantias de privacidade corporativa sem uma análise cuidadosa da configuração, usuários que querem substituir completamente um editor de código profissional como o Cursor ou o Windsurf, e quem não tem familiaridade mínima com terminal para lidar com eventuais erros de configuração. O Hermes é poderoso, mas é uma ferramenta de poder real em um servidor real: o mesmo acesso que o torna útil o torna responsabilidade sua gerenciar com cuidado.