Guia básico do Hermes Agent

Leitura de 8 min

Esta nota integra a trilha IA em Tools. Para skills em profundidade, continue em Guia de Skills do Hermes Agent. Para descobrir outras ferramentas de IA, veja Altern.AI.

Versão prática para começar a usar o Hermes no Ubuntu/Linux, entender onde ele é forte e evitar expectativas erradas.

1. O que é o Hermes?

O Hermes Agent é um agente de IA open-source da Nous Research. Ele não é apenas um chatbot de terminal: a ideia central é ser um agente que aprende com o uso, cria/reaproveita skills, guarda memória entre sessões e pode trabalhar em terminal, servidores e plataformas de mensagem.

Em linguagem simples: o Hermes é melhor quando você quer um assistente que trabalha com você ao longo do tempo, e não apenas uma IA que responde uma pergunta isolada.

Fontes oficiais:

2. Onde o Hermes é melhor?

2.1. Aprender com repetição

O grande diferencial do Hermes é o loop de aprendizado. Ele pode usar memória, histórico e skills para ficar mais útil conforme você repete tarefas.

Exemplo prático:

  • Você pede várias vezes para ele revisar scripts Python.
  • Ele percebe seu padrão de projeto.
  • Ele pode criar ou melhorar uma skill para esse tipo de revisão.
  • Nas próximas vezes, ele tende a executar o fluxo com menos explicação e mais precisão.

Resumo direto: se a tarefa se repete, Hermes tende a ficar mais valioso.

2.2. Trabalhar no terminal

Hermes é forte para quem vive no Linux, servidor, Git, scripts e automações. Ele pode operar dentro de uma sessão de terminal, executar comandos, ler arquivos, ajudar com código e manter contexto do que está acontecendo.

Ele é especialmente útil para:

  • desenvolvimento;
  • automação de tarefas;
  • manutenção de servidor;
  • análise de arquivos;
  • pesquisa técnica;
  • criação de rotinas repetíveis;
  • criação e uso de skills.

2.3. Rodar em vários ambientes

O Hermes pode rodar localmente, em Docker, SSH, servidores e outros backends. Isso é importante porque um agente útil não precisa ficar preso ao seu notebook.

Exemplo:

  • Hermes local no Ubuntu para tarefas simples;
  • Hermes em VPS para ficar sempre disponível;
  • Hermes via Telegram/Discord/Slack para conversar com o agente sem abrir o terminal.

2.4. Usar diferentes modelos

Você pode trocar o modelo sem reescrever código. O comando principal para isso é:

hermes model

Isso permite alternar entre provedores/modelos como Nous, OpenRouter, MiniMax, OpenAI, Hugging Face e outros, dependendo da sua configuração.

2.5. Criar skills

Skills são procedimentos reutilizáveis. Pense nelas como “modos de trabalho” ou “receitas” que o Hermes pode carregar para tarefas específicas.

Exemplos de skills úteis:

  • revisar código antes de commit;
  • gerar relatório semanal;
  • resumir artigos;
  • padronizar documentos;
  • abrir PRs;
  • fazer auditoria de logs;
  • organizar notas de pesquisa.

A diferença real: sem skill, você explica tudo de novo. Com skill, você transforma um fluxo em processo.

3. Onde o Hermes NÃO é magicamente melhor

Aqui vai a parte sem romantizar:

  • Hermes não substitui sua supervisão.
  • Hermes pode executar comandos errados se você pedir mal ou liberar permissões demais.
  • Hermes não torna modelo fraco em modelo forte.
  • Hermes não entende perfeitamente seu projeto só porque está instalado.
  • Memória ruim vira bagunça se você não corrigir o agente.
  • Rodar agente com acesso amplo ao sistema sem sandbox é pedir problema.

Use Hermes como operador assistido, não como “funcionário autônomo cego”.

4. Instalação básica no Ubuntu/Linux

A instalação oficial para Linux/macOS/WSL2 usa:

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

Depois, abra uma nova sessão de terminal ou recarregue o shell:

source ~/.bashrc

ou, se usar Zsh:

source ~/.zshrc

Teste:

hermes

5. Configuração inicial

Rode o assistente de configuração:

hermes setup

Para trocar ou configurar modelo:

hermes model

Para verificar a instalação/configuração:

hermes doctor

Para atualizar:

hermes update

6. Uso básico no dia a dia

6.1. Abrir sessão interativa

hermes

Use isso quando quiser conversar com o agente em modo contínuo.

6.2. Fazer uma pergunta única

hermes chat -q "Explique este erro do Python em português simples"

6.3. Usar um modelo específico

hermes chat --model "nome-do-modelo" -q "Faça um resumo deste projeto"

6.4. Forçar um provider específico

Exemplos:

hermes chat --provider nous -q "Teste rápido"
hermes chat --provider openrouter -q "Teste rápido"

6.5. Continuar a última sessão

hermes --continue

ou:

hermes -c

6.6. Retomar uma sessão específica

hermes --resume <session_id>

7. Comandos úteis dentro do Hermes

Dentro de uma sessão interativa, use / para ver comandos disponíveis.

Comandos comuns:

ComandoPara que serve
/helpMostra ajuda
/modelMostra ou altera o modelo atual
/toolsLista ferramentas disponíveis
/skills browseProcura skills disponíveis
/background <prompt>Roda uma tarefa em sessão separada
/reasoning highAumenta o esforço de raciocínio
/title Nome da sessãoDá nome à sessão atual
/usageMostra uso/custos/tokens, quando disponível
/compressReduz contexto quando a conversa fica grande

8. Atalhos úteis no terminal

AtalhoAção
EnterEnviar mensagem
Ctrl+JNova linha/mensagem multilinha
Alt+EnterNova linha, dependendo do terminal
Ctrl+CInterromper o agente
Ctrl+DSair
TabAutocompletar comandos
Ctrl+GAbrir editor externo para escrever prompt longo

Dica prática: para prompts longos, use Ctrl+G. Escrever prompt grande direto no terminal é pedir confusão.

9. Como pedir coisas bem ao Hermes

Ruim

Arruma meu projeto.

Melhor

Analise este projeto Python. Primeiro rode os testes, depois identifique erros de dependência, depois proponha correções. Não altere arquivos sem me mostrar o plano.

Muito melhor

Você está no diretório de um projeto Python. Objetivo: fazer os testes passarem.
 
Regras:
1. Primeiro rode comandos apenas de inspeção.
2. Liste os erros encontrados.
3. Proponha um plano curto.
4. Só edite arquivos depois da minha aprovação.
5. Ao final, rode os testes de novo.

Hermes fica muito melhor quando você dá:

  • objetivo claro;
  • restrições;
  • ordem de execução;
  • critérios de sucesso;
  • limite de permissões.

10. Exemplos práticos

10.1. Revisar um script

hermes "Revise o script backup.py. Procure bugs, riscos de segurança e casos extremos. Não altere nada ainda."

10.2. Criar um script

hermes "Crie um script Bash para fazer backup de /var/www para ~/backups, com data no nome e log de execução. Explique antes de salvar."

10.3. Entender um erro

hermes "Explique este erro e me diga o próximo comando seguro para investigar: <cole o erro aqui>"

10.4. Trabalhar com Git

hermes "Analise as mudanças do git diff, diga o risco de cada alteração e sugira uma mensagem de commit. Não faça commit."

10.5. Planejar uma automação

hermes "Quero automatizar uma rotina diária de verificação de logs. Faça perguntas mínimas, proponha arquitetura simples e depois gere o script."

11. Segurança básica

Não rode Hermes com acesso total sem pensar. Agente de IA com terminal é ferramenta poderosa; ferramenta poderosa também quebra coisas rápido.

Boas práticas:

  1. Comece em diretórios de teste.
  2. Use Git antes de deixar editar arquivos.
  3. Peça plano antes de execução.
  4. Não exponha chaves/API keys em prompts desnecessariamente.
  5. Use Docker/sandbox quando for testar comandos perigosos.
  6. Não deixe o agente rodar rm, chmod, chown, migrações ou deploys sem revisão.
  7. Prefira comandos de inspeção antes de comandos de alteração.

Prompt seguro para usar bastante:

Antes de executar qualquer comando que altere arquivos, banco de dados, permissões ou sistema, pare e peça confirmação. Pode executar apenas comandos de leitura/inspeção sem confirmar.

12. Modelo recomendado de uso

Para tarefas simples

Use uma pergunta direta:

hermes chat -q "Explique este comando: rsync -avz"

Para tarefas médias

Use sessão interativa:

hermes

E vá guiando passo a passo.

Para tarefas repetidas

Transforme em skill.

Exemplo:

Quero transformar este fluxo em uma skill: revisar scripts Python, rodar testes, apontar riscos e sugerir correções sem editar arquivos automaticamente.

Para automações sensíveis

Use sandbox, Git e confirmação manual.

13. Quando usar Hermes em vez de ChatGPT comum?

Use Hermes quando você precisa de:

  • terminal;
  • arquivos locais;
  • histórico persistente;
  • skills;
  • automação recorrente;
  • execução em servidor;
  • integração com apps de mensagem;
  • tarefas técnicas com várias etapas.

Use ChatGPT comum quando você precisa só de:

  • explicação;
  • brainstorming;
  • revisão de texto;
  • pergunta rápida;
  • raciocínio sem mexer no seu ambiente.

Regra simples: se precisa agir no seu sistema, Hermes. Se precisa apenas pensar/conversar, ChatGPT normal já resolve.

14. Fluxo ideal para começar

  1. Instale.
  2. Configure modelo com hermes model.
  3. Rode hermes doctor.
  4. Abra hermes.
  5. Teste com tarefas pequenas.
  6. Use Git antes de deixar editar arquivos.
  7. Crie uma ou duas skills para tarefas repetidas.
  8. Só depois pense em gateway/Telegram/servidor sempre ligado.

Não pule direto para automação total. Isso é o tipo de pressa que transforma assistente em gerador de incêndio.

15. Comandos rápidos de referência

# Instalar
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
 
# Configurar
hermes setup
 
# Trocar modelo
hermes model
 
# Diagnóstico
hermes doctor
 
# Atualizar
hermes update
 
# Abrir sessão interativa
hermes
 
# Pergunta única
hermes chat -q "Sua pergunta aqui"
 
# Continuar sessão anterior
hermes --continue
 
# Rodar com provider específico
hermes chat --provider nous -q "Teste"
 
# Rodar com toolsets específicos
hermes chat --toolsets "web,terminal,skills" -q "Faça uma pesquisa técnica"
 
# Pré-carregar skill
hermes -s nome-da-skill

16. Resumo final

Hermes é melhor em tarefas técnicas recorrentes, trabalho com terminal, uso de memória, skills reutilizáveis e execução em ambientes reais.

Ele não é melhor porque “responde mais bonito”. Ele é melhor porque pode agir, lembrar, aprender processos e repetir fluxos com menos atrito.

A forma inteligente de usar é: comece pequeno, imponha limites, revise comandos e transforme o que se repete em skill.

Fontes consultadas