# 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).