..

Guia básico de uso do Hermes Agent¶

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:
- Documentação: https://hermes-agent.nousresearch.com/docs/
- GitHub: https://github.com/NousResearch/hermes-agent

---

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:

Comando	Para que serve
/help	Mostra ajuda
/model	Mostra ou altera o modelo atual
/tools	Lista ferramentas disponíveis
/skills browse	Procura skills disponíveis
/background <prompt>	Roda uma tarefa em sessão separada
/reasoning high	Aumenta o esforço de raciocínio
/title Nome da sessão	Dá nome à sessão atual
/usage	Mostra uso/custos/tokens, quando disponível
/compress	Reduz contexto quando a conversa fica grande

---

8. Atalhos úteis no terminal¶

Atalho	Ação
Enter	Enviar mensagem
Ctrl+J	Nova linha/mensagem multilinha
Alt+Enter	Nova linha, dependendo do terminal
Ctrl+C	Interromper o agente
Ctrl+D	Sair
Tab	Autocompletar comandos
Ctrl+G	Abrir 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¶

• Hermes Agent Documentation: https://hermes-agent.nousresearch.com/docs/
• Hermes Agent GitHub/README: https://github.com/NousResearch/hermes-agent
• CLI Interface documentation: https://github.com/NousResearch/hermes-agent/blob/main/website/docs/user-guide/cli.md