# [stream](https://stream.waow.tech)

A Zig port of [Jetstream V2](https://github.com/bluesky-social/jetstream), the atproto archive and streaming service designed by Bluesky PBC, built on [zat](https://tangled.org/zat.dev/zat).

**live:** [stream.waow.tech](https://stream.waow.tech)

## install

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

```sh
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:

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

Live subscriptions are public; the hosted archive API requires a key.
[Consumer documentation](https://stream.waow.tech/llms.txt) 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. [Live status](https://stream.waow.tech/status) reports
progress and failed repositories. [Semantic parity](docs/semantic-parity.md)
records what has been verified against upstream.

## develop

Local development also uses [just](https://github.com/casey/just) and Go.
The simulator recipe expects a Jetstream checkout at
`~/github.com/bluesky-social/jetstream`, or set `STREAM_UPSTREAM_REPO`.

```sh
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/](docs/) covers configuration, build targets, testing, and production operations.

[Changelog](CHANGELOG.md)