How sadmansami870213/chameleon works
Chameleon is a BB84 quantum-key-distribution simulator and research web app for comparing fixed-threshold and adaptive eavesdropping detectors. The principal workflow is user settings through the web/API, validated simulation settings, a BB84 link with configurable noise and Eve, sampled test bits/QBER, detector verdicts, and displayed results. Separate branches provide live Monte Carlo comparison, saved runs, and precomputed research summaries; the experiment package supports broader evaluation and reporting. Edges follow shown imports/calls or README statements; unsampled frontend/API wiring and some experiment internals are left unverified rather than inferred.
Main entry points: main.py HTTP API · simulation.py Simulation service · runner.py Monte Carlo runner · link.py Quantum link
Components 22
Application services
- HTTP API
backend/main.py - Settings validation
backend/services/settings.py - Simulation service
backend/services/simulation.py - Live comparison
backend/services/compare.py - Saved runs
backend/services/experiments.py - Run storage
backend/services/storage.py - Research summaries
backend/services/research.py
QKD simulation
- BB84 protocol
backend/qkd/bb84.py - Eavesdropper
backend/qkd/eavesdropper.py - Noise channel
backend/qkd/channel.py - Quantum link
backend/qkd/link.py - Test bits and QBER
backend/qkd/result.py - QKD result contract
backend/qkd/types.py
Detection and research
- Fixed detector
backend/detection/traditional.py - Adaptive detector
backend/detection/adaptive.py - Monte Carlo runner
backend/experiments/runner.py - Experiment configuration
backend/experiments/config.py - Evaluation metrics
backend/experiments/metrics.py - Experiment reports
backend/experiments/report.py
Other components
- Research user
Connections 28
- Research user → Dashboard: uses
README.md - Dashboard → HTTP API: calls API
- HTTP API → Settings validation: validates settings
backend/main.py - HTTP API → Simulation service: routes simulation
backend/main.py - HTTP API → Live comparison: routes comparison
backend/main.py - HTTP API → Saved runs: routes saved runs
backend/main.py - HTTP API → Research summaries: routes summaries
backend/main.py - Simulation service → Quantum link: simulates link
backend/services/simulation.py - Simulation service → Test bits and QBER: builds result
backend/services/simulation.py - Simulation service → Fixed detector: evaluates run
backend/services/simulation.py - Simulation service → Adaptive detector: calibrates and evaluates
backend/services/simulation.py - Quantum link → BB84 protocol: runs protocol
backend/qkd/link.py - Quantum link → Eavesdropper: applies attack
backend/qkd/link.py - Quantum link → Noise channel: applies noise
backend/qkd/link.py - Test bits and QBER → Quantum link: samples exchange
backend/qkd/result.py - Test bits and QBER → QKD result contract: creates result
backend/qkd/result.py - Fixed detector → QKD result contract: consumes result
backend/detection/traditional.py - Adaptive detector → QKD result contract: consumes result
backend/detection/adaptive.py - Live comparison → Monte Carlo runner: runs trials
backend/services/compare.py - Live comparison → Evaluation metrics: summarizes outcomes
backend/services/compare.py - Live comparison → Settings validation: validates settings
backend/services/compare.py - Saved runs → Run storage: reads and writes
backend/services/experiments.py - Research summaries → Dashboard: supplies summaries
- Monte Carlo runner → Experiment configuration: uses configuration
backend/experiments/runner.py - Monte Carlo runner → Adaptive detector: uses detector
backend/experiments/runner.py - Monte Carlo runner → Fixed detector: selects detectors
backend/experiments/runner.py - Monte Carlo runner → Evaluation metrics: produces evaluation data
- Experiment reports → Evaluation metrics: uses metrics
backend/experiments/report.py