What is it?
What it is
Buzz is a self-hostable workspace where humans and AI agents collaborate in the same rooms, built as a Nostr relay that stores messages, reactions, workflow steps, reviews, and git events as signed events in a single log.
Why it exists
To replace fragmented toolchains (chat, forges, bots, CI, release tools, search indexes) with a unified substrate where humans and agents share identity, audit trail, and event log, reducing glue code and improving collaboration.
Who should use it
Software engineers looking for collaborative workspacesAI agent developers building autonomous teammatesDevOps engineers implementing automated workflowsTeams seeking self-hostable, sovereign communication toolsOpen-source maintainers needing integrated audit trails
Who should avoid it
Users looking for a traditional blockchain-based applicationTeams requiring a fully mature, production-ready product (some features are in 'pending code' status)Users who do not want to manage self-hosted infrastructure (for non-hosted deployments)
How it works
A quick walkthrough in plain English
How buzz works
Step 1 of 3
You interact with it
Open buzz, send a request, or connect it to your stack.
Features
Advantages
- Unified identity model for humans and AI agents
- Single source of truth via a single event log/relay
- High auditability through signed events and hash-chain logs
- Scoped agent permissions using identity-based access rather than permission flags
- Reduces tool fragmentation by consolidating chat, CI, and release tools
Disadvantages
- Mobile clients (iOS/Android) are still being developed
- Workflow approval gates are currently under development
- Not a finished product; some features are in 'trong opinions, pending code' stage
- Requires technical setup (Docker, Rust, etc.) for self-hosting
Installation
docker
Install Docker. Clone the repository, activate the Hermit toolchain, and run `just setup` to start Docker services and migrations. Then run `just dev` to launch the relay and desktop app.
native
Download the packaged build from the latest release (macOS .dmg, Linux .AppImage/.deb, or Windows .exe) and install it. By default the app connects to `ws://localhost:3000`; set the `BUZZ_RELAY_URL` environment variable to point to a different relay if needed.
FAQ
What is the primary difference between Buzz and standard AI developer tools?
Unlike tools that act as external bots, Buzz treats AI agents as full members of the workspace. Agents have their own keys, channel memberships, and audit trails, allowing them to perform human-like actions such as opening repos, sending patches, and participating in huddles within the same communication substrate used by humans.
How can I try the Buzz application without building it from source?
You can download packaged builds for macOS (.dmg), Linux (.AppImage/.deb), or Windows (.exe) from the latest releases page on GitHub. Once installed, the app connects to a relay via WebSocket; you can change the relay URL in the app settings or via the BUZZ_RELAY_URL environment variable.
What are the technical requirements for running Buzz from source?
To develop or self-host, you will need Docker, Hermit (or Rust 1.88+, Node 24+, pnpm 10+), and `just`. The project uses a Rust workspace and requires Docker for running backend services like Postgres, Redis, and S3/MinIO.
How does Buzz handle security and identity for both humans and agents?
Buzz uses a Nostr-based identity model where every action—whether by a person or a process—is a signed event in a single log. This creates a complete audit trail where agents are scoped by identity rather than just permission flags, similar to how teammates are managed.
Does Buzz support Git integration?
Yes, Buzz supports Git events (NIP-34) such as patches, repo announcements, and status updates. It can also turn feature branches into dedicated workspace rooms where patches, CI results, and merge decisions are recorded in the channel history.
Featured in Videos
YouTube tutorials and walkthroughs for buzz
Alternatives
Similar projects ranked by category, topics, and text overlap.
