This repo is in active development. Its full of bugs, incomplete implementation, invalid documentation, and just generally isn't ready for you to fork or test. Star the repo and check back in a few weeks!
SkyFollower is a locally-hosted ADS-B aircraft tracking system. It receives raw 1090 MHz and 978 MHz UAT messages from one or more readsb decoders, routes them through RabbitMQ for processing, enriches each flight with registration and operator data from Redis, evaluates configurable alert rules, archives completed flights as gzipped JSON to AWS S3, and publishes real-time metrics and rule notifications over MQTT (with Home Assistant autodiscovery).
Full documentation: brentio.github.io/SkyFollower
- Getting Started — bring up each host and do a first-time data load
- Deployment — host topology, compose files, components, and configuration reference
- Architecture — pipeline diagram plus scaling processors horizontally
- Rules & Areas — condition types, example
rules.json/areas.json - Data Runners — settings fields for every registration/airport data source
- MQTT Reference — every topic published, including Home Assistant autodiscovery behavior
Run the test suite:
python -m pytestTests live under processor/tests/, receiver/tests/, and shared/tests/.