Usar Hermes como uma Biblioteca Python

Pense no Hermes como um assistente robô amigável que você pode comandar com Python puro — sem precisar aprender uma nova linguagem ou navegar por um painel cheio de firulas.

O Que Significa “Usar como Biblioteca”?

Normalmente, você conversa com o Hermes por uma janela de chat. Mas quando você o usa como uma biblioteca Python, você escreve scripts Python que dizem ao Hermes o que fazer. Isso é perfeito para automatizar tarefas repetitivas, como corrigir código, rodar testes ou limpar arquivos.

Seus Primeiros Comandos: Buscar e Corrigir

Digamos que você tenha um projeto grande com chamadas de API antigas que precisam ser atualizadas. Em vez de abrir cada arquivo manualmente, você pode escrever um script que encontra e corrige todos de uma vez:

# Find all Python files using deprecated API and fix them
matches = search_files("old_api_call", path="src/", file_glob="*.py")
fixed = 0
for match in matches.get("matches", []):
    result = patch(
        path=match["path"],
        old_string="old_api_call(",
        new_string="new_api_call(",
        replace_all=True
    )
    if "error" not in str(result):
        fixed += 1

print(f"Fixed {fixed} files out of {len(matches.get('matches', []))} matches")

Veja o que acontece: o Hermes procura em cada arquivo .py em src/, encontra old_api_call( e substitui por new_api_call(. Você acabou de economizar horas de trabalho manual.

Rodando Testes e Obtendo um Relatório

Quer saber se o seu código realmente funciona? Você pode rodar sua suíte de testes e obter um resumo limpo:

from hermes_tools import terminal, read_file
import json

# Run tests, parse results, and report
result = terminal("cd /project && python -m pytest --tb=short -q 2>&1", timeout=120)
output = result.get("output", "")

# Parse test output
passed = output.count(" passed")
failed = output.count(" failed")
errors = output.count(" error")

report = {
    "passed": passed,
    "failed": failed,
    "errors": errors,
    "exit_code": result.get("exit_code", -1),
    "summary": output[-500:] if len(output) > 500 else output
}

print(json.dumps(report, indent=2))

Este script roda seus testes, conta quantos passaram ou falharam e imprime um relatório JSON organizado. Você pode até enviar esse relatório por e-mail para sua equipe automaticamente.

Duas Maneiras de Rodar Seu Código

O Hermes oferece dois “modos” para executar scripts:

• Modo Projeto (padrão): Seu script roda na pasta do seu projeto, usando o mesmo ambiente Python que você já tem. Isso é melhor para o trabalho do dia a dia — você pode usar import pandas ou ler arquivos com caminhos relativos normalmente.

• Modo Estrito: Seu script roda em uma pasta separada e isolada, com o Python próprio do Hermes. Use isso quando quiser máxima reprodutibilidade — como quando você está compartilhando um script com outra pessoa e quer garantir que ele rode igual em qualquer lugar.

Você pode alternar os modos no seu arquivo de configuração:

# ~/.hermes/config.yaml
code_execution:
  mode: project   # or "strict"

Segurança em Primeiro Lugar (Mesmo Programando)

Não se preocupe com segurança — o Hermes é cuidadoso. Em ambos os modos, ele:

• Remove chaves de API e senhas do ambiente do seu script
• Bloqueia scripts de chamar outras ferramentas do Hermes recursivamente
• Limita o tempo de execução do script (máximo de 5 minutos) e a quantidade de saída que ele pode imprimir

Resumo e Dica de Especialista

Usar o Hermes como biblioteca Python transforma tarefas chatas em scripts de uma linha. Comece pequeno: escolha uma tarefa repetitiva (como renomear variáveis ou rodar testes) e automatize-a.

Dica prática: Sempre teste seu script em uma cópia do seu projeto primeiro, não no original. Assim, se algo der errado, você não quebrou nada. Quando estiver confiante, rode no projeto real. Boa automação!

---