Buzz C4 Architecture Diagrams (SVG)

Updated Aug 13, 2026 - No external dependencies (pure inline SVG)

Level 1 - System Context

Context Diagram
Shows Buzz as a whole system and its relationships with external actors and systems.
Human Teammate[Person]Developer usingBuzz desktop client AI Agent[Person]LLM-powered agentvia buzz-cli or ACP Buzz Workspace[Software System]Self-hostable Nostr relay.Signed events, shared audit,same identity model forhumans and agents Git Repositories[External]NIP-34 git events LLM Provider[External]OpenAI, Anthropic, local Webhook Targets[External]HTTP workflow endpoints WebSocket (desktop) buzz-cli / ACP git events calls via ACP webhooks
Source: github.com/block/buzz

Level 2 - Container Diagram

Container Diagram
Shows the internal containers (deployable units) that make up Buzz.
Buzz Workspace Humandesktop client AI Agentbuzz-cli / ACP buzz-relayRust / AxumWebSocket + REST relay.12-step event pipeline. Buzz DesktopTauri+ReactChannels, threads, DMs buzz-cliRust CLIJSON in/out buzz-acpRust binaryACP bridge, @mentions buzz-agentRust binary8 sessions, MCP tools buzz-dev-mcpRust binaryShell + file editor buzz-workflowRust engineYAML automation PostgresPostgreSQL 17Events, channels, FTS RedisRedis 7Pub/sub, presence S3 / MinIOObject StorageBlossom media LLM Provider[External]OpenAI / Anthropic Git Remote[External]Git smart HTTP WebSocket WS+REST sqlx relays uses API MCP @mention pub/sub media triggered LLM
Source: github.com/block/buzz ARCHITECTURE.md

Crate Map

Rust Monorepo Crate Dependencies
buzz-coreZero I/O foundation buzz-relayAxum WS+REST buzz-dbPostgres buzz-authNIP-42/98 buzz-pubsubRedis buzz-searchFTS GIN buzz-audithash-chain buzz-workflowYAML engine buzz-acpACP bridge buzz-cliJSON I/O buzz-agent8 sessions buzz-dev-mcpMCP shell buzz-sdkNostr builders buzz-mediaBlossom S3
Source: github.com/block/buzz Cargo.toml

Event Processing Pipeline

12-Step Event Pipeline
Every incoming WebSocket EVENT runs through this pipeline. Steps 10-12 (green) are fire-and-forget.
EVENT received 1. AUTH CHECKAuthenticated? 2. PUBKEY MATCHpubkey == auth? 3. KIND_AUTH REJECTkind 22242 reject 4. EPHEMERAL?kind 20000-29999 Ephemeral pathpresence/typing 5. VERIFYSchnorr sig + SHA-256 6. MEMBERSHIPchannel access 7. DB INSERTON CONFLICT NOTHING 8. REDIS PUBLISHchannel fan-out 9. FAN-OUTsub_registry 10. SEARCH INDEXworker queue 11. AUDIT LOGspawned async 12. WORKFLOWspawned async OK sent to client yesno
Source: github.com/block/buzz ARCHITECTURE.md. Green = fire-and-forget.
SVG diagrams by Loup - Aug 13, 2026 - No external dependencies