Deploy Now

Stars

1,390

Forks

263

Watchers

33

Indigo

Indigo is Bluesky's Go toolkit for building services on the AT Protocol, and operators reach for it when they need to follow the whole network: run a relay that subscribes to many personal data servers and republishes one combined firehose, split that firehose for many subscribers, or filter it down to the accounts and record types a single application actually cares about. The relay holds upstream host and account state in PostgreSQL, verifies repository integrity and identity signatures, exposes an admin web interface for configuring limits and adding upstream hosts, and emits Prometheus metrics and tracing for production monitoring. Rainbow consumes a relay or PDS firehose and fans events out to large numbers of subscribers, buffering recent history on local disk so late joiners receive the events they missed. Tap handles verification, automatic backfilling of repository history, and filtered delivery by account list or record collection, sending simple JSON events to applications over WebSocket or webhook instead of requiring each developer to parse cryptographic repository formats. Hepa consumes the relay firehose and applies moderation rules to accounts and records, pushing labels into an existing moderation service for teams that operate their own trust and safety pipeline. Each service ships as a single Go binary with Docker packaging, and shared packages provide the client, identity, lexicon, and repository data structures the services are built from. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT and Apache-2.0 licensed.

Indigo

Benefits

  • One Firehose For The Network
  • The relay subscribes to many personal data servers and republishes a single combined event stream, so downstream services follow the whole network from one connection instead of polling hundreds of hosts.
  • Verified Repository Data By Default
  • Repository structure, Merkle Search Tree integrity, and identity signatures are checked before events reach applications, removing the need for every developer to reimplement cryptographic verification of the firehose.
  • Filtered Delivery For Applications
  • Tap filters the stream by account list or record collection and backfills full repository history automatically, delivering ordered JSON events over WebSocket or webhook to applications at moderate scale.
  • Moderation And Fan-Out Tooling Included
  • Hepa applies moderation rules to firehose content and pushes labels into an existing moderation service, and Rainbow buffers and redistributes events for large numbers of subscribers from a single binary.

Features

  • Reference Relay Implementation
  • Subscribes to upstream PDS hosts, verifies repository integrity and identity signatures, stores host and account state in PostgreSQL, and exposes the core atproto sync API endpoints including the firehose WebSocket.
  • Admin Web Interface
  • The relay ships a browser dashboard for configuring limits, adding upstream PDS instances, and managing hosts, alongside Prometheus metrics, OpenTelemetry traces, and verbose structured logging for operations.
  • Rainbow Firehose Fanout
  • Consumes a relay or PDS firehose, retains a backfill window on local disk, and serves the subscribeRepos WebSocket endpoint to many downstream subscribers without validating events itself.
  • Tap Sync Utility
  • Handles firehose connection, verification, automatic backfill, and filtering by DID list or collection, delivering simple ordered JSON events to applications by WebSocket with acknowledgements or by webhook.
  • Hepa Moderation Daemon
  • Consumes the relay firehose, caches account metadata in Redis, applies compile-time moderation rules, and pushes labels into an existing moderation service such as Ozone.
  • Shared Protocol Packages
  • Reusable Go packages provide the HTTP API client, DID and handle resolution, lexicon schema validation, repository and Merkle Search Tree data structures, and cryptographic signing primitives.

Apps Similar to Indigo