block/buzz

Kết luận: partial · Công nghệ: rust · realtime-communication · collaboration · distributed-systems · multi-agent

block/buzz là một nền tảng giao tiếp kiểu hive mind xây bằng Rust, phù hợp để tham khảo cách tổ chức hệ thống cộng tác thời gian thực và điều phối nhiều tác nhân/người dùng trong một không gian chung. Với ~5.5k sao, đây là dự án đáng assess/trial ở mức ý tưởng và kiến trúc, nhưng mức độ phù hợp phụ thuộc mạnh vào nhu cầu chat/collaboration nội bộ hơn là dùng như thành phần cốt lõi ngay lập tức.

📖 Giới thiệu chi tiết

🧩 Nó là gì?

block/buzz là một workspace tự host nơi con người và AI agents cùng làm việc trong các “phòng” chung. Nói đơn giản: nó giống một không gian làm việc nhóm, nhưng agents không chỉ chat — chúng có thể tham gia xử lý code, workflow, review, tìm kiếm lịch sử và phối hợp như một thành viên thật.

🎯 Giải quyết vấn đề gì? Dành cho ai?

Buzz giải quyết tình trạng công việc kỹ thuật bị rải rác ở quá nhiều nơi: chat một chỗ, code một chỗ, CI một chỗ, review một chỗ, tài liệu và lịch sử quyết định lại ở chỗ khác.

Nó dành cho:

• Nhóm kỹ thuật muốn gom trao đổi, code, workflow, review và lịch sử quyết định vào một không gian chung.
• Người muốn tự host workspace của mình thay vì phụ thuộc hoàn toàn vào dịch vụ bên ngoài.
• Team đang thử nghiệm cách cho AI agents tham gia sâu hơn vào quy trình phát triển phần mềm.
• Developer muốn học kiến trúc Rust cho hệ thống cộng tác thời gian thực.
• Người cần một nền tảng để assess/trial về ý tưởng “humans + agents build together”.

Ý tưởng chính của Buzz là: mọi thứ — tin nhắn, reaction, bước workflow, approval, git event — đều trở thành một sự kiện có chữ ký trong cùng một nhật ký. Nhờ vậy, cả người và agent đều có danh tính riêng, lịch sử riêng và dấu vết kiểm tra rõ ràng.

⚙️ Hoạt động ra sao?

• Relay là trung tâm: Buzz chạy quanh buzz-relay, nơi nhận và phát các sự kiện qua WebSocket / REST.
• Một workspace gọi là community: người dùng truy cập community bằng URL; trong cấu hình mặc định, một relay tương ứng với một community.
• Mọi thứ là event: message, thread, reaction, workflow, approval, git patch, CI status đều được lưu như event.
• Dùng mô hình Nostr relay: Nostr là một giao thức nơi mỗi sự kiện được ký bằng khóa riêng, giúp biết ai tạo ra sự kiện đó và có thể kiểm tra lại.
• Humans và agents dùng cùng một không gian: agent có thể được thêm vào channel giống như thêm một người.
• Agents có danh tính riêng: mỗi agent có key riêng, quyền truy cập riêng và audit trail riêng.
• Dữ liệu được lưu qua nhiều thành phần:
  • Postgres lưu events và hỗ trợ tìm kiếm.
  • Redis dùng cho pub/sub, presence, typing.
  • S3/MinIO dùng cho media.
• Desktop app là giao diện chính: app dùng Tauri + React, kết nối mặc định tới ws://localhost:3000.
• buzz-cli phục vụ agents và scripts: nhận JSON vào, trả JSON ra, phù hợp để tích hợp với LLM tool calls.

Ví dụ dễ hình dung:

• Bạn hỏi: “Lỗi này trước đây gặp chưa?”
• Agent tìm trong lịch sử 6 tháng.
• Agent trả lời kèm link/thread liên quan, nguyên nhân cũ và cách xử lý.
• Toàn bộ câu hỏi, câu trả lời và bằng chứng nằm lại trong channel để sau này tìm tiếp.

🆚 Khi nào nên dùng / không nên

Nên dùng hoặc thử khi:

• Bạn muốn tự host một workspace cho nhóm kỹ thuật.
• Bạn cần nơi để người và AI agents phối hợp trong cùng một luồng công việc.
• Bạn muốn gom chat, workflow, git events, review và audit log vào một nền tảng chung.
• Bạn đang nghiên cứu kiến trúc realtime collaboration bằng Rust.
• Bạn chấp nhận dùng ở mức assess/trial để đánh giá ý tưởng và kiến trúc.

Không nên dùng ngay khi:

• Bạn chỉ cần chat đơn giản như Slack / Discord / Mattermost.
• Bạn cần một sản phẩm thật ổn định, đã hoàn thiện đầy đủ mobile, push notification và toàn bộ tính năng enterprise.
• Bạn không muốn tự vận hành relay, database, Redis hoặc object storage.
• Bạn cần một thành phần lõi cực kỳ ổn định cho production ngay lập tức.
• Team của bạn chưa có nhu cầu rõ ràng cho AI agents tham gia vào workflow.

So sánh ngắn:

• So với Slack / Discord: Buzz không chỉ là chat, mà còn muốn gom agents, workflow, git events và audit trail vào cùng một nền.
• So với GitHub/GitLab: Buzz không thay thế hoàn toàn forge truyền thống, nhưng cố đưa nhánh code, patch, CI, review và quyết định merge vào cùng một “room”.
• So với bot tích hợp rời rạc: agents trong Buzz có danh tính, key và lịch sử riêng, không chỉ là cron job hoặc bot gửi thông báo.

🚀 Bắt đầu nhanh

Bạn cần có:

• Docker
• Hermit

Hoặc tự chuẩn bị:

• Rust 1.88+
• Node 24+
• pnpm 10+
• just

Cài và build lần đầu:

git clone https://github.com/block/buzz.git && cd buzz
. ./bin/activate-hermit
just setup && just build

Chạy hằng ngày:

. ./bin/activate-hermit
just dev

Sau khi chạy:

• Relay ở ws://localhost:3000
• Desktop app sẽ mở lên
• Bạn có thể bắt đầu dùng workspace cục bộ

Nếu muốn tách log relay và app ra hai terminal:

# Terminal 1
. ./bin/activate-hermit
just relay

# Terminal 2
. ./bin/activate-hermit
just desktop-dev

Nếu muốn dùng agent qua CLI:

export BUZZ_PRIVATE_KEY=«bí mật đã ẩn»
buzz-cli

Ví dụ tối thiểu để chạy local từ đầu:

git clone https://github.com/block/buzz.git
cd buzz

. ./bin/activate-hermit
just setup
just build
just dev

Mặc định app kết nối tới:

ws://localhost:3000

Muốn đổi relay trước khi mở app:

export BUZZ_RELAY_URL="ws://localhost:3000"
just dev

Trên Windows, agent shell cần bash. Cách đơn giản là cài Git for Windows vì nó có Git Bash. Nếu muốn dùng bash khác, đặt biến:

BUZZ_SHELL=C:\path\to\bash.exe

✅ Điểm mạnh & ⚠️ Hạn chế

Điểm mạnh:

• Gom con người, AI agents, workflow, git events và audit log vào cùng một mô hình.
• Tự host được, phù hợp với team muốn kiểm soát relay và dữ liệu.
• Viết bằng Rust, kiến trúc chia crate rõ ràng, đáng học hỏi.
• Agents được xem như thành viên thật, có key và audit trail riêng.
• Có desktop app, relay, channels, threads, DMs, canvases, media, search và buzz-cli.
• Hỗ trợ YAML workflows với trigger theo message, reaction, schedule và webhook.
• Có hướng tích hợp git events như NIP-34: patches, repo announcements, status.

Hạn chế:

• Một số phần vẫn đang được nối tiếp như mobile clients, workflow approval gates và huddle lifecycle events.
• Một số ý tưởng còn ở mức định hướng, chưa nên dựa vào cho kế hoạch nghiêm túc.
• Cần tự vận hành nhiều thành phần như relay, Postgres, Redis, S3/MinIO.
• Phù hợp để assess/trial hơn là đưa vào làm thành phần cốt lõi ngay lập tức.
• Giá trị thực tế phụ thuộc mạnh vào việc team có thật sự cần collaboration nội bộ kiểu humans + agents hay không.
• Nếu chỉ cần chat hoặc quản lý repo thông thường, Buzz có thể là quá nhiều so với nhu cầu.