Project Codex: Distributed SDR Intelligence Network

1. Executive Summary

Project Codex is a distributed radio monitoring system that evolves traditional scanning into Real-Time Intelligence. Instead of just listening to audio streams, Codex uses AI to transcribe, analyze, and map public safety radio traffic. It turns a chaotic stream of "Police Radio" into a clean, map-based view of Active Incidents (Fires, Accidents, Chases).

2. The Core Workflow

Listen: Distributed Edge Nodes (Raspberry Pis) monitor local frequencies using Software Defined Radios (SDR).
Stream: Audio is sent to a central server; Metadata is sent via MQTT.
Analyze: A central Intelligence Engine transcribes the audio and uses LLMs to understand the context.
Correlate: The system groups related radio calls (even from different departments) into unified Incidents.
Visualize: Users view a Live Map showing active incidents, not just radio towers.

3. Key Components

A. The "Reverse-C2" Control Plane

Edge nodes sit behind firewalls and "phone home" to a central C2 server via MQTT. This allows for centralized management, configuration updates, and health monitoring without complex VPNs.

B. The Intelligence Layer (Global Knowledge)

This is the brain of the operation. It possesses Global Knowledge of all connected nodes.

Incident Tracking: It detects when a new incident starts and tracks it until units clear the scene.
Multi-System Fusion: If the Police radio and Fire radio both mention the same address, the system recognizes it as one single event.
Entity Extraction: Automatically pulls unit numbers, street addresses, and incident types from the voice audio.

C. The Web Interface

A Next.js application that provides:

Live Map: A tactical view of what is happening now. Icons appear for active calls and vanish/dim when cleared.
Incident Archives: Detailed pages for every event, showing a timeline of the radio traffic, unit movements, and AI-generated summaries.
Fleet Management: Admin tools to tune radios and manage the edge nodes.

4. Development Roadmap Summary

Phase 1: Core Connectivity & Node Health.
Phase 2: Metadata Extraction (getting data out of the radio).
Phase 3: The Web Dashboard & Map.
Phase 4: Audio Routing (Discord/Web).
Phase 5: The Intelligence Engine (AI & Incident Aggregation).

2.4 KiB Raw Blame History