# v82565256-sys/ai-model-compressor-and-comparison-for-yolo architecture

> Architecture diagram of the GitHub repository v82565256-sys/ai-model-compressor-and-comparison-for-yolo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo
- Repository: https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo

## Overview

This repository is a YOLO model-compression and evaluation suite. Users compare two models on images or video, export FP16/INT8 variants, verify predictions, and run repeated dataset benchmarks with metrics and charts. The graph separates the two Streamlit studios, the CLI benchmark, and offline data/video utilities. Edges reflect the excerpts or README; unsampled implementation details are not inferred.

Main entry points: [`quantize_app.py`](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py) (Quantization Studio), [`yolo_compression_pipeline.py`](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/yolo_compression_pipeline.py) (Benchmark Pipeline), [`app.py`](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/app.py) (Comparison Studio), [`create_sample_video.py`](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/create_sample_video.py) (Sample Video Generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_comparison["Model Comparison"]
  node_comparison_studio["Comparison Studio<br/>[app.py]"]
  node_comparison_inputs["Image / Video Input<br/>[app.py]"]
  node_paired_inference["Paired Inference<br/>[app.py]"]
  node_comparison_telemetry["Telemetry &amp; Summary<br/>[app.py]"]
end

subgraph group_quantization["Model Quantization"]
  node_quant_studio["Quantization Studio<br/>[quantize_app.py]"]
  node_baseline_selection["Baseline Selection<br/>[quantize_app.py]"]
  node_onnx_export["ONNX Export<br/>[quantize_app.py]"]
  node_precision_conversion["FP16 / INT8 Conversion<br/>[quantize_app.py]"]
  node_prediction_verification["Prediction Verification<br/>[quantize_app.py]"]
end

subgraph group_benchmarking["Benchmarking"]
  node_benchmark_cli["Benchmark Pipeline"]
  node_dataset_validation["Dataset Validation"]
  node_run_averaging["Multi-Run Metrics"]
  node_benchmark_charts["Benchmark Charts"]
end

subgraph group_offline["Offline Utilities"]
  node_video_generator["Sample Video Generator"]
  node_dataset_generator["3-Object Dataset Generator"]
  node_dataset_downloader["COCO Dataset Downloader"]
  node_visdrone_downloader["VisDrone Downloader"]
end

node_user(("User"))
node_dataset[("Evaluation Dataset")]
node_video["Sample Video"]
node_yolo_runtime["Ultralytics YOLO"]
node_onnx_quantizer["ONNX Quantization"]
node_benchmark_results["Benchmark Results"]

node_user -->|"opens"| node_comparison_studio
node_comparison_studio -->|"selects input"| node_comparison_inputs
node_comparison_studio -->|"runs comparison"| node_paired_inference
node_paired_inference -->|"runs models"| node_yolo_runtime
node_paired_inference -->|"reports metrics"| node_comparison_telemetry
node_user -->|"opens"| node_quant_studio
node_quant_studio -->|"selects model"| node_baseline_selection
node_quant_studio -->|"exports model"| node_onnx_export
node_onnx_export -->|"exports ONNX"| node_yolo_runtime
node_quant_studio -->|"converts precision"| node_precision_conversion
node_precision_conversion -->|"quantizes INT8"| node_onnx_quantizer
node_quant_studio -->|"verifies predictions"| node_prediction_verification
node_prediction_verification -->|"runs predictions"| node_yolo_runtime
node_user -->|"runs pipeline"| node_benchmark_cli
node_benchmark_cli -->|"evaluates models"| node_dataset_validation
node_dataset_validation -->|"validates models"| node_yolo_runtime
node_benchmark_cli -->|"aggregates runs"| node_run_averaging
node_benchmark_cli -->|"generates charts"| node_benchmark_charts
node_benchmark_cli -->|"writes reports"| node_benchmark_results
node_run_averaging -->|"summarizes metrics"| node_benchmark_results
node_user -->|"generates video"| node_video_generator
node_video_generator -->|"reads images"| node_dataset
node_video_generator -->|"writes video"| node_video
node_comparison_inputs -->|"loads sample"| node_video
node_user -->|"creates dataset"| node_dataset_generator
node_dataset_generator -->|"filters labels"| node_dataset
node_user -->|"downloads dataset"| node_dataset_downloader
node_dataset_downloader -->|"downloads files"| node_dataset
node_user -->|"downloads VisDrone"| node_visdrone_downloader
node_visdrone_downloader -->|"triggers validation"| node_yolo_runtime

click node_comparison_studio "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/app.py"
click node_comparison_inputs "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/app.py"
click node_paired_inference "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/app.py"
click node_comparison_telemetry "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/app.py"
click node_quant_studio "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py"
click node_baseline_selection "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py"
click node_onnx_export "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py"
click node_precision_conversion "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py"
click node_prediction_verification "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py"
click node_benchmark_cli "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/yolo_compression_pipeline.py"
click node_dataset_validation "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/yolo_compression_pipeline.py"
click node_run_averaging "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/yolo_compression_pipeline.py"
click node_benchmark_charts "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/yolo_compression_pipeline.py"
click node_video_generator "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/create_sample_video.py"
click node_dataset_generator "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/create_simple_3objects_dataset.py"
click node_dataset_downloader "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/download_dataset.py"
click node_visdrone_downloader "https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/download_visdrone.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_comparison_studio,node_comparison_inputs,node_paired_inference,node_comparison_telemetry,node_user toneBlue
class node_quant_studio,node_baseline_selection,node_onnx_export,node_precision_conversion,node_prediction_verification,node_dataset toneAmber
class node_benchmark_cli,node_dataset_validation,node_run_averaging,node_benchmark_charts toneMint
class node_video_generator,node_dataset_generator,node_dataset_downloader,node_visdrone_downloader toneRose
class node_video,node_yolo_runtime,node_onnx_quantizer,node_benchmark_results toneIndigo
```

## Components

### Model Comparison

- [Comparison Studio](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/app.py): `app.py`
- [Image / Video Input](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/app.py): `app.py`
- [Paired Inference](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/app.py): `app.py`
- [Telemetry & Summary](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/app.py): `app.py`

### Model Quantization

- [Quantization Studio](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py): `quantize_app.py`
- [Baseline Selection](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py): `quantize_app.py`
- [ONNX Export](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py): `quantize_app.py`
- [FP16 / INT8 Conversion](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py): `quantize_app.py`
- [Prediction Verification](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/quantize_app.py): `quantize_app.py`

### Benchmarking

- [Benchmark Pipeline](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/yolo_compression_pipeline.py): `yolo_compression_pipeline.py`
- [Dataset Validation](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/yolo_compression_pipeline.py): `yolo_compression_pipeline.py`
- [Multi-Run Metrics](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/yolo_compression_pipeline.py): `yolo_compression_pipeline.py`
- [Benchmark Charts](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/yolo_compression_pipeline.py): `yolo_compression_pipeline.py`

### Offline Utilities

- [Sample Video Generator](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/create_sample_video.py): `create_sample_video.py`
- [3-Object Dataset Generator](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/create_simple_3objects_dataset.py): `create_simple_3objects_dataset.py`
- [COCO Dataset Downloader](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/download_dataset.py): `download_dataset.py`
- [VisDrone Downloader](https://github.com/v82565256-sys/ai-model-compressor-and-comparison-for-yolo/blob/main/download_visdrone.py): `download_visdrone.py`

### Other components

- **User**
- **Evaluation Dataset**
- **Sample Video**
- **Ultralytics YOLO**
- **ONNX Quantization**
- **Benchmark Results**

## Connections

- User → Comparison Studio: opens (evidence: `README.md`)
- Comparison Studio → Image / Video Input: selects input (evidence: `README.md`)
- Comparison Studio → Paired Inference: runs comparison (evidence: `README.md`)
- Paired Inference → Ultralytics YOLO: runs models (evidence: `app.py`)
- Paired Inference → Telemetry & Summary: reports metrics (evidence: `README.md`)
- User → Quantization Studio: opens (evidence: `README.md`)
- Quantization Studio → Baseline Selection: selects model (evidence: `quantize_app.py`)
- Quantization Studio → ONNX Export: exports model (evidence: `README.md`)
- ONNX Export → Ultralytics YOLO: exports ONNX (evidence: `quantize_app.py`)
- Quantization Studio → FP16 / INT8 Conversion: converts precision (evidence: `README.md`)
- FP16 / INT8 Conversion → ONNX Quantization: quantizes INT8 (evidence: `quantize_app.py`)
- Quantization Studio → Prediction Verification: verifies predictions (evidence: `README.md`)
- Prediction Verification → Ultralytics YOLO: runs predictions (evidence: `quantize_app.py`)
- User → Benchmark Pipeline: runs pipeline (evidence: `README.md`)
- Benchmark Pipeline → Dataset Validation: evaluates models (evidence: `yolo_compression_pipeline.py`)
- Dataset Validation → Ultralytics YOLO: validates models (evidence: `yolo_compression_pipeline.py`)
- Benchmark Pipeline → Multi-Run Metrics: aggregates runs (evidence: `README.md`)
- Benchmark Pipeline → Benchmark Charts: generates charts (evidence: `yolo_compression_pipeline.py`)
- Benchmark Pipeline → Benchmark Results: writes reports (evidence: `README.md`)
- Multi-Run Metrics → Benchmark Results: summarizes metrics (evidence: `yolo_compression_pipeline.py`)
- User → Sample Video Generator: generates video (evidence: `README.md`)
- Sample Video Generator → Evaluation Dataset: reads images (evidence: `create_sample_video.py`)
- Sample Video Generator → Sample Video: writes video (evidence: `create_sample_video.py`)
- Image / Video Input → Sample Video: loads sample (evidence: `app.py`)
- User → 3-Object Dataset Generator: creates dataset (evidence: `README.md`)
- 3-Object Dataset Generator → Evaluation Dataset: filters labels (evidence: `create_simple_3objects_dataset.py`)
- User → COCO Dataset Downloader: downloads dataset (evidence: `README.md`)
- COCO Dataset Downloader → Evaluation Dataset: downloads files (evidence: `download_dataset.py`)
- User → VisDrone Downloader: downloads VisDrone (evidence: `README.md`)
- VisDrone Downloader → Ultralytics YOLO: triggers validation (evidence: `download_visdrone.py`)
