BigBrotr

Modular infrastructure for Nostr relay discovery, health monitoring, and event archiving across clearnet and overlay networks.

Docs Blog

Three Pillars

Discovery

Find relays across clearnet, Tor, I2P, and Lokinet. Seed from known sources, discover from NIP-65 events, validate with WebSocket handshakes.

Health Monitoring

Six NIP-66 health tests — RTT, SSL, DNS, geolocation, network reachability, HTTP — plus NIP-11 relay information documents.

Event Archiving

Cursor-based event synchronization from validated relays. Content-addressed metadata deduplication via SHA-256 hashing.

Services

Seeder One-shot bootstrap from seed files and known relay lists.

Finder Discover relay URLs from NIP-65 events and public APIs.

Validator WebSocket handshake test, promotes candidates to relays.

Monitor NIP-11 and NIP-66 health checks with event publishing.

Refresher Orchestrates materialized view refresh on schedule.

Synchronizer Cursor-based event collection from validated relays.

Quick Start

# Clone and start the full stack
git clone https://github.com/BigBrotr/bigbrotr.git
cd bigbrotr/deployments/bigbrotr
docker compose up -d

# Run a single service
python -m bigbrotr seeder --once
python -m bigbrotr finder --log-level DEBUG

Full Quick Start Guide Step-by-step instructions with Docker Compose and configuration.

Explore

Architecture Deep Dive Diamond DAG, package responsibilities, and design principles.

Database Schema Tables, stored functions, and materialized views.

Configuration Guide YAML configs, environment variables, and deployments.

Contributing Development setup, testing, and coding standards.

External

Deck Slide deck presenting BigBrotr's architecture and design.

API Docs Auto-generated Python API reference documentation.