====== Buzz ======

//Vytvořeno: **25.7.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/block/buzz|Buzz]] je open-source a self-hostovaný workspace, ve kterém spolu komunikují lidé, AI agenti, automatizace i nástroje pro vývoj. Cílem je sjednotit týmovou komunikaci, kontext projektu, práci agentů a auditní stopu do jednoho prostředí provozovaného na vlastním relay serveru.

===== Co Buzz řeší =====

Běžná práce s AI agenty bývá rozdělená mezi chat, issue tracker, git forge, CI a samostatné automatizace. Buzz se snaží tyto souvislosti sdílet v kanálu projektu: diskuse, patch, výsledek workflow, review i rozhodnutí o merge mají zůstat na jednom místě a být dohledatelné.

Agent zde není jen bot s jedním globálním API tokenem. Má vlastní kryptografickou identitu, členství v kanálech a samostatnou auditní stopu. Lze jej přidat do místnosti stejně jako člověka a omezit mu přístup na konkrétní kontext.

===== Princip fungování =====

Buzz používá [[https://github.com/nostr-protocol/nips/blob/master/01.md|Nostr NIP-01]] jako formát podepsaných událostí. Zpráva, reakce, změna kanálu nebo krok workflow jsou události opatřené veřejným klíčem autora a Schnorr podpisem. Podpis ověřuje autorství a neměnnost události; sám o sobě ale nezajišťuje důvěrnost obsahu.

V základním self-hostovaném nasazení je jeden relay zdrojem pravdy pro jednu komunitu. Nejde o peer-to-peer síť s replikací mezi relayi: klienti, agenti a CLI se připojují k relayi přes WebSocket nebo REST API. Relay ověřuje podpisy a přístup do kanálů, ukládá data a rozesílá nové události odběratelům.

==== Architektura ====

Podle [[https://github.com/block/buzz/blob/main/ARCHITECTURE.md|architektury projektu]] tvoří jádro Rust relay. Data událostí a fulltextové vyhledávání jsou v PostgreSQL, Redis zajišťuje realtime pub/sub, presence a indikaci psaní a média ukládá S3-kompatibilní úložiště, například MinIO.

Pro práci s agenty obsahuje projekt několik vrstev:

  * ''buzz-cli'' je CLI s JSON vstupem a výstupem vhodné pro volání z agenta nebo skriptu.
  * ''buzz-acp'' propojuje relay s coding agenty přes Agent Communication Protocol (ACP).
  * ''buzz-agent'' je vlastní ACP agent, který může používat MCP servery.
  * ''buzz-workflow'' definuje automatizace v YAML s triggery na zprávy, reakce, plán nebo webhook.

===== Praktické použití =====

Buzz dává smysl hlavně pro malý vývojový tým nebo vlastní agentní laboratoř, kde je potřeba zachovat kontext a kontrolu nad autonomními kroky.

  * **Incidenty:** agent může prohledat historii kanálu, dohledat předchozí řešení a vrátit odkazy na zdrojové diskuse.
  * **Feature branch jako místnost:** kanál může držet diskusi k funkci, související patche, výsledky CI a review.
  * **Řízené workflow:** automatizace může reagovat na událost, poslat zprávu, přidat reakci, zavolat webhook nebo vyžádat schválení člověkem.
  * **Oddělení identit agentů:** různí agenti mohou mít rozdílné klíče, členství a oprávnění, místo aby sdíleli jedinou identitu.

===== Self-hosting =====

Pro lokální vývoj projekt vyžaduje Docker a Hermit, případně odpovídající Rust, Node.js, pnpm a ''just''. Produkční Compose konfigurace počítá s PostgreSQL, Redis, MinIO a volitelně Caddy pro TLS.

<code bash>
git clone https://github.com/block/buzz.git
cd buzz
. ./bin/activate-hermit
just setup && just build
just dev
</code>

Výchozí relay pak běží na ''ws%%://%%localhost:3000''. Projekt nabízí také desktopové klienty pro macOS, Linux a Windows.

===== Stav projektu a omezení =====

Buzz je aktivně vyvíjený prototyp, nikoli hotová náhrada Slacku, GitHubu a CI. Projekt otevřeně rozlišuje hotové a rozpracované části.

  * Relay, kanály, vlákna, přímé zprávy, canvas, média, hledání a auditní log patří mezi dostupné funkce.
  * Git hosting, některé workflow funkce, push notifikace a další části jsou stále rozpracované.
  * Dokumentovaná architektura uvádí, že rate limiting zatím není implementovaný. Relay proto není vhodné bez dalšího zabezpečení přímo vystavit do internetu.
  * Workflow approval gates nejsou zapojené end-to-end; akce ''send_dm'' a ''set_channel_topic'' jsou ve workflow schématu, ale aktuálně nejsou implementované.

Pro osobní používání může být provozní složitost vyšší než přínos. Přínos roste tam, kde spolu soustavně pracuje více lidí a agentů a kde má hodnotu dohledatelná historie jejich rozhodnutí a akcí.

===== Zdroje =====

  * [[https://github.com/block/buzz|Block – Buzz: zdrojový kód a README]]
  * [[https://github.com/block/buzz/blob/main/ARCHITECTURE.md|Buzz – Architecture]]
  * [[https://github.com/block/buzz/blob/main/VISION_AGENT.md|Buzz – Agent architecture]]
  * [[https://github.com/nostr-protocol/nips/blob/master/01.md|Nostr NIP-01 – Basic protocol flow]]