Assembly instructions

block/buzz

A hive mind communication platform

Node.jsRust

Difficulty: Involved
Time: 30 min or more
Stars: ★ 36,737
Activity: Updated this month
License: Apache-2.0
Open issues: 3,773
Got it running: Be the first
Looked up: 3 h ago

Saved setup from 3 h ago

Start here

Setup script in the repo

The maintainers included scripts/setup-desktop-test-data.sh. Run it from the cloned folder after reading it.

bash scripts/setup-desktop-test-data.sh

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

Download for macOS

Buzz Desktop v0.5.28 · 10/9/2026 ↗

Buzz_0.5.28_aarch64.dmg

dmg · Apple Silicon · 115.1 MB · 5,529 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/block/buzz/releases/download/desktop-v0.5.28/Buzz_0.5.28_aarch64.dmg"
open "Buzz_0.5.28_aarch64.dmg"

Other macOS downloads (1)

Buzz_0.5.28_x64.dmg

dmg · Intel · 92.8 MB · 468 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/block/buzz/releases/download/desktop-v0.5.28/Buzz_0.5.28_x64.dmg"
open "Buzz_0.5.28_x64.dmg"

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 17 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js 24.14.1runtime
1×Rust 1.98.1runtime
1×pnpm pnpm@11.4.0package manager
1×PostgreSQL service
1×Redis service

47× settings in .env

BUZZ_IMAGE
BUZZ_DOMAIN
RELAY_URL
BUZZ_MEDIA_BASE_URL
BUZZ_MEDIA_SERVER_DOMAIN
BUZZ_CORS_ORIGINS
BUZZ_REQUIRE_AUTH_TOKENsecret
BUZZ_REQUIRE_RELAY_MEMBERSHIP
BUZZ_ALLOW_NIP_OA_AUTH
BUZZ_AUTO_MIGRATE
BUZZ_GIT_CONFORMANCE_PROBE
BUZZ_PUSH_ENABLED
BUZZ_PUSH_GATEWAY_DELIVERY_URL
RUST_LOG
RELAY_OWNER_PUBKEYsecret
BUZZ_RELAY_PRIVATE_KEYsecret
BUZZ_GIT_HOOK_HMAC_SECRETsecret
POSTGRES_DB
POSTGRES_USER
POSTGRES_PASSWORDsecret
REDIS_PASSWORDsecret
BUZZ_S3_ACCESS_KEYsecret
BUZZ_S3_SECRET_KEYsecret
BUZZ_S3_BUCKET
BUZZ_S3_ADDRESSING_STYLE
BUZZ_HTTP_PORT
CADDY_HTTP_PORT
CADDY_HTTPS_PORT
POSTGRES_PORT
REDIS_PORT
MINIO_API_PORT
MINIO_CONSOLE_PORT
ADMINER_PORT
PROMETHEUS_PORT
DATABASE_URL
PGHOST
PGPORT
PGUSER
PGPASSWORDsecret
PGDATABASE
REDIS_URL
TYPESENSE_API_KEYsecret
TYPESENSE_URL
BUZZ_BIND_ADDR
BUZZ_S3_ENDPOINT
BUZZ_S3_REGION
BUZZ_NIP_FI_UPGRADES_ENABLED

Share this manual

Good to know

Monorepo (workspaces) — install from the repo root.
Cargo workspace — pick a crate with cargo run -p <name>.
Dockerfile available (base image: rust:${RUST_VERSION}-${DEBIAN_VERSION}).
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: admin-web/package.json, benchmarks/harbor-buzz-orchestra/pyproject.toml, benchmarks/harbor-buzz-orchestra/testbed/pyproject.toml, crates/buzz-acp/Cargo.toml and 11 more

package.json scripts (1)

checkpnpm -r check

Files we read (17)

.env.example

.github/workflows/_ci-clients.yml

.github/workflows/_ci-desktop-macos.yml

.github/workflows/_ci-desktop.yml

.github/workflows/_ci-flake.yml

.github/workflows/_ci-relay.yml

.github/workflows/_ci-rust.yml

CONTRIBUTING.md

Cargo.toml

Dockerfile

README.md

deploy/compose/.env.example

docker-compose.yml

mobile/.env.json.example

package.json

pnpm-workspace.yaml

rust-toolchain.toml

Branch main · 6,630 files in the repo

Reading the repo

Opening the box…

Start here

Setup script in the repo

The maintainers included scripts/setup-desktop-test-data.sh. Run it from the cloned folder after reading it.

bash scripts/setup-desktop-test-data.sh

Parts list

1×Node.js 24.14.1runtime

1×Rust 1.98.1runtime

1×pnpm pnpm@11.4.0package manager

1×PostgreSQL service

1×Redis service

47× settings in .env

BUZZ_IMAGE
BUZZ_DOMAIN
RELAY_URL
BUZZ_MEDIA_BASE_URL
BUZZ_MEDIA_SERVER_DOMAIN
BUZZ_CORS_ORIGINS
BUZZ_REQUIRE_AUTH_TOKENsecret
BUZZ_REQUIRE_RELAY_MEMBERSHIP
BUZZ_ALLOW_NIP_OA_AUTH
BUZZ_AUTO_MIGRATE
BUZZ_GIT_CONFORMANCE_PROBE
BUZZ_PUSH_ENABLED
BUZZ_PUSH_GATEWAY_DELIVERY_URL
RUST_LOG
RELAY_OWNER_PUBKEYsecret
BUZZ_RELAY_PRIVATE_KEYsecret
BUZZ_GIT_HOOK_HMAC_SECRETsecret
POSTGRES_DB
POSTGRES_USER
POSTGRES_PASSWORDsecret
REDIS_PASSWORDsecret
BUZZ_S3_ACCESS_KEYsecret
BUZZ_S3_SECRET_KEYsecret
BUZZ_S3_BUCKET
BUZZ_S3_ADDRESSING_STYLE
BUZZ_HTTP_PORT
CADDY_HTTP_PORT
CADDY_HTTPS_PORT
POSTGRES_PORT
REDIS_PORT
MINIO_API_PORT
MINIO_CONSOLE_PORT
ADMINER_PORT
PROMETHEUS_PORT
DATABASE_URL
PGHOST
PGPORT
PGUSER
PGPASSWORDsecret
PGDATABASE
REDIS_URL
TYPESENSE_API_KEYsecret
TYPESENSE_URL
BUZZ_BIND_ADDR
BUZZ_S3_ENDPOINT
BUZZ_S3_REGION
BUZZ_NIP_FI_UPGRADES_ENABLED