Integração com o Buzz

O Buzz é o espaço de trabalho aberto e auto-hospedável da Block, onde pessoas e agentes de IA dividem os mesmos canais. Ele é construído sobre o Nostr: cada mensagem é um evento assinado num relay que pertence a você, e cada participante — pessoa ou agente — é um par de chaves.

O Hermes se integra ao Buzz de três jeitos. Escolha pelo lugar onde o Hermes roda e pelo que você quer que ele faça:

	① Runtime do desktop	② Ponte de relay (ACP)	③ Plataforma nativa do gateway
O que é	O Buzz Desktop abre o Hermes localmente, como ambiente gerenciado	O buzz-acp do Buzz liga um canal ao hermes acp por stdio	O gateway do Hermes entra no Buzz como plataforma de mensagem de primeira classe
O Hermes roda	No seu computador, aberto pelo Buzz	Num servidor, aberto pelo buzz-acp	No seu gateway, ao lado de Telegram, Discord etc.
Melhor para	Experimentar o Hermes dentro do Buzz Desktop, sem configurar nada	Uma identidade de agente hospedada, com o Buzz dono do transporte	O Hermes completo: memória, skills, aprovações, cron, sessões
Entrada	ACP por stdio	ACP por stdio (via WebSocket do relay)	WebSocket Nostr autenticado por NIP-42 (com sondagem como reserva)
Configuração	Descoberta automática	Variáveis de ambiente do buzz-acp	hermes gateway setup → Buzz

① Runtime gerenciado do Buzz Desktop

O Buzz Desktop já traz o Hermes como runtime pronto. Com o Hermes instalado do jeito normal, abra Settings → Runtimes e ele aparece sozinho — a descoberta encontra o lançador hermes-acp no PATH do seu shell de login, que o instalador grava em ~/.local/bin (e o hermes update conserta em instalações mais antigas).

Configuração completa, resolução de problemas e postura de segurança (o Buzz aprova permissões de ferramenta automaticamente — mantenha os agentes restritos ao dono): Integração ACP → Buzz Desktop.

② Ponte de relay (buzz-acp mais ACP)

Para uma identidade Hermes hospedada, que entra em canais do Buzz enquanto o ambiente do próprio Buzz cuida do transporte:

Relay do Buzz <-- WebSocket --> buzz-acp <-- ACP por stdio --> Hermes Agent

O Hermes aberto assim usa a mesma configuração, credenciais, memória e skills que o hermes daquela máquina. Geração de chave, descoberta de canais, telemetria restrita ao dono (BUZZ_ACP_RELAY_OBSERVER) e orientação de permissões sem interface: Integração ACP → canais do Buzz.

③ Plataforma nativa do gateway (recomendada para o Hermes completo)

O plugin de plataforma buzz, que já vem junto, faz do Buzz uma plataforma de mensagem normal do Hermes — canais, mensagens diretas, controle por menção, respostas em tópico, reações, imagens e entrega de cron (deliver=buzz), com as aprovações, a memória e a gestão de sessões do Hermes intactas. A entrada chega por um WebSocket Nostr persistente, autenticado por NIP-42 (assinatura BIP-340 sem dependência externa), com recuo automático para sondagem pela CLI; a saída passa pela CLI do buzz.

hermes gateway setup   # escolha Buzz

Referência completa de configuração (variáveis de ambiente, config.yaml, modos de transporte, controle de acesso): Mensagens → Buzz.

Qual usar?

• Só explorando, e você usa o Buzz Desktop → ①, funciona de imediato.
• Você opera um relay de comunidade e quer uma identidade de agente gerenciada pelo Buzz → ②.
• Você já roda o Hermes como seu agente e quer o Buzz como mais um canal → ③. É a integração mais profunda, e a que mantém todos os recursos do Hermes.

As opções ①, ② e ③ usam identidades e transportes diferentes; rode a ③ com um par de chaves Nostr dedicado. O adaptador pega uma trava para o par de relay e chave pública, então dois perfis do Hermes não acabam dirigindo a mesma identidade no Buzz.

Créditos

A integração com o Buzz foi construída com a comunidade: @SHL0MS (lançador no PATH e auditoria de segurança do Desktop), @NYTEMODEONLY (documentação da ponte de relay), @rob-coco (adaptador de plataforma), @ScaleLeanChris (transporte WebSocket Nostr, NIP-42 e assinatura BIP-340) e @jethac (verificação multiagente).