🕵️‍♂️ ColdCase Detective AI — Multi-Source Criminal Investigation OS & Cinematic Crime Board

Live Demo URL: 🌐 https://coldcase-agentic-os-448033705367.us-central1.run.app
Autonomous Multi-Agent Intelligence System & Interactive Crime Board for cracking unsolved cold cases across police telemetry, private investigator dossiers, historical press archives, web sleuth discoveries, and audiovisual reports.

---

📌 Executive Summary

Unresolved criminal cases remain cold for decades not because evidence is missing, but because vital investigative links are fragmented across incompatible silos:

• Sworn witness depositions given decades apart.
• Hardwired museum & bank vault sensor telemetry.
• Private Investigator field stakeouts & confidential dossiers.
• Microfilm scans of historical daily newspapers.
• Web sleuth & crowdsourced OSINT investigations (Reddit / Usenet).
• Multimodal documentary broadcasts & forensic wiretap audio tapes.

ColdCase Detective AI solves this challenge by deploying a team of 6 specialized autonomous AI agents powered by Google ADK & Gemini 3.7, orchestrating multi-channel cross-correlation and rendering evidence onto an interactive Hollywood-style Cinematic Crime Pinboard.

---

🏛️ System Architecture

                                  🌐 MULTI-SOURCE INTELLIGENCE INGESTION
        ┌───────────────────┬─────────────────────┬───────────────────┬───────────────────┐
        ▼                   ▼                     ▼                   ▼                   ▼
 🏛️ Police / DNA      🕵️‍♂️ Private PIs        📰 Press Archives   🌐 Web Sleuths      🎥 Video & Audio
 (Telemetry / Logs)   (Field Stakeouts)     (Historic Scans)    (Reddit / Usenet)   (Transcripts/Wiretaps)
        │                   │                     │                   │                   │
        └───────────────────┴──────────┬──────────┴───────────────────┴───────────────────┘
                                       │
                                       ▼
                       🧠 GOOGLE AGENT DEVELOPMENT KIT (ADK)
                     ┌───────────────────────────────────────┐
                     │   Hierarchical Multi-Agent Workflow   │
                     └───────────────────┬───────────────────┘
                                         │
    ┌────────────────────────────────────┼────────────────────────────────────┐
    ▼                                    ▼                                    ▼
┌────────────────────────┐   ┌────────────────────────┐   ┌────────────────────────┐
│  AGENT 01 // OSINT     │   │  AGENT 02 // TIMELINE  │   │  AGENT 03 // ALIBIS    │
│  FBI Wanted Archives   │──▶│  Forensic Checkpoints  │──▶│  Contradiction Hunter  │
│  & Declassified Scans  │   │  & Sensor Telemetry    │   │  (STANAG A1 Evidence)  │
└────────────────────────┘   └────────────────────────┘   └────────────────────────┘
    │                                    │                                    │
    └────────────────────────────────────┼────────────────────────────────────┘
                                         ▼
┌────────────────────────┐   ┌────────────────────────┐   ┌────────────────────────┐
│  AGENT 04 // PROFILER  │   │  AGENT 05 // CRITIC    │   │  AGENT 06 // ACTION    │
│  Multi-Source Theories │──▶│  Adversarial Skeptic   │──▶│  High-Yield Lead &     │
│  (H1/H2 Confidence)    │   │  & NATO Source Matrix  │   │  Rogatory Warrants     │
└────────────────────────┘   └────────────────────────┘   └────────────────────────┘
                                         │
                                         ▼
                     📌 INTERACTIVE CINEMATIC CRIME PINBOARD
              (Realistic Corkboard • Polaroids • Red Catenary Strings • Splitters)

---

🤖 The 6 Specialized Autonomous Agents

Agent	Codename	Primary Mission	NATO Credibility Grade
01	FBI & OSINT Archive Agent	Scans official declassified archives, FBI Wanted listings, and public record databases.	Grade B2
02	Timeline & Forensics Telemetry Agent	Reconstructs minute-by-minute physical and digital movements (toll gates, alarms, train manifests).	Grade A1
03	Alibi Contradiction Detector	Pairs conflicting sworn statements with empirical telemetry to expose spatial-temporal lies.	Grade A1 (Certified)
04	Criminal Profiler & Hypothesis Agent	Formulates testable theories (H1/H2), analyzing motives, insider access, and accomplice channels.	Grade B2 / C3
05	Senior Detective Critic (Adversarial)	Acts as an adversarial devil's advocate to stress-test hypotheses and eliminate confirmation bias.	Interpol STANAG Matrix
06	Breakthrough Lead & Action Agent	Prescribes the single highest-yield next operational action (Touch DNA / IGG, international subpoenas).	High Impact

---

✨ Key Features & Innovation

1. 📌 Cinematic Hollywood-Style Crime Board ("Murder Board")

• Realistic Corkboard Canvas: HD ambient lighting, vintage texture, and realistic pushpins (red, brass, silver).
• Rich Multi-Source Clue Cards:
  • Authentic Polaroids: With scotch tape, realistic tilt, and handwritten forensic annotations (Caveat font).
  • Forensic Sticky Notes: Yellow and pink notes with curled corners for contradictions and Web Sleuth hints.
  • Aged Newspaper Clippings: Historical headlines (Berliner Zeitung, Boston Globe, Wall Street Journal).
  • PI Confidential Reports: Field surveillance files stamped [ CONFIDENTIAL ].
  • Audiovisual Video Cards: Video thumbnails with timecodes and key testimony snippets.
• Dynamic Catenary Red Strings: SVG physical threads with drop-shadows and suspended investigation tags ("Falsified Alibi", "PI Stakeout", "Titanium Particles").
• Freeform Drag & Drop: Freely reposition any Polaroid or note with real-time recalculation of the connecting red strings.
• Channel Filters: Filter instantly by Private Investigators, Press Archives, Web Sleuths, Video Reports, or Police & DNA.

2. 🎛️ 2-in-1 Unified Interactive Splitters (Resize & Toggle)

• Mouse Drag Resizing: Click and drag the splitter bars left or right to customize panel widths in real-time.
• Quick-Toggle Pill (◀ / ▶): One-click instant collapse/expand of sidebars.
• ⛶ MAX BOARD Mode: Expand the Crime Board to 100% fullscreen for maximum investigation immersion.

3. 🌐 Live Open Intelligence (OSINT) Integration

• Direct querying against Wikipedia Open REST API and FBI Wanted archives for real-time document and photo ingestion.

4. 🗂️ 9 Pre-loaded High-Profile Cold Cases

1. The Grand National Vault Century Heist (Berlin & Zurich)
2. The Isabella Stewart Gardner Museum Heist (Boston, MA)
3. The Antwerp Diamond Center Vault Heist (Antwerp, Belgium)
4. The Zodiac Killer & Unsolved 340 Cryptograms (San Francisco Bay Area, CA)
5. The Black Dahlia Murder (Los Angeles, CA)
6. The D.B. Cooper Skyjacking Mystery (Pacific Northwest)
7. The Peninsula Yacht Charter Ghost Ship (Puget Sound, WA)
8. Global Manhunt for Ruja Ignatova "Cryptoqueen" (Sofia / Athens / Dubai)
9. The Bangladesh Central Bank Cyber-Heist (Dhaka / New York / Manila)

---

🚀 Quickstart Guide

Prerequisites

• Python 3.10+ (tested on Python 3.11, 3.12, 3.13)
• Modern web browser (Chrome, Firefox, Edge, Safari)

1. Clone & Install

# Clone the repository
git clone https://github.com/votre-nom/coldcase-detective-ai.git
cd coldcase-detective-ai

# Install dependencies
pip install -r requirements.txt

2. Configuration

Copy .env.example to .env and set your Google Gemini API key:

cp .env.example .env

GEMINI_API_KEY=your_gemini_api_key_here
MOCK_MODE=0  # Set to 1 for offline mock mode, 0 for live Google ADK agent execution

3. Launch the Investigation Console

# Start FastAPI / Uvicorn server
python -m uvicorn api.main:app --host 127.0.0.1 --port 8000

Open http://localhost:8000 in your browser!

---

🐳 Docker Deployment

Run the entire application in an isolated container:

# Build Docker image
docker build -t coldcase-detective-ai:latest .

# Run container on port 8000
docker run -d -p 8000:8000 --env GEMINI_API_KEY="your_api_key" coldcase-detective-ai:latest

---

☁️ Google Cloud Run Deployment

Deploy serverless in seconds with Google Cloud CLI:

# Set your Google Cloud project
gcloud config set project YOUR_GCP_PROJECT_ID

# Deploy directly to Cloud Run
gcloud run deploy coldcase-detective-ai \
  --source . \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --set-env-vars GEMINI_API_KEY="your_api_key_here",MOCK_MODE="0"

---

🧪 API Endpoints Overview

Method	Endpoint	Description
GET	/	Serves the interactive Crime Board interface.
GET	/api/cases	Returns all 9 cold case dossiers with board elements and red strings.
GET	/api/cases/{case_id}	Retrieves full metadata and forensic evidence for a specific case.
POST	/api/fetch-live	Queries public endpoints (Wikimedia/FBI) for live crime data and photos.
POST	/api/investigate	Triggers the 6-agent collaborative reasoning pipeline on the active case.

---

🏆 Devpost Submission Highlights

• Human-in-the-Loop Autonomous Agents: The system synthesizes intelligence automatically, while leaving final operational decisions in the hands of human detectives.
• Multimodal & Multi-Source Cross-Correlation: Overcomes cognitive silos by bridging raw sensor telemetry, undercover PI surveillance, historical newspapers, and video audio.
• Zero-Dependency Lightweight Frontend: Built with pure HTML5, vanilla CSS, and high-performance SVG animations for 60fps interaction with zero heavy node framework overhead.

---

📄 License

Distributed under the Apache 2.0 License. See LICENSE for more information.