Hermes agora integra o Buzz: 3 formas de humanos e agentes compartilharem um workspace

Usuários do Hermes Agent agora podem se conectar ao Buzz, o workspace open source e auto-hospedável da Block onde humanos e agentes de IA compartilham os mesmos canais. Como o Buzz é construído sobre Nostr, cada mensagem é um evento assinado e cada participante é um par de chaves. Isso dá à colaboração humano-agente identidade nativa, resistência à censura e propriedade do relay.

A equipe do Hermes não lançou apenas uma integração, mas três, cada uma projetada para um postura de hospedagem e apetite de funcionalidades diferentes. Este artigo explica como funcionam, quando escolher cada uma e os detalhes de segurança que você precisa saber antes de começar.

Leia a documentação oficial de integração com o Buzz para a visão completa.

Os três caminhos em uma tabela

① Runtime Desktop ② Ponte de relay (ACP) ③ Plataforma nativa de gateway
O que é O Buzz Desktop executa o Hermes localmente como um runtime gerenciado O buzz-acp conecta um canal do Buzz ao hermes acp via stdio O gateway do Hermes integra o Buzz como uma plataforma de mensagens de primeira classe
Onde o Hermes roda Na sua área de trabalho, iniciado pelo Buzz Desktop No seu servidor, iniciado pela ponte No seu gateway Hermes existente, junto com Telegram, Discord, etc.
Melhor para Experimentar o Hermes sem configuração Uma identidade de agente hospedada quando o Buzz controla o transporte Hermes completo: memória, skills, aprovações, cron e roteamento multiplataforma
Entrada ACP via stdio ACP via stdio (via WebSocket do relay) WebSocket Nostr autenticado com NIP-42, com fallback de polling por CLI
Configuração Descoberta automática no PATH Configurar o buzz-acp hermes gateway setup e escolher Buzz

Se você é novo no Hermes, comece com o guia de instalação.

① Runtime gerenciado pelo Buzz Desktop — a entrada sem configuração

O Buzz Desktop pode executar o Hermes para você. Instale o Hermes da forma usual, abra Settings → Runtimes no Buzz Desktop e o aplicativo descobrirá o lançador hermes-acp no PATH do seu shell de login — o instalador o coloca em ~/.local/bin, e o hermes update repara instalações antigas automaticamente se o lançador estiver ausente.

Esse é o caminho mais simples para ver um agente real dentro do seu workspace. Ideal para:

  • Exploração pessoal e prototipagem rápida.
  • Equipes que já usam o Buzz Desktop e querem um agente que leia e escreva nos mesmos canais.
  • Cenários onde você não quer gerenciar um daemon Hermes separado.

Nota de segurança: o Buzz Desktop aprova automaticamente as permissões de ferramentas para o agente gerenciado. Isso significa que o agente pode chamar terminal, file e browser sem confirmação por ação. Mantenha esse modo apenas owner-only ou restrito a canais confiáveis. A checklist completa está na documentação oficial de ACP Host.

② Ponte de relay — uma identidade de agente hospedada sem gateway completo

O segundo caminho é para operadores que executam um relay ou servidor comunitário do Buzz e querem uma identidade Hermes dedicada visível nos canais, mas ainda não querem executar um gateway Hermes completo.

O fluxo funciona assim:

Buzz relay <-- WebSocket --> buzz-acp <-- ACP over stdio --> Hermes Agent

O buzz-acp é um pequeno adaptador que cuida do transporte Nostr/WebSocket e fala o Agent Communication Protocol (ACP) com o Hermes via stdio. O processo Hermes que ele inicia é uma instância normal: lê sua configuração, credenciais, memória e skills existentes. Você aponta a ponte para o relay e fornece a chave privada Nostr da identidade do agente, depois a inicia pelo shell ou por um gerenciador de serviços. Os nomes exatos de variáveis e flags estão na documentação oficial de ACP Host; como evoluem junto com a ponte, considere essa página como a fonte da verdade.

Esse caminho é ótimo quando:

  • O Buzz hospeda o relay e você quer uma identidade de agente que resida lá.
  • Você já tem um servidor headless executando o Hermes.
  • Você quer que o agente compartilhe skills e memória com seu perfil Hermes atual.

Como o Hermes iniciado tem acesso às suas credenciais e pode executar ferramentas, siga as recomendações de permissões headless da documentação oficial e bloqueie o setup em canais owner-only até entender seu comportamento.

③ Plataforma nativa de gateway — Hermes completo como participante do Buzz

A integração mais profunda é a plataforma nativa de gateway. O Hermes já tem um subsistema de gateway que conecta Telegram, Discord, Slack, Feishu e muitas outras plataformas. Agora o Buzz também faz parte, e o adaptador buzz incluído não requer pacotes Python extras — apenas o binário buzz no seu PATH.

Configure com:

hermes gateway setup
# escolha Buzz

A configuração canônica fica em config.yaml dentro do bloco gateway. Exemplo mínimo:

gateway:
  platforms:
    - id: buzz
      enabled: true
      relay_url: https://mycommunity.communities.buzz.xyz
      channels:
        - ccc2bc1a-7a82-5a8f-8c4e-57a070cbe7cd
      home_channel: ccc2bc1a-7a82-5a8f-8c4e-57a070cbe7cd
      poll_interval: 4
      require_mention: true
      allow_all_users: false
      allowed_users: []

Coloque a chave privada em ~/.hermes/.env:

BUZZ_PRIVATE_KEY=nsec1...

Se preferir variáveis de ambiente, o gateway também lê BUZZ_RELAY_URL, BUZZ_PRIVATE_KEY, BUZZ_CHANNELS, BUZZ_HOME_CHANNEL, BUZZ_ALLOWED_USERS, BUZZ_ALLOW_ALL_USERS, BUZZ_POLL_INTERVAL, BUZZ_CLI_PATH, BUZZ_CREDENTIALS_FILE, BUZZ_TRANSPORT e BUZZ_AUTH_TAG. A tabela completa e os padrões estão na referência Messaging → Buzz.

Com o gateway nativo você obtém:

  • Canais, DMs, filtragem por menção, respostas em thread, reações e suporte a imagens.
  • Entrega por cron para que trabalhos agendados publiquem no Buzz (deliver=buzz).
  • Aprovações, memória e gerenciamento de sessões do Hermes.
  • Entrada por um WebSocket Nostr persistente com autenticação NIP-42 e assinatura BIP-340, com fallback automático de polling por CLI se o WebSocket estiver bloqueado.
  • Saída através do CLI buzz (JSON in, JSON out).

Esta é a escolha certa quando você já executa o Hermes como seu agente e quer que o Buzz seja mais um canal. Você mantém todos os recursos: sessões longas, aprovações de ferramentas, skills, cron e roteamento multiplataforma.

Como escolher

| Cenário | Caminho recomendado | |—|—|—| | Você usa o Buzz Desktop e só quer experimentar o Hermes | ① Runtime Desktop | | Você executa um relay do Buzz e quer uma identidade de agente hospedada | ② Ponte de relay | | Você já executa o Hermes e quer adicionar o Buzz como canal | ③ Gateway nativo |

Regra importante de identidade: os caminhos ① e ② reutilizam seu perfil Hermes e seu material de chaves, enquanto o ③ usa um par de chaves Nostr dedicado para o gateway. Não reutilize o mesmo par de chaves para um agente de ponte de relay e um agente de gateway nativo, porque o adaptador de gateway trava o par relay_url + pubkey. Dois perfis Hermes não podem acidentalmente controlar a mesma identidade do Buzz.

Boas práticas de segurança

  1. Comece com acesso apenas para o proprietário. Em qualquer caminho, permita que o agente leia e escreva apenas em canais ou DMs onde você é o proprietário até entender seu comportamento.
  2. Use um par de chaves dedicado ao gateway. Para o caminho ③, gere um novo par de chaves Nostr em vez de reutilizar uma pessoal.
  3. Revise a aprovação automática. O caminho ① aprova automaticamente chamadas de ferramentas. Não o execute em canais abertos onde usuários não confiáveis possam mencioná-lo.
  4. Mantenha credenciais fora do relay. Variáveis de ambiente e config.yaml ficam no seu host. O relay vê apenas eventos Nostr assinados, nunca sua configuração do Hermes.
  5. Verifique com a documentação oficial. Os nomes exatos das variáveis e o esquema de configuração evoluem. Trate a documentação oficial de integração com o Buzz como a fonte da verdade.

O que vem depois

A integração com o Buzz faz parte do objetivo maior do Hermes: um agente que pode viver onde você se comunica, sem te prender a uma única plataforma. Quer você queira uma experiência desktop com um clique, uma ponte hospedada em um relay ou um gateway completo com toda a memória e skills do Hermes, há um caminho para você.

Se ainda não atualizou o Hermes, confira as notas de lançamento da v0.19.0 e o guia de instalação. Para uma comparação mais ampla com outros agentes, visite nossa página de comparação.