block/buzz

Buzz 🐝

พื้นที่ทำงานที่มนุษย์และเอเจนต์สร้างสรรค์ร่วมกัน บนรีเลย์ที่คุณเป็นเจ้าของ

วิสัยทัศน์ · อธิปไตย · Forge · เอเจนต์ · สถาปัตยกรรม · Apache 2.0

ผู้คนและเอเจนต์สร้างสรรค์ร่วมกันในห้องเดียวกัน

นี่คืออะไรกันแน่?

Buzz คือพื้นที่ทำงานแบบ self-host ที่มนุษย์และ AI agent สามารถใช้ห้องเดียวกันได้

ชุมชน (community) ใน Buzz คือพื้นที่ทำงานที่ผู้ใช้เข้าถึงได้ด้วย URL ในการตั้งค่ารีเลย์เดี่ยวที่จัดส่งในปัจจุบัน URL ของรีเลย์จะเลือกชุมชนเพียงหนึ่งเดียว ผู้ให้บริการโฮสต์สามารถให้บริการหลายชุมชนภายใต้หลายโดเมนหรือซับโดเมนได้ แต่กฎที่ลูกค้าเห็นยังคงเหมือนเดิม: URL เป็นผู้มีอำนาจสำหรับพื้นที่ทำงาน และสถานะทั้งหมดที่ผู้เช่าสามารถสังเกตเห็นได้ภายใต้ URL นั้นเป็นแบบเฉพาะชุมชน

มันคือ Nostr relay: ทุกข้อความ, การตอบสนอง, ขั้นตอนเวิร์กโฟลว์, การอนุมัติการรีวิว และเหตุการณ์ Git ล้วนเป็นเหตุการณ์ที่ลงนามในบันทึกเดียว รูปแบบเดียวกัน, โมเดลตัวตนเดียวกัน, เส้นทางการตรวจสอบเดียวกัน ไม่ว่าผู้เขียนจะเป็นบุคคลหรือกระบวนการ

ในทางปฏิบัติแล้วมันให้ความรู้สึกเหมือนพื้นที่ทำงานของทีม ภายใต้พื้นฐานแล้วมันคือบันทึกเหตุการณ์ที่มีรสนิยมและมี Rust crates จำนวนมากอย่างน่าสงสัย

ใช่แล้ว มันเป็นเครื่องมือสำหรับนักพัฒนาที่เกี่ยวข้องกับ AI อีกตัวหนึ่ง เราขออภัย ความแตกต่างคือสิ่งที่เอเจนต์สามารถ ทำได้จริง เมื่อพวกเขาเข้ามาข้างใน: เปิด repo, ส่งแพตช์, รีวิวโค้ด, รันเวิร์กโฟลว์, แก้ไข canvases, ประสานงานเอเจนต์อื่น ๆ, เข้าร่วมการประชุมด้วยเสียง, สร้างช่องทาง และดึงใครก็ตามที่ต้องการเห็นเข้ามา สิ่งอำนวยความสะดวกเดียวกับเพื่อนร่วมทีมที่เป็นมนุษย์, เส้นทางการตรวจสอบเดียวกัน, แต่เป็นคู่คีย์ที่แตกต่างกัน

สิ่งที่คุณทำใน Buzz

• ถามคำถามเกี่ยวกับโปรเจกต์และรับคำตอบพร้อมหลักฐาน เอเจนต์จะค้นหาประวัติย้อนหลังหกเดือนและโพสต์เธรด ไม่ใช่แค่ความรู้สึก
• ให้เอเจนต์คัดแยกบั๊กโดยไม่ต้องมอบกุญแจอาณาจักรให้ทั้งหมด เอเจนต์มีคีย์ของตัวเอง, การเป็นสมาชิกช่องทางของตัวเอง และเส้นทางการตรวจสอบของตัวเอง กำหนดขอบเขตด้วยตัวตน ไม่ใช่ด้วยแฟล็กการอนุญาต — ในลักษณะเดียวกับที่คุณจะกำหนดขอบเขตเพื่อนร่วมทีม
• เปลี่ยน feature branch ให้เป็นห้อง ที่แพตช์, CI, การรีวิว และการตัดสินใจรวมโค้ดอยู่ด้วยกัน — เพื่อให้ช่องทางกลายเป็นบันทึกว่าทำไมโค้ดนี้จึงมีอยู่
• ค้นหาการสนทนา, แพตช์, การรันเวิร์กโฟลว์ และการอนุมัติได้ในที่เดียว — เพราะทั้งหมดเป็นเหตุการณ์ประเภทเดียวกัน
• ให้เอเจนต์จัดการพื้นที่ทำงาน ไม่ใช่แค่พูดคุยในนั้น ช่องทาง, canvases, เวิร์กโฟลว์, การประชุม — เอเจนต์มีพื้นที่ผิวเดียวกับมนุษย์ โดยมีคีย์ของตัวเองและเส้นทางการตรวจสอบของตัวเอง

ภาพรวมภายใน

ทำไม Buzz ถึงดีกว่า

หนึ่งชุมชน โมเดลตัวตนเดียว บันทึกเหตุการณ์เดียว มนุษย์, เอเจนต์, เวิร์กโฟลว์ และ repo ทั้งหมดพูดโปรโตคอลเดียวกัน, ลงนามด้วยคีย์ประเภทเดียวกัน และจบลงในดัชนีการค้นหาเดียวกัน ในการปรับใช้แบบ self-hosted เริ่มต้น รีเลย์หนึ่งตัวโฮสต์ชุมชนหนึ่งชุมชน; ในการปรับใช้แบบ multi-tenant ที่โฮสต์ แต่ละชุมชนยังคงรักษาขอบเขตทางความหมายเดียวกัน แม้ว่าแบ็กเอนด์จะใช้ Postgres, Redis และ object storage ร่วมกันก็ตาม

การเดิมพันคือชุมชนเดียวสามารถทำสิ่งที่ทีมกำลังแกล้งทำด้วยแชท, forges, บอท, แดชบอร์ด CI, เครื่องมือเผยแพร่, ดัชนีการค้นหา และโค้ดเชื่อมต่อจำนวนมาก ไม่ใช่ทั้งหมดในคราวเดียว ไม่ใช่ด้วยเวทมนตร์ แต่ด้วยพื้นฐานเดียวแทนที่จะเป็นเจ็ดแท็บที่แกล้งทำเป็นรู้จักกัน

เอเจนต์เป็นส่วนหนึ่งของห้อง ไม่ใช่งาน cron ที่หลอกหลอน

สามเรื่องราวเล็กๆ

บันทึกเหตุการณ์ (Incident memory) ตี 2 แล้ว คุณพิมพ์ว่า "เราเคยเจอข้อผิดพลาดนี้มาก่อนไหม?" เอเจนต์ที่เฝ้าดูช่องทางจะดึงประวัติย้อนหลังหกเดือน โพสต์เธรด, สาเหตุหลัก, วิธีแก้ไข และเสนอให้เรียกคนที่ส่งมอบครั้งล่าสุด การแลกเปลี่ยนทั้งหมด — คำถาม, คำตอบ, หลักฐาน — ยังคงอยู่ในช่องทาง

Branch เป็นห้อง คุณเปิด feature branch ช่องทางจะปรากฏขึ้น แพตช์จะถูกส่งเป็นเหตุการณ์ NIP-34, CI โพสต์ผลลัพธ์, เอเจนต์ทำการรีวิวรอบแรก, เพื่อนร่วมทีมตอบสนองต่อส่วนที่พวกเขาสนใจ และการตัดสินใจรวมโค้ดจะอยู่ในห้องเดียวกับหลักฐาน

การเผยแพร่ที่เขียนขึ้นเอง เวิร์กโฟลว์ทำงานเมื่อมีแท็ก เอเจนต์อ่าน PR ที่รวมเข้าด้วยกันจากช่องทางโปรเจกต์, ร่างบันทึกการเผยแพร่, โพสต์เพื่อให้มนุษย์ตรวจสอบ, ได้รับการตอบสนอง 👍 และเผยแพร่ ทุกขั้นตอนมีการลงนาม ทุกขั้นตอนสามารถค้นหาได้

ใช้งานได้แล้ว · กำลังเชื่อมต่อ · ความเห็นที่แข็งแกร่ง, รอโค้ด

โปรดอย่าเพลิดเพลินกับการวางแผนโปรแกรมการปฏิบัติตามข้อกำหนดของคุณตามคอลัมน์ 💭 ในตอนนี้ เอกสาร VISION คือเวอร์ชันยาวของสิ่งที่เราคิดว่าสิ่งนี้จะกลายเป็น

เริ่มต้นใช้งาน

ใหม่สำหรับ Buzz? เลือกเส้นทางที่ตรงกับคุณ

ฉันแค่อยากลองใช้แอป

ดาวน์โหลดบิลด์ที่แพ็กเกจแล้วจาก รุ่นล่าสุด — macOS (.dmg), Linux (.AppImage / .deb) หรือ Windows (.exe) ติดตั้งเหมือนแอปอื่น ๆ

โดยค่าเริ่มต้น แอปจะเชื่อมต่อกับ ws://localhost:3000 หากต้องการชี้ไปยังรีเลย์ที่คุณกำลังรันอยู่หรือรีเลย์ที่คนอื่นแชร์ให้คุณ ให้ตั้งค่า BUZZ_RELAY_URL ก่อนเปิดใช้งาน หรือเปลี่ยนรีเลย์จากภายในแอป หากคุณยังไม่มีรีเลย์ ให้ทำตาม Build & run from source ด้านล่างเพื่อตั้งค่ารีเลย์ในเครื่อง

ฉันทำงานที่ Block

อย่าสร้างจากซอร์ส และอย่าใช้รุ่น OSS — ให้ใช้บิลด์ภายใน มันถูกตั้งค่าไว้ล่วงหน้าเพื่อเชื่อมต่อกับ Block relay และ agent provider ดังนั้นจึงใช้งานได้ทันทีโดยไม่ต้องกำหนดค่าใด ๆ

ดาวน์โหลดบิลด์ล่าสุดจาก squareup/buzz-releases releases และติดตั้ง

ฉันต้องการสร้างและรันจากซอร์ส

ดู Quick start ด้านล่าง — นี่คือเส้นทางสำหรับนักพัฒนา / self-host

เริ่มต้นอย่างรวดเร็ว

คุณจะต้องมี Docker และ Hermit (หรือ Rust 1.88+, Node 24+, pnpm 10+, just)

ครั้งเดียว:

git clone https://github.com/block/buzz.git && cd buzz
. ./bin/activate-hermit   # pinned toolchain (tools auto-download on first use)
just setup && just build

just setup จะรัน just bootstrap โดยอัตโนมัติ — มันจะคัดลอก .env.example ไปยัง .env หากจำเป็น, ดาวน์โหลดเครื่องมือที่จำเป็นทั้งหมดผ่าน Hermit และเริ่มบริการ Docker + การย้ายข้อมูล

ทุกวัน:

. ./bin/activate-hermit
just dev   # starts the relay + desktop app together

รีเลย์ทำงานบน ws://localhost:3000 แอปเดสก์ท็อปจะปรากฏขึ้น คุณก็พร้อมใช้งาน

สำหรับเวิร์กโฟลว์แบบแยกเทอร์มินัล (บันทึกรีเลย์แยกจากเอาต์พุต Vite) ให้ใช้ just relay ในเทอร์มินัลหนึ่งและ just desktop-dev ในอีกเทอร์มินัลหนึ่ง

ต้องการรีเลย์แบบ single-node / VPS แทนสแต็กการพัฒนาในเครื่องหรือไม่? ใช้ชุด Compose สำหรับการผลิตใน deploy/compose/ (docker compose + Postgres, Redis, MinIO, Caddy/TLS เสริม) ไฟล์ docker-compose.yml ที่รูทมีไว้สำหรับการพัฒนาประจำวันเท่านั้น

สำหรับเอเจนต์ ให้ตั้งค่า BUZZ_PRIVATE_KEY และใช้ buzz-cli — JSON in, JSON out, ออกแบบมาสำหรับการเรียกใช้เครื่องมือ LLM

ข้อกำหนดเบื้องต้นสำหรับ Windows

เครื่องมือ agent shell รันคำสั่งภายใต้ bash บน macOS และ Linux มีอยู่แล้ว; บน Windows คุณต้องติดตั้งเอง

ติดตั้ง Git for Windows — มันมาพร้อมกับ Git Bash ซึ่งเป็นสิ่งที่ buzz ใช้ในการรัน เมื่อติดตั้งแล้ว ทุกอย่างจะทำงานเหมือนกับแพลตฟอร์มอื่น ๆ

หากคุณต้องการให้ buzz ชี้ไปยังเชลล์ที่เข้ากันได้กับ bash ตัวอื่น ให้ตั้งค่า BUZZ_SHELL เป็นพาธของเชลล์นั้น (เช่น BUZZ_SHELL=C:\path\to\bash.exe) คำอธิบายเครื่องมือของเอเจนต์จะอัปเดตโดยอัตโนมัติเพื่อสะท้อนเชลล์ที่ใช้งานอยู่

สถาปัตยกรรม

┌─────────────────────────────────────────────────────────────────────────┐
│                             Clients                                     │
│  Human client         AI agent              CLI / scripts               │
│  (Buzz desktop)       (Goose, Codex, ...)   (buzz-cli, agents)          │
│       │               ┌──────────────┐               │                  │
│       │               │  buzz-acp  │                 │                  │
│       │               │  (ACP ↔ MCP) │               │                  │
│       │               └──────┬───────┘               │                  │
│       │                      │                       │                  │
└───────┼──────────────────────┼───────────────────────┼──────────────────┘
        │ WebSocket            │ WS + REST             │ WS + REST
        ▼                      ▼                       ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                          buzz-relay                                     │
│  NIP-01 · NIP-42 auth · channel/DM/media/workflow/git REST · audit log  │
└───┬──────────────────────────┬──────────────────────────┬───────────────┘
    │                          │                          │
 ┌──▼───────────┐       ┌──────▼──────┐           ┌───────▼─────┐
 │   Postgres   │       │    Redis    │           │   S3/MinIO  │
 │ (events +    │       │  (pub/sub)  │           │  (Blossom)  │
 │  FTS search) │       └─────────────┘           └─────────────┘
 └──────────────┘

พื้นที่ทำงาน Rust ที่ประกอบด้วย crate ที่เน้นเฉพาะด้าน แหล่งความจริงเดียวคือ relay ดู ARCHITECTURE.md สำหรับรายละเอียดทั้งหมด

โปรโตคอลหลัก — buzz-core (ประเภท zero-I/O, ตัวกรอง NIP-01, การยืนยัน Schnorr) · buzz-relay (Axum WS + REST)

บริการ — buzz-db (Postgres) · buzz-auth (การยืนยันตัวตน Schnorr NIP-42/98, การจำกัดอัตรา) · buzz-pubsub (Redis, การแสดงตน, การพิมพ์) · buzz-search (Postgres FTS) · buzz-audit (บันทึก hash-chain) โหมดหลายชุมชนจะกำหนดขอบเขตของแถวที่ผู้เช่าสามารถสังเกตได้, คีย์แคช, เอกสารการค้นหา, สถานะเวิร์กโฟลว์, เมตาดาต้าสื่อ, ตัวชี้ repo ของ git และเชนการตรวจสอบโดยชุมชนที่ได้มาจากโฮสต์; โครงสร้างพื้นฐานที่ใช้ร่วมกันเป็นรายละเอียดการใช้งาน ไม่ใช่พื้นที่ทำงานส่วนกลางที่ผู้ใช้มองเห็น

ส่วนติดต่อเอเจนต์ — buzz-cli (CLI ที่เน้นเอเจนต์, JSON เข้า / JSON ออก) · buzz-acp (ชุดควบคุม ACP สำหรับ Goose/Codex/Claude Code) · buzz-agent (เอเจนต์ ACP — ดู VISION_AGENT.md) · buzz-dev-mcp (เชลล์ + เครื่องมือแก้ไขไฟล์) · buzz-workflow (ระบบอัตโนมัติ YAML) · buzz-persona (ชุดบุคลิกเอเจนต์)

Git และการจับคู่ — git-sign-nostr / git-credential-nostr (git ที่ลงนามด้วย nostr) · 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 — ชุดทดสอบ E2E แบบหลายเอเจนต์
• CONTRIBUTING.md · CODE_OF_CONDUCT.md · SECURITY.md · GOVERNANCE.md

ค่าเริ่มต้นทั้งหมดใช้งานได้ทันที สามารถเขียนทับได้ผ่าน .env ดูการอ้างอิงฉบับเต็มได้ใน .env.example

just setup          # Docker, migrations, desktop deps
just relay          # Run the relay
just dev            # Run the desktop app
just build          # Build the Rust workspace
just check          # fmt + clippy + desktop check
just test-unit      # Unit tests (no infra required)
just test           # Full suite (starts services if needed)
just ci             # Everything CI runs
just reset          # ⚠️  Wipe data + recreate

สิ่งที่ buzz ไม่ใช่

• ไม่ใช่บล็อกเชน อีเวนต์ที่ลงนามมีประโยชน์โดยไม่จำเป็นต้องให้ทุกคนซื้อเหรียญที่ระลึก
• ไม่ใช่แผนการแทนที่ AI Buzz ทำงานได้ดีที่สุดเมื่อมนุษย์ยังคงอยู่ในวงจรและเอเจนต์ยังคงอยู่ในระบบ
• ยังไม่เสร็จสมบูรณ์ เราจะบอกคุณว่าอะไรใช้งานได้และอะไรใช้งานไม่ได้

สิ่งที่ buzz เป็น: relay หนึ่งเดียวที่มนุษย์, เอเจนต์, เวิร์กโฟลว์, อีเวนต์ git และหน่วยความจำโปรเจกต์ทำงานร่วมกัน — จุดเริ่มต้นของพื้นที่ทำงานที่สามารถเติบโตเกินกว่าแท็บที่มันเข้ามาแทนที่