explaingit

vibherpunk/buzz

Analysis updated 2026-07-26

1RustAudience · developerComplexity · 4/5Setup · hard

TLDR

A self-hosted team chat app where humans and AI agents share the same workspace. Agents act as full team members that can write code, review PRs, and search conversation history alongside people.

Mindmap

mindmap
  root((repo))
    What it does
      Self-hosted team chat
      Humans and AI agents together
      Agents as full team members
      Shared search and audit log
    Key features
      Channel-scoped agent tools
      Channel-scoped personas
      Git integration and code review
      Voice huddles in progress
    Tech stack
      Rust
      Nostr protocol
      Desktop app
      Command-line tools
    Use cases
      Feature branch chat rooms
      Agent searches chat history
      Agents submit code patches
      Automated code reviews
    Setup
      Self-hosted on your server
      Fork adds Harbor room config
      Channel tools panel
    Audience
      Development teams
      Ops and infrastructure
      AI-powered workflows

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a private team chat where AI agents can search months of conversation history and answer questions with evidence.

USE CASE 2

Create a channel tied to a feature branch where code changes, test results, and merge decisions live together.

USE CASE 3

Assign different AI personalities and tool sets to different chat channels using configuration files.

USE CASE 4

Let AI agents open repositories, submit code patches, and participate in code reviews as full team members.

What is it built with?

RustNostr Protocol

How does it compare?

vibherpunk/buzzabc3dz/mixxxabyo-software/ferro-stash
Stars111
LanguageRustRustRust
Setup difficultyhardmoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires self-hosting on your own server and familiarity with Rust and the Nostr protocol, mobile clients and some features are still in development.

The license is not specified in the available documentation.

In plain English

Buzz is a self-hostable team workspace where humans and AI agents work together in the same chat rooms. You run it on your own server, and everyone, including the automated agents, shares one space with the same communication tools. The project describes itself as a relay you own, meaning you control the infrastructure rather than relying on an external service. This particular repository is a fork of another project called block/buzz. The fork adds two features that tie channels (chat rooms) to external "Harbor" rooms, which define what skills and tools an agent can use. First, channel-scoped tools confine every agent in a given channel to a specific set of abilities. Second, channel-scoped personas let a channel override an agent's default behavior with a different personality or instructions, pulled from a configuration file. Both features are optional and managed from a "Channel tools" panel in the channel header. Inside Buzz, agents are treated as full team members rather than simple bots. They have their own identities, their own keys, and their own audit trails. They can open repositories, submit code patches, run workflows, review code, create channels, and join voice huddles. The README gives examples of what this looks like: you can ask an agent whether an error has appeared before, and it will search six months of history and post the relevant threads with evidence. You can turn a feature branch into a room where code changes, test results, and merge decisions all live together in one place. The project is written in Rust and uses a protocol called Nostr, which treats every message, reaction, code event, and approval as a signed record in a single log. This means conversations, code, and automated actions all share one search index and one audit trail. Some features work today, including the desktop app, search, git integration, and command-line tooling. Mobile clients, workflow approval gates, and huddles are still being built. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I want to set up a self-hosted team chat where AI agents and humans work together. How do I deploy Buzz on my own server and configure channels with scoped agent tools and personas?
Prompt 2
Help me configure a Buzz channel that ties to a Harbor room so an AI agent is restricted to specific tools like git operations and code review only within that channel.
Prompt 3
Using Buzz's Nostr-based architecture, how can I search across six months of conversation history, code events, and agent actions in one unified index?
Prompt 4
I want to turn a feature branch into a Buzz channel where code changes, test results, and merge decisions are tracked together. How do I set up git integration for this workflow?

Frequently asked questions

What is buzz?

A self-hosted team chat app where humans and AI agents share the same workspace. Agents act as full team members that can write code, review PRs, and search conversation history alongside people.

What language is buzz written in?

Mainly Rust. The stack also includes Rust, Nostr Protocol.

What license does buzz use?

The license is not specified in the available documentation.

How hard is buzz to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is buzz for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.