Onomehud/Airguard-ai

An air surveillance system for Nigeria (eyes in sky) # AirGuard AI AirGuard AI is a Nigeria-focused airspace awareness platform that combines live aircraft tracking, multi-source aviation data, conflict detection, and regulatory/reference context in one dashboard. The project is designed to show how public and commercial aviation feeds can be combined into a practical safety, monitoring, and situational-awareness workflow. ## What It Does - Tracks aircraft across Nigerian airspace using multiple upstream sources. - Combines ADS-B Exchange, OpenSky, adsb.lol, AviationStack, AirLabs, Aviation Edge, FlightRadar24/RapidAPI, and open reference sources when configured. - Detects nearby-aircraft conflict candidates from live position data. - Shows aircraft altitude, speed, heading, callsign, source, and route context where available. - Provides Nigeria airport, runway, navaid, NCAA, FCOP, openAFRICA, and BTS reference links. - Presents a React/Leaflet dashboard with map, analytics, aircraft search, source health, and conflict views. ## Why It Matters Airspace visibility is often fragmented across different feeds, APIs, reference datasets, and regulatory sources. AirGuard AI brings those signals together so users can understand what is happening in Nigerian airspace and which data sources are contributing to the picture. This is a portfolio project, not an operational aviation-control system. It is intended for research, learning, dashboarding, and safety-awareness exploration. ## Architecture - `backend/`: FastAPI service for aircraft aggregation, source health, conflict detection, stats, and reference endpoints. - `frontend/`: React dashboard built with Leaflet, Recharts, Framer Motion, and Lucide icons. - `setup_api_keys.py`: helper script for local API configuration. - `SETUP.md`: setup guide and API source notes. - `SECURITY_POLICY.md`: project security posture and API-key handling policy. ## Data Sources AirGuard AI can use: - OpenSky Network - ADS-B Exchange - adsb.lol - AviationStack - AirLabs - Aviation E …