Hermes

O Problema

Manter vários projetos ativos ao mesmo tempo (plugins para QGIS, um site bilíngue, análises de dados) significa alternar o dia inteiro entre decidir o que fazer, implementar, conferir e publicar. Os modelos de linguagem capazes de escrever código com qualidade cobram por token consumido, e esse custo cresce junto com o volume de trabalho. O gargalo real não está em escrever código: está em decidir, executar, conferir e pagar por tudo isso de um jeito que se sustente ao longo do tempo.

A Solução

O Hermes é um sistema multi-agente derivado do Hermes Agent, da Nous Research, adaptado para rodar 24 horas por dia em uma VPS própria com Ubuntu 24.04. Toda a operação acontece pelo Discord, inclusive a partir do celular, sem depender de um terminal aberto ou de uma sessão de trabalho contínua. Cada canal do servidor corresponde a um projeto, e o ciclo se repete em cada um deles: conversa, plano, implementação, revisão e publicação.

Decisões de Arquitetura

Separação entre coordenação e execução: um orquestrador leve interpreta a conversa e decide o que precisa ser feito, mas quem implementa é sempre um motor de assinatura externo, como Claude Code (Opus), Antigravity (Gemini) ou Codex. O orquestrador não escreve código diretamente; ele delega.

Modelo forte planeja, modelo barato executa: o raciocínio mais caro (entender o pedido, desenhar o plano, revisar o resultado) fica com o modelo mais capaz disponível. A implementação de cada passo do plano vai para um executor mais barato, e só volta ao modelo forte para ser conferida antes de seguir adiante.

Motor próprio de roteamento por dificuldade: um motor escrito em Python lê o plano e envia cada passo para o executor mais adequado à sua complexidade, distinguindo tarefas mecânicas de tarefas que exigem mais raciocínio. Quando um provedor esgota sua cota, o motor recorre a outro automaticamente, sem interromper o trabalho em andamento.

Custo separado em dois baldes: só a coordenação, a parte que decide e revisa, consome créditos pagos por token. A execução roda sobre assinaturas mensais já contratadas para os motores de código, o que aproxima de zero o custo marginal de cada tarefa executada. Essa divisão foi uma decisão financeira deliberada, e o comportamento de cada motor (custo, cota, qualidade) é medido e revisto ao longo do tempo.

Aprovação humana no início, revisão automatizada no fim: nenhum plano é executado sem aprovação prévia, e nenhuma publicação acontece sem uma revisão automatizada do resultado. Os dois pontos de controle mantêm o sistema fora da decisão autônoma tanto sobre o que fazer quanto sobre o que entra em produção.

Operação e Confiabilidade

O Hermes roda como serviço persistente sob systemd, com um timer separado que audita seu próprio comportamento semanalmente. Toda a operação gera logs estruturados e notificações, e todo o código do sistema é versionado em git. A publicação deste site, por exemplo, é automatizada por GitHub Actions a partir do momento em que uma alteração aprovada é enviada. A evolução do sistema fica documentada: cada decisão de arquitetura é registrada com data, e o comportamento dos modelos usados (custo, cota, qualidade das respostas) é medido de forma empírica em vez de assumido.

Stack Tecnológica

Python Arquitetura Multi-Agente Orquestração de LLMs Engenharia de Prompt Claude Code (Opus) Gemini Codex Discord API Linux / Ubuntu Server systemd Git GitHub Actions QGIS / PyQGIS

Impacto

O resultado é verificável em três frentes. O Hermes desenvolve e mantém os plugins para QGIS publicados (GisBR, Desire Lines e SIG-Bus), mantém este site (os posts do blog em português e inglês e este próprio portfólio) e executa análises de dados, tudo conduzido por conversa. O arranjo demonstra a capacidade de projetar sistemas que coordenam múltiplos modelos de linguagem com controle de custo, papéis bem definidos entre planejamento e execução, e supervisão humana nos pontos em que ela importa.