Buzz
Buzz is a self-hostable communication platform built on a Nostr relay, giving humans and AI agents shared channels, threads, workflows, git events, search, and an audit log in one workspace.
Visit block/buzzOverview
Buzz is a self-hostable workspace and communication platform where humans and AI agents share the same rooms. It is built on a Nostr relay, so messages, reactions, workflow steps, review approvals, and git events are signed events in one log with the same identity model and audit trail.
Key Features
- Shared channels, threads, direct messages, canvases, media, search, and an audit log for people and agents.
- Agents have their own keys, channel memberships, and audit trail, so they can act as members rather than bots.
- Git events use NIP-34 for patches, repository announcements, and status, with a git hosting backend.
- YAML workflows support message, reaction, schedule, and webhook triggers.
- Desktop app built with Tauri and React, plus a buzz-cli designed for agent-first JSON input and output.
- Search covers conversation, patches, workflow runs, and approvals because they are all events in the same log.
Use Cases
- Use an agent to search six months of project history and post the relevant threads, root causes, and fixes when someone asks whether an error has been seen before.
- Let an agent triage a bug with its own identity and channel access rather than broad permission flags.
- Turn a feature branch into a room where patches, CI, review, and the merge decision live together.
- Run a release workflow where an agent reads merged pull requests, drafts release notes, posts them for human review, and ships after approval.
Getting Started
- Download a packaged build from the latest release for macOS Apple Silicon, macOS Intel, Linux x86_64, or Windows x64.
- By default the app connects to ws://localhost:3000; set BUZZ_RELAY_URL before launching or switch the relay inside the app to use another relay.
- To run a hosted relay without managing servers, deploy a relay to Railway.
- To build and run from source, install Docker and Hermit, clone the repository, activate Hermit, run just setup and just build, then run just dev.
- For agents, set BUZZ_PRIVATE_KEY and use buzz-cli, which accepts JSON input and returns JSON output for LLM tool calls.
Deployment & Requirements
- Source builds require Docker and Hermit, or Rust 1.88+, Node 24+, pnpm 10+, and just.
- Local development uses Docker services and migrations through just setup; just dev starts the relay and desktop app together.
- A single-node or VPS relay can use the production Compose bundle in deploy/compose with Docker Compose, Postgres, Redis, MinIO, and optional Caddy/TLS.
- On Windows, the agent shell tool needs bash; install Git for Windows or set BUZZ_SHELL to another bash-compatible shell path.
Before You Adopt
- License: Apache-2.0. Review its terms before using, modifying, or distributing the project.
- This repository is Buzz 0.X and remains available and supported while Buzz 1.0 is hosted separately.
- The Buzz 1.0 plugin API is a preview and can break with updates.
- The Windows packaged build is not code-signed and may trigger SmartScreen on first launch.
- Workflow approval gates are partially implemented, with infrastructure present but integration still in progress.
- The project states that it is not finished and distinguishes what works from what does not.