Tutorial 3: Caminho de Aprendizado — Seu Roteiro para a Maestria

Pense no Hermes Agent como um canivete suíço — ele pode fazer cem coisas diferentes, mas você não precisa aprender todas de uma vez. Este caminho de aprendizado é como um mapa que mostra a rota mais curta entre “acabei de instalar” e “estou criando minhas próprias ferramentas personalizadas”.

Passo 1: Comece Aqui (Iniciante — ~1 hora)

Se você ainda não instalou o Hermes Agent, pare de ler e faça isso primeiro. Execute estes dois comandos no seu terminal:

# Instala o Hermes Agent
pip install hermes-agent

# Configura seu primeiro provedor (um comando resolve tudo!)
hermes setup --portal

A flag --portal é um atalho mágico. Ela te dá um único login que desbloqueia o modelo de IA e quatro ferramentas integradas: busca na web, geração de imagens, texto-para-fala e um navegador. Você não precisa configurar cinco contas diferentes — só uma.

Depois disso, siga esta ordem de leitura:

1. Início Rápido — faça sua primeira conversa acontecer
2. Uso da CLI — aprenda a conversar com o Hermes no seu terminal
3. Configuração — ajuste as configurações de acordo com suas preferências

Ao final deste passo, você terá um assistente de IA funcional que pode responder perguntas e executar comandos simples.

Passo 2: Suba de Nível (Intermediário — ~2–3 horas)

Agora que você está confortável com o básico, é hora de fazer o Hermes trabalhar para você. É aqui que as coisas ficam divertidas.

1. Sessões — aprenda como o Hermes lembra do contexto entre conversas
2. Mensagens — conecte o Hermes ao Telegram ou Discord para conversar pelo celular
3. Ferramentas — descubra todos os recursos integrados (busca, imagem, navegador e mais)
4. Habilidades — ensine novos truques ao Hermes criando pacotes de habilidades reutilizáveis
5. Memória — deixe o Hermes lembrar fatos sobre você e seus projetos ao longo do tempo
6. Cron — agende tarefas para rodarem automaticamente, como um resumo diário pela manhã

O comando principal aqui é:

# Inicia uma nova sessão com uma habilidade específica carregada
hermes --skill minha-habilidade-personalizada

Esta também é a fase em que você vai querer configurar seus bots de mensagens. A documentação tem tutoriais completos para Telegram e Discord, além de projetos de exemplo como um bot de resumo diário que envia as notícias toda manhã.

Passo 3: Aprofunde-se (Avançado — ~4–6 horas)

É aqui que você se torna um usuário avançado. Você não está apenas usando o Hermes — você está expandindo ele.

1. Arquitetura — entenda como o Hermes é construído por baixo dos panos
2. Adicionando Ferramentas — escreva suas próprias funções Python que o Hermes pode chamar
3. Criando Habilidades — empacote suas ferramentas personalizadas e prompts em habilidades compartilháveis
4. Contribuindo — envie suas melhorias de volta para o projeto de código aberto

Uma ferramenta personalizada simples se parece com isto:

from hermes import tool

@tool
def get_weather(city: str) -> str:
    """Obtém o clima atual de uma cidade."""
    # Seu código aqui
    return f"Clima em {city}: ensolarado, 72°F"

Depois de escrever isso, o Hermes pode chamar automaticamente sua função quando alguém perguntar sobre o clima. Sem integração complexa necessária.

Seu Roteiro Pessoal

A verdade honesta: você não precisa ler tudo. Escolha seu objetivo:

• Só quer um assistente de terminal? Faça o Passo 1 e pare.
• Quer um bot de Telegram? Faça o Passo 1 + Passo 2 (seções de Mensagens + Voz).
• Quer automatizar sua vida? Faça o Passo 1 + Passo 2 (seções de Cron + Memória).
• Quer construir algo novo? Faça os três passos.

A documentação é organizada para você pular seções. A tabela na página oficial até dá estimativas de tempo — a maioria das pessoas termina o Passo 1 em menos de uma hora.

Resumo

Pense neste caminho de aprendizado como aprender a cozinhar: primeiro você aprende a ferver água (Passo 1), depois segue receitas (Passo 2) e, finalmente, inventa seus próprios pratos (Passo 3). Comece pequeno, ganhe confiança e expanda quando estiver pronto.

A seguir: No Tutorial 4, vamos manter o Hermes atualizado — atualizando e desinstalando de forma limpa, com uma rede de segurança integrada.

---