stream #

A Zig port of Jetstream V2, the atproto archive and streaming service designed by Bluesky PBC, built on zat.

live: stream.waow.tech

install #

Requires Zig 0.17.1. Native dependencies are pinned and built from source.

git clone https://tangled.org/zat.dev/stream
cd stream
zig build

use #

Connect a Jetstream client to the public JSON WebSocket, optionally filtering by collection:

wss://stream.waow.tech/subscribe?wantedCollections=app.bsky.feed.post

Live subscriptions are public; the hosted archive API requires a key. Consumer documentation covers access, endpoints, filters, and replay cursors.

The archive combines an initial repository backfill with ongoing relay events. Coverage depends on what relays and PDSes provide; it is not a complete history of every account or event. The archive is compacted: superseded and deleted records are removed; delete, account, identity, and sync markers are retained. Live status reports progress and failed repositories. Semantic parity records what has been verified against upstream.

develop #

Local development also uses just and Go. The simulator recipe expects a Jetstream checkout at ~/github.com/bluesky-social/jetstream, or set STREAM_UPSTREAM_REPO.

zig build test && zig build   # test and build
just simulator               # start the local fake network
just run-sim                 # run Stream against it, in another terminal

docs #

docs/ covers configuration, build targets, testing, and production operations.

Changelog