ShadowBroker: Real-Time Geospatial Intelligence Platform

ShadowBroker addresses the challenge of fragmented global telemetry by aggregating over 60 live intelligence feeds into a unified, real-time geospatial dashboard. Designed for analysts, researchers, and power users, it provides a comprehensive, local-first view of public signals—from corporate jets and spy satellites to seismic events and mesh radio networks—enabling previously unseen correlations and offering advanced AI agent integration. The platform's primary benefit is consolidating disparate data sources into a single, auditable interface, enhancing situational awareness without compromising user privacy.

How It Works

Built with Next.js, MapLibre GL, and FastAPI, ShadowBroker operates as a decentralized, real-time, multi-domain OSINT dashboard. It fuses data from numerous public APIs and sources, including ADS-B, AIS, satellite orbital data, seismic sensors, mesh radio networks, and geopolitical event feeds. The core approach emphasizes a self-hosted, local-first architecture, ensuring no user data is collected or transmitted. Data layers are visualized on an interactive map, with features like SAR ground-change detection and AI agent command channels offering novel analytical capabilities.

Quick Start & Requirements

The recommended installation method is via Docker:

1. git clone https://github.com/BigBodyCobain/Shadowbroker.git
2. cd Shadowbroker
3. docker compose pull
4. docker compose up -d Access the dashboard at http://localhost:3000.

Key Requirements:

• Docker Desktop or Docker Engine.
• API Keys: OpenSky Network (critical for global flight data), AIS (aisstream.io), Shodan, Sentinel Hub, and others are optional but enhance specific features.
• For development: Python 3.11 or 3.12 is recommended.

Highlighted Details

• AI Agent Integration: A bidirectional HMAC-SHA256 signed command channel allows AI agents (e.g., OpenClaw, GPT, LangChain) full read/write access to data layers, map control, and mesh participation.
• InfoNet Testnet: An experimental decentralized intelligence mesh offering obfuscated messaging, peer-to-peer Dead Drop exchange, and a Sovereign Shell governance economy. Privacy is not guaranteed.
• Time Machine: Enables playback of historical telemetry data, allowing users to scrub, pause, and replay events with frame interpolation for smooth motion.
• SAR Ground-Change Detection: Utilizes Sentinel-1 and NASA OPERA/Copernicus EGMS data to detect mm-scale ground deformation, flood extent, and vegetation disturbance, even through cloud cover.
• Comprehensive Tracking: Real-time monitoring of aircraft (commercial, private, military), maritime vessels, trains, satellites, and infrastructure like power plants and data centers. Includes unique features like estimated carrier positions via GDELT scraping.
• SIGINT & Radio: Integrates live shortwave radio tuning via KiwiSDR, police/fire scanners, and Meshtastic/APRS mesh networks.

Maintenance & Community

The project actively lists contributors and their specific code contributions, indicating ongoing development and community involvement. Direct links to community platforms like Discord or Slack are not provided in the README.

Licensing & Compatibility

The project is licensed for "educational and personal research purposes." Data usage is subject to the terms of service of the individual API providers. It runs locally or self-hosted, offering compatibility with Docker and Kubernetes via Helm charts.

Limitations & Caveats

The InfoNet decentralized layer is explicitly labeled an "experimental testnet" with "No Privacy Guarantee," as channels are obfuscated but not end-to-end encrypted, and radio transmissions are inherently public. Several key features, particularly global flight tracking, are critically dependent on obtaining and configuring external API keys. Carrier positions are OSINT-based estimates, not direct telemetry.