Contribuir
Obrigado por contribuir com o Hermes Agent! Este guia cobre como montar o seu ambiente de desenvolvimento, entender a base de código e conseguir que o seu PR…
Arquitetura
Esta página é o mapa de alto nível das entranhas do Hermes Agent. Use-a para se situar no código e depois mergulhe na documentação de cada subsistema para os…
Laço do Agente
O motor central de orquestração é a classe AIAgent, em runagent.py — um arquivo grande que cuida de tudo, da montagem do prompt ao despacho de ferramentas e à…
Montagem do Prompt
Esta é uma das decisões de projeto mais importantes do repositório, porque ela afeta:
Compressão e Cache de Contexto
O Hermes Agent usa um sistema de compressão dupla e o cache de prompt da Anthropic para administrar com eficiência o uso da janela de contexto em conversas…
Gateway por Dentro
O gateway de mensagens é o processo de longa duração que conecta o Hermes a mais de 20 plataformas externas de mensagem, por uma arquitetura unificada.
Armazenamento de Sessões
O Hermes Agent usa um banco SQLite (~/.hermes/state.db) para persistir metadados de sessão, o histórico completo de mensagens e a configuração de modelo entre…
Runtime de Provedores
O Hermes tem um resolvedor de runtime de provedores compartilhado, usado em:
Adicionar Ferramentas
Como acrescentar uma ferramenta embutida ao núcleo do Hermes — e quando é melhor fazer uma skill ou um plugin.
Adicionar Provedores
O Hermes já consegue falar com qualquer endpoint compatível com a OpenAI pelo caminho de provedor personalizado.
Adicionar Adaptadores de Plataforma
Este guia cobre como acrescentar uma nova plataforma de mensagens ao gateway do Hermes. Um adaptador de plataforma liga o Hermes a um serviço externo de…
Criar Skills
Skills são o jeito preferido de acrescentar capacidades novas ao Hermes Agent. Elas são mais fáceis de criar do que ferramentas, não exigem mudança de código…
Estender a CLI
Ganchos protegidos que deixam CLIs derivadas acrescentar widgets, atalhos e layout sem sobrescrever o run().
ACP por Dentro
Como o adaptador ACP embrulha o AIAgent síncrono num servidor JSON-RPC assíncrono por stdio.
Plugins de Provedor de Navegador
Plugins de provedor de navegador registram um backend de navegador na nuvem que atende às chamadas de ferramenta browser no modo nuvem (navegar, clicar, tirar…
Supervisor CDP do Navegador
O supervisor CDP fecha duas lacunas antigas do ferramental de navegador do Hermes:
Mapa do Código
Qual diretório do código cuida de qual subsistema, e que documentação ler antes de mexer.
Plugins de Motor de Contexto
Plugins de motor de contexto substituem o ContextCompressor embutido por uma estratégia alternativa de gerenciar o contexto da conversa.
Cron por Dentro
O subsistema de cron oferece execução de tarefas agendadas — de atrasos simples de uma vez só a jobs recorrentes com expressão de cron, injeção de skill e…
SDK de Plugin do Desktop
O aplicativo nativo Hermes Desktop é movido a contribuições: toda superfície da janela — painéis, rotas, navegação lateral, itens da barra de status, entradas…
Proxy de Saída por Dentro
Esta página cobre a arquitetura do firewall de injeção de credenciais na saída (hermes egress / iron-proxy) do ponto de vista de quem contribui com o código ou…
Plugins de Geração de Imagem
Plugins de provedor de geração de imagem registram um backend que atende toda chamada da ferramenta imagegenerate — DALL·E, gpt-image, Grok, Flux, Imagen…
Plugins de Provedor de Memória
Plugins de provedor de memória dão ao Hermes Agent conhecimento persistente entre sessões, além do MEMORY.md e do USER.md embutidos.
Plugins de Provedor de Modelo
Como declarar um backend de inferência como plugin de provedor de modelo, sem editar o repositório do Hermes.
Acesso a LLM em Plugins
O ctx.llm é o jeito suportado de um plugin fazer uma chamada de LLM — chat, extração estruturada, síncrono ou assíncrono, com credenciais do host.
Criar um Plugin do Hermes
Este guia percorre a construção de um plugin completo do Hermes, do zero. No fim você terá um plugin funcionando, com várias ferramentas, hooks de ciclo de…
Integração Programática
O Hermes traz três protocolos para dirigir o agente a partir de programas externos — plugins de IDE, interfaces próprias, pipelines de CI, subagentes embutidos.
Plugins de Fonte de Segredos
Fontes de segredos resolvem credenciais de provedor guardadas num gerenciador externo e as transformam em variáveis de ambiente na subida do processo.
API de Ciclo de Vida de Subagentes
Como plugins abrem e supervisionam sessões filhas do Hermes sem depender de internals.
Plugins de Ambiente de Terminal
O Hermes roda comandos de shell através de um conjunto plugável de backends de terminal. Os backends embutidos (local, Docker, Singularity, Modal, Daytona…
Runtime de Ferramentas
As ferramentas do Hermes são funções que se registram sozinhas, agrupadas em conjuntos de ferramentas e executadas por um sistema central de registro e…
Formato de Trajetória
O Hermes Agent salva as trajetórias de conversa em formato JSONL compatível com ShareGPT, para uso como dado de treinamento, artefato de depuração e conjunto…
Plugins de Geração de Vídeo
Plugins de provedor de geração de vídeo registram um backend que atende toda chamada da ferramenta videogenerate.
Plugins de Busca na Web
Os plugins de provedor de busca na web registram um backend que atende às chamadas de ferramenta websearch, webextract e (opcionalmente) de deep crawl.
TUI e Desktop a partir de Worktrees
O núcleo em Python roda sem problema a partir de qualquer git worktree — você entra com cd e o hermes simplesmente funciona.