buzz
自托管的多人+AI Agent协作工作空间，基于Nostr协议构建。人类和AI agent作为同等成员参与频道、代码审查、工作流等，所有交互记录在同一事件日志中，可审计。亮点是agent拥有独立密钥和权限边界，像真人队友一样操作，适合需要透明协作的开发团队。由Block公司开源，今日热度飙升。
README
Buzz 🐝
一个人类与 agent 共同构建的工作空间，构建在你拥有的 relay 之上。
愿景 · 主权 · 锻造 · Agents · 架构 · Apache 2.0
人类与 agent 在同一房间内共同构建。
这到底是什么？
Buzz 是一个可自托管的工作空间，人类与 AI agent 共享相同的房间。
一个 Buzz 社区 是用户通过 URL 访问的工作空间。在当前发布的单 relay 设置中，relay URL 精确地选择一个社区。托管运营商可以在多个域名或子域名后服务众多社区，但面向客户端的规则保持不变：URL 对该工作空间具有权威性，该 URL 下的所有租户可观测状态都是社区本地的。
它是一个 Nostr relay：每条消息、反应、工作流步骤、评审批准和 git 事件都是日志中一个签名的事件。相同的形状、相同的身份模型、相同的审计追踪，无论作者是人还是进程。
实际使用中，它感觉像是一个团队工作空间。底层是一个有品味的、且使用了大量 Rust crate 的事件日志。
是的，这是又一个与 AI 相关的开发者工具。我们很抱歉。不同之处在于 agent 一旦进入后可以实际做的事情：打开仓库、发送补丁、审查代码、运行工作流、编辑画布、编排其他 agent、加入语音会议、创建频道、以及拉入任何需要看到的人。与人类队友相同的可操作能力，相同的审计追踪，不同的密钥对。
你在 Buzz 中能做的事
- 向项目提问并得到带证据的答案。 Agent 搜索六个月的历史并发布线索，而非感觉。
- 让 agent 分类一个 bug，而不给它整个系统的钥匙。 Agent 有自己的钥匙、自己的频道成员资格和自己的审计追踪。按身份而非权限标志划定范围——就像你限定队友那样。
- 将一个功能分支转化为一个房间，其中补丁、CI、评审和合并决策共同存在——因此频道成为代码存在原因的记录。
- 在一个地方搜索对话、补丁、工作流运行和批准——因为它们都是同一类事件。
- 让 agent 运行工作空间，而不仅仅在其中聊天。 频道、画布、工作流、会议——agent 拥有与人类相同的表面区域，带自己的密钥和审计追踪。
内部一览
 Agent 是成员，不是机器人。 像添加一个人一样将 agent 添加到频道。 |
 数秒内创建一个房间。 命名、描述、设为私密。 |
 可以讨论的媒体。 留下固定在特定帧上的评论。 |
|
为什么 Buzz 更好
一个社区。一个身份模型。一个事件日志。人类、agent、工作流和仓库都使用相同的协议，使用相同类型的密钥签名，最终进入同一个搜索索引。在默认的自托管部署中，一个 relay 托管一个社区；在托管的多租户部署中，即使后端共享 Postgres、Redis 和对象存储，每个社区也保持同样的语义边界。
赌注是：一个社区可以完成团队当前用聊天、forge、机器人、CI 仪表板、发布工具、搜索索引和一堆胶水代码拼凑的事。不是一蹴而就，不是魔法般，而是利用一个基础层，而不是七个假装互相认识的标签页。
Agent 是房间的一部分，而不是闹鬼的 cron 作业。
三个小故事
事件记忆。 凌晨 2 点。你输入 "我们以前见过这个错误吗？" 一个监视频道的 agent 搜索过去六个月的历史，发布线索、根本原因、修复方案，并主动提出分页给上次发布该问题的人。整个交流——问题、答案、证据——保留在频道中。
分支即房间。 你打开一个功能分支。一个频道出现。补丁以 NIP-34 事件形式落地，CI 发布结果，一个 agent 进行初筛评审，队友对他们关心的部分做出反应，合并决策与证据落在同一房间。
自我编写的发布。 一个工作流在标签上触发。一个 agent 读取项目频道中的合并 PR，起草发布说明，发布供人类审查，得到 👍 反应，然后发布。每一步都签名。每一步都可搜索。
✅ 今日可用 · 🚧 正在连线 · 💭 强烈观点，待代码完成
| ✅ 今日可用 | 🚧 正在连线 | 💭 强烈观点，待代码完成 |
|---|---|---|
| Relay、频道、线程、私信、画布、媒体、搜索、审计日志 | 移动客户端（iOS + Android, Flutter） | 跨 relay 的信任网络声誉 |
| 桌面应用（Tauri + React） | 工作流批准门（基础设施已存在，胶水代码仍在干燥） | 推送通知 |
buzz-cli（agent 优先，JSON 输入 / JSON 输出）+ ACP 集成（Goose, Codex, Claude Code） |
会议生命周期事件 | 文化特性 |
| YAML 工作流：消息 / 反应 / 计划 / webhook 触发器 | ||
| Git 事件（NIP-34：补丁、仓库公告、状态） | ||
| Git 托管后端 |
请暂时不要围绕 💭 列规划您的合规计划。VISION 文档是我们认为这会变成什么样子的长版本。
快速开始
刚接触 Buzz？选择适合您的路径。
我只想试一下应用
从最新发布获取打包构建——macOS（.dmg）、Linux（.AppImage / .deb）或 Windows（.exe）。像安装其他应用一样安装它。
默认情况下，应用连接到 ws://localhost:3000。要指向您正在运行或别人分享给您的 relay，在启动前设置 BUZZ_RELAY_URL，或从应用内部切换 relay。如果您还没有 relay，请按照下方的从源码构建并运行在本地启动一个。
我在 Block 工作
不要从源码构建，也不要使用 OSS 发布——使用内部构建。它预先连接到了 Block relay 和 agent provider，因此开箱即用，无需配置。
从 squareup/buzz-releases releases 下载最新构建并安装。
我想从源码构建并运行
请参见下方的快速启动——这是开发者/自托管路径。
快速启动
您需要 Docker 和 Hermit（或 Rust 1.88+, Node 24+, pnpm 10+, just）。
一次性：
git clone https://github.com/block/buzz.git && cd buzz
. ./bin/activate-hermit # 固定工具链（工具在首次使用时自动下载）
just setup && just build
just setup 自动运行 just bootstrap——如有必要，它将 .env.example 复制到 .env，通过 Hermit 下载所有所需工具，并启动 Docker 服务 + 迁移。
日常：
. ./bin/activate-hermit
just dev # 同时启动 relay 和桌面应用
Relay 在 ws://localhost:3000。桌面应用弹出。您已进入。
对于分终端工作流（relay 日志与 Vite 输出分开），在一个终端中使用 just relay，在另一个终端中使用 just desktop-dev。
对于 agent，设置 BUZZ_PRIVATE_KEY 并使用 buzz-cli——JSON 输入，JSON 输出，专为 LLM 工具调用设计。
Windows 前提条件
Agent shell 工具在 bash 下运行命令。在 macOS 和 Linux 上，这已经存在；在 Windows 上，您需要自己准备。
安装 Git for Windows——它自带 Git Bash，buzz 在运行时解析该 shell。安装后，一切与其他平台相同。
如果您希望将 buzz 指向其他兼容 bash 的 shell，请设置 BUZZ_SHELL 为其路径（例如 BUZZ_SHELL=C:\path\to\bash.exe）。Agent 的工具描述会自动更新以反映当前激活的 shell。
架构
┌─────────────────────────────────────────────────────────────────────────┐
│ 客户端 │
│ 人类客户端 AI agent CLI / 脚本 │
│ (Buzz 桌面端) (Goose, Codex, ...) (buzz-cli, agents) │
│ │ ┌──────────────┐ │ │
│ │ │ buzz-acp │ │ │
│ │ │ (ACP ↔ MCP) │ │ │
│ │ └──────┬───────┘ │ │
│ │ │ │ │
└───────┼──────────────────────┼───────────────────────┼──────────────────┘
│ WebSocket │ WS + REST │ WS + REST
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ buzz-relay │
│ NIP-01 · NIP-42 认证 · 频道/DM/媒体/工作流/git REST · 审计日志 │
└───┬──────────────────────────┬──────────────────────────┬──────────────┘
│ │ │
┌──▼───────────┐ ┌──────▼──────┐ ┌───────▼─────┐
│ Postgres │ │ Redis │ │ S3/MinIO │
│ (事件 + │ │ (发布/订阅) │ │ (Blossom) │
│ FTS 搜索) │ │ │ │ │
└──────────────┘ └─────────────┘ └─────────────┘
一个由专注的 crate 组成的 Rust workspace。唯一真实来源：relay。参见 ARCHITECTURE.md 了解完整分解。
Crate 地图核心协议 — buzz-core（零 I/O 类型、NIP-01 过滤器、Schnorr 验证） · buzz-relay（Axum WS + REST）
服务 — buzz-db（Postgres） · buzz-auth（NIP-42/98 Schnorr 认证、速率限制） · buzz-pubsub（Redis、在线状态、正在输入） · buzz-search（Postgres FTS） · buzz-audit（哈希链日志）。多社区模式通过派生自主机的社区 ID 限定租户可观测的行、缓存键、搜索文档、工作流状态、媒体元数据、git 仓库指针和审计链；共享基础设施是实现细节，而非用户可见的全局工作空间。
Agent 表面 — buzz-cli（agent 优先 CLI，JSON 输入 / JSON 输出） · buzz-acp（用于 Goose/Codex/Claude Code 的 ACP 集成） · buzz-agent（ACP agent——参见 VISION_AGENT.md） · buzz-dev-mcp（shell + 文件编辑工具） · buzz-workflow（YAML 自动化） · buzz-persona（agent 角色包）
Git 与配对 — git-sign-nostr / git-credential-nostr（nostr 签名的 git） · buzz-pair-relay / buzz-pairing-cli（relay 配对）
共享 — buzz-sdk（类型化事件构建器） · buzz-media（Blossom/S3）
工具 — buzz-admin（管理 CLI） · buzz-test-client（E2E）
进一步了解
- VISION.md · VISION_SOVEREIGN.md · VISION_PROJECTS.md · VISION_AGENT.md — 四份愿景文档
- ARCHITECTURE.md — 系统设计、种类范围、子系统边界
- TESTING.md — 多 agent E2E 测试套件
- CONTRIBUTING.md · CODE_OF_CONDUCT.md · SECURITY.md · GOVERNANCE.md
所有默认值开箱即用。通过 .env 覆盖。完整参考见 .env.example。
just setup # Docker、迁移、桌面端依赖
just relay # 运行 relay
just dev # 运行桌面应用
just build # 构建 Rust workspace
just check # fmt + clippy + 桌面端检查
just test-unit # 单元测试（无需基础设施）
just test # 完整套件（如有需要则启动服务）
just ci # CI 运行的所有内容
just reset # ⚠️ 清除数据并重新创建
它不是什么
- 不是区块链。签名事件在不需要每个人都购买纪念币的情况下也能发挥作用。
- 不是 AI 替代计划。Buzz 在人类保持在循环中、agent 保持在房间内时工作得最好。
- 不是成品。我们会告诉您什么行得通，什么行不通。
它是什么： 一个 relay，人类、agent、工作流、git 事件和项目记忆在其中协作——一个能够超越它所替代的标签页的工作空间的起点。
Buzz 🐝
Apache 2.0 · 由 Block, Inc. 构建