O que é o Hermes Agent

O Hermes Agent é um agente de IA de código aberto da Nous Research, distribuído sob licença MIT. Ele roda como um processo no seu servidor e usa um modelo de linguagem para decidir qual ferramenta chamar em cada etapa de uma tarefa: ler e alterar arquivos, executar comandos no terminal, pesquisar na web ou passar parte do trabalho para um subagente.

As ferramentas são ligadas e desligadas pelo comando hermes tools. O modelo só chama as que você habilitou, então o mesmo agente executa comandos numa instalação com o terminal liberado e apenas conversa numa instalação com essa ferramenta desligada.

Quatro entradas para o mesmo agente

Conectado ao servidor por SSH, você abre a conversa com o comando hermes, direto no terminal. Longe do servidor, o app Hermes Desktop acessa o Hermes da VPS pela opção Remote gateway, que fica nas configurações. Para acompanhar pelo navegador, o comando hermes dashboard abre um painel com as sessões, as skills e os canais configurados. O gateway de mensagens completa o conjunto e leva o agente para o Telegram e o Discord.

Uma conversa começada no Telegram aparece depois na lista de sessões do dashboard. Uma skill instalada pelo terminal também fica disponível no bot, porque as quatro entradas leem a mesma configuração do servidor.

Vi isso na prática em julho, quando mandei pelo Telegram uma instrução para o Hermes montar uma base editorial sobre ele mesmo. O celular só levou a mensagem até o agente, que abriu o repositório no meu computador, leu as instruções do projeto e deixou os arquivos lá para eu conferir. Por isso recomendo começar a trilha pela VPS: o agente precisa de uma máquina que continue ligada enquanto você está longe dela.

Memória, skills e sessões anteriores

O Hermes guarda no servidor dois tipos de aprendizado: a memória e as skills. A memória persistente registra as preferências e os fatos que continuam úteis por muito tempo e entra nas conversas seguintes sem que você precise repetir nada. Os detalhes de uma tarefa específica ficam na sessão dela. A busca de sessões anteriores encontra esses detalhes quando você volta ao assunto, mas eles não entram na memória que vale para todas as conversas.

As skills são procedimentos escritos em arquivo e guardados em ~/.hermes/skills/. Depois de uma tarefa trabalhosa, o próprio agente pode criar uma skill com as etapas que funcionaram e corrigir essa skill quando uma execução revela uma falha. Você também instala skills prontas com o comando hermes skills install e chama qualquer uma delas na TUI ou na conversa com o bot, digitando / seguido do nome.

Como o agente escreve nas próprias skills, o Hermes permite revisar essas alterações. Com a opção skills.write_approval ativa no config.yaml, cada alteração fica pendente até você revisar o conteúdo e aprovar com o comando /skills approve.

Um profile para cada agente

Um profile é uma pasta própria do Hermes dentro do mesmo servidor, com configuração, chaves de API e memória que não se misturam com as dos outros profiles. O comando hermes profile create coder cria um profile novo. Depois disso, coder chat abre a conversa só com ele, porque cada profile ganha um atalho próprio no terminal e pode ter o próprio bot no Telegram.

A separação vale para a configuração do agente, não para os arquivos do servidor. Um profile não é uma sandbox: os comandos que ele executa têm as permissões do usuário que instalou o Hermes. Por isso o guia de instalação cria um usuário de serviço próprio para o agente.

O que o Telegram faz e o que fica no servidor

O gateway é um processo do Hermes que fica conectado ao Telegram, ao Discord e a outras plataformas e repassa cada mensagem para o agente no servidor. Instalado como serviço do systemd, com o linger ativo, ele continua recebendo mensagens depois que você fecha a sessão SSH. No celular, basta o aplicativo do Telegram ou do Discord aberto na conversa com o bot.

Por padrão, o gateway recusa mensagens de usuários desconhecidos, porque o bot pode ter acesso ao terminal do servidor. Você libera o acesso de duas formas: listando os IDs permitidos na variável TELEGRAM_ALLOWED_USERS ou aprovando, com o comando hermes pairing approve, o código de pareamento que o bot manda para um contato novo.

A ordem da trilha

A trilha Comece aqui segue a ordem das dependências. A VPS vem primeiro porque tudo roda nela. Em seguida vem o terminal, a forma mais direta de conferir cada passo. O modelo entra logo depois, porque sem ele o agente não tem como responder. O profile vem antes do canal porque cada bot do Telegram fica ligado a um profile, com o token gravado no .env dele. Por fim, a trilha deixa o gateway rodando como serviço e só depois cria o bot do Telegram ou do Discord.

Cada etapa termina com uma conferência no próprio servidor. Recomendo não pular nenhuma, porque um erro de permissão deixado na instalação só volta a aparecer mais tarde, quando o bot não responde no Telegram e a causa fica bem mais difícil de encontrar.