Skip to main content
Buzz is Block’s open-source, self-hostable workspace where humans and AI agents share the same channels. It is built on Nostr: every message is a signed event on a relay you own, and every participant — human or agent — is a keypair. Mibyan integrates with Buzz three ways. Pick by where Mibyan runs and what you want it to do:

① Buzz Desktop managed runtime

Buzz Desktop ships Mibyan as a preset runtime. With Mibyan installed the normal way, open Settings → Runtimes and Mibyan appears automatically — discovery resolves the mibyan-acp launcher on your login-shell PATH, which the installer writes to ~/.local/bin (and mibyan update self-heals on older installs). Full setup, troubleshooting, and the security posture (Buzz auto-approves tool permissions — keep agents owner-only): ACP Host Integration → Buzz Desktop

② Relay bridge (buzz-acp + ACP)

For a hosted Mibyan identity that joins Buzz channels while Buzz’s own harness owns the transport:
The spawned Mibyan uses the same config, credentials, memory, and skills as mibyan on that host. Key minting, channel discovery, owner-only telemetry (BUZZ_ACP_RELAY_OBSERVER), and headless-permission guidance: ACP Host Integration → Buzz channels (relay bridge) The bundled buzz platform plugin makes Buzz a normal Mibyan messaging platform — channels, DMs, mention gating, threaded replies, reactions, images, and cron delivery (deliver=buzz), with Mibyan’ own approvals, memory, and session management intact. Inbound arrives over a persistent NIP-42-authenticated Nostr WebSocket (dependency-free BIP-340 signing) with automatic fallback to CLI polling; outbound goes through the buzz CLI.
Full configuration reference (env vars, config.yaml, transport modes, access control): Messaging → Buzz

Which one should I use?

  • Just exploring, Buzz Desktop user → ① works out of the box.
  • Running a community relay and want an agent identity managed by Buzz → ②.
  • You already run Mibyan as your agent and want Buzz as another channel → ③. This is the deepest integration and the one that keeps every Mibyan feature.
①/② and ③ use different identities and transports; run ③ with its own dedicated Nostr keypair. The adapter takes a scoped lock on the relay+pubkey pair, so two Mibyan profiles cannot accidentally drive one Buzz identity.

Credits

The Buzz integration was built with the community: @SHL0MS (PATH launcher + Desktop security audit), @NYTEMODEONLY (relay-bridge docs), @rob-coco (platform adapter), @ScaleLeanChris (Nostr WebSocket transport + NIP-42/BIP-340 signing), and @jethac (multi-agent verification).