Trilha de Aprendizado

O Hermes Agent faz muita coisa — assistente na linha de comando, bot de Telegram e Discord, automação de tarefas, treino por reforço e mais. Esta página ajuda a decidir por onde começar e o que ler, conforme sua experiência e seu objetivo.

Comece por aqui

Se você ainda não instalou, comece pelo guia de Instalação e depois pelo Início Rápido. Tudo abaixo assume uma instalação funcionando.

Primeira configuração de provedor

Quem está começando quase sempre quer hermes setup --portal — um login OAuth cobre um modelo mais as quatro ferramentas do Tool Gateway (busca, imagem, voz e navegador). Veja Nous Portal.

Sobre os links

Os links levam às páginas deste site quando elas já existem. Os demais apontam para a documentação oficial.

Como usar esta página

• Sabe o seu nível? Vá direto para a tabela por nível e siga a ordem de leitura da sua faixa.
• Tem um objetivo específico? Pule para por objetivo e ache o cenário que combina.
• Só passeando? Veja a tabela de recursos, num relance, com tudo que o Hermes Agent sabe fazer.

Por nível de experiência

Nível	Objetivo	Leitura recomendada	Tempo estimado
Iniciante	Colocar para rodar, conversar e usar as ferramentas embutidas	Instalação → Início Rápido → CLI → Configuração	~1 hora
Intermediário	Montar bots de mensagem e usar memória, cron e skills	Sessões → Mensagens → Ferramentas → Skills → Memória → Cron	~2–3 horas
Avançado	Criar ferramentas e skills próprias, treinar modelos, contribuir	Arquitetura → Adicionar ferramentas → Criar skills → Contribuir	~4–6 horas

Por objetivo

Escolha o cenário que combina com o que você quer. Cada um lista a documentação na ordem em que convém ler.

"Quero um assistente de código no terminal"

Usar o Hermes como assistente interativo para escrever, revisar e rodar código.

1. Instalação
2. Início Rápido
3. CLI
4. Execução de código
5. Arquivos de contexto
6. Dicas e boas práticas

dica

Passe arquivos direto para a conversa com os arquivos de contexto. O Hermes lê, edita e roda código nos seus projetos.

"Quero um bot de Telegram ou Discord"

Publicar o Hermes como bot na plataforma de mensagem que você usa.

1. Instalação
2. Configuração
3. Visão geral de mensagens
4. Configurar o Telegram
5. Configurar o Discord
6. Modo de voz
7. Usar o modo de voz
8. Segurança

Projetos completos de exemplo:

• Bot de briefing diário
• Assistente de time no Telegram

"Quero automatizar tarefas"

Agendar tarefas recorrentes, rodar lotes ou encadear ações do agente.

1. Início Rápido
2. Agendamento com cron
3. Processamento em lote
4. Delegação
5. Hooks

dica

Com cron, o Hermes roda tarefas na hora marcada — resumos diários, verificações periódicas, relatórios automáticos — sem você estar presente.

"Quero um time de bots especialistas"

Criar bots com nome, modelo, memória, skills, rotinas e conversas próprias, e depois juntá-los em grupos ou chamá-los por @menção.

1. Desktop
2. Perfis
3. Bot Mode
4. Agendamento com cron
5. Desktop com várias conexões

"Quero criar ferramentas ou skills próprias"

Estender o Hermes com suas ferramentas e pacotes de skills reaproveitáveis.

1. Plugins
2. Construir um plugin
3. Visão geral das ferramentas
4. Visão geral das skills
5. MCP (Model Context Protocol)
6. Arquitetura
7. Adicionar ferramentas
8. Criar skills

dica

Para a maior parte das ferramentas personalizadas, comece por plugins. A página Adicionar ferramentas é sobre desenvolver o núcleo do Hermes, não o caminho comum de quem quer uma ferramenta própria.

"Quero treinar modelos"

Usar aprendizado por reforço para ajustar o comportamento do modelo com o pipeline de treino do Hermes, movido pelo Atropos.

1. Início Rápido
2. Configuração
3. Ambientes de RL do Atropos (externo)
4. Roteamento de provedores
5. Arquitetura

dica

Treino por reforço rende mais quando você já entende como o Hermes lida com conversas e chamadas de ferramenta. Se está começando, passe antes pela trilha de iniciante.

"Quero usar como biblioteca Python"

Integrar o Hermes nas suas próprias aplicações Python.

1. Instalação
2. Início Rápido
3. Guia da biblioteca Python
4. Arquitetura
5. Ferramentas
6. Sessões

Recursos, num relance

Não sabe o que existe? Um diretório rápido:

Recurso	O que faz	Link
Ferramentas	Ferramentas que o agente pode chamar (arquivos, busca, shell etc.)	Ferramentas
Skills	Pacotes instaláveis que acrescentam capacidades	Skills
Memória	Memória persistente entre sessões	Memória
Bot Mode	Bots especialistas com conversas, rotinas, grupos e @menções	Bot Mode
Arquivos de contexto	Levar arquivos e diretórios para dentro da conversa	Arquivos de contexto
MCP	Conectar a servidores de ferramentas externos	MCP
Cron	Agendar tarefas recorrentes	Cron
Delegação	Criar subagentes para trabalho em paralelo	Delegação
Execução de código	Rodar scripts Python que chamam as ferramentas do Hermes	Execução de código
Navegador	Navegar e extrair dados da web	Navegador
Hooks	Retornos de chamada e middleware por evento	Hooks
Processamento em lote	Processar muitas entradas de uma vez	Lote
Roteamento de provedores	Distribuir requisições entre provedores de LLM	Roteamento

O que ler agora

Conforme onde você está:

• Acabou de instalar? → Vá para o Início Rápido e tenha a primeira conversa.
• Terminou o Início Rápido? → Leia CLI e Configuração.
• Já domina o básico? → Explore Ferramentas, Skills e Memória.
• Montando para uma equipe? → Leia Segurança e Sessões.
• Pronto para construir? → Vá para o Guia do Desenvolvedor.
• Quer exemplos práticos? → Veja os Guias.

dica

Você não precisa ler tudo. Escolha a trilha que combina com seu objetivo, siga os links na ordem e o resultado aparece rápido. Esta página continua aqui quando você quiser o próximo passo.