# openvinotoolkit/open_model_zoo architecture

> Architecture diagram of the GitHub repository openvinotoolkit/open_model_zoo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/openvinotoolkit/open_model_zoo
- Repository: https://github.com/openvinotoolkit/open_model_zoo

## Overview

Open Model Zoo combines pretrained model assets and model-management tools with Accuracy Checker for validating inference results. The principal workflow is to obtain a model, convert it when needed, then run a configured evaluation and report metrics. The graph also preserves the documented demos capability, but their implementation is not present in the supplied tree. Relationships are limited to README statements and shown source references; unsampled internals are not inferred.

Main entry points: [`tools/accuracy_checker/accuracy_checker/main.py`](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/main.py) (Checker CLI), [`tools/accuracy_checker/accuracy_checker/evaluators/base_evaluator.py`](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/evaluators/base_evaluator.py) (Evaluator base), [`models`](https://github.com/openvinotoolkit/open_model_zoo/tree/master/models) (Pretrained models), [`tools/model_tools/src/omz_tools/omz_downloader.py`](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/omz_downloader.py) (Model downloader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Model Catalog"]
  node_model_assets["Pretrained models"]
  node_demos["Inference demos"]
end

subgraph group_management["Model Management"]
  node_download_cli["Model downloader<br/>[omz_downloader.py]"]
  node_download_engine["Download engine<br/>[downloader.py]"]
  node_cache[("Download cache<br/>[cache.py]")]
  node_converter["Model converter<br/>[omz_converter.py]"]
  node_convert_helpers["Conversion helpers<br/>[_common.py]"]
end

subgraph group_evaluation["Accuracy Checker"]
  node_checker_cli["Checker CLI<br/>[main.py]"]
  node_config["Config reader<br/>[config_reader.py]"]
  node_converters["Annotation converters"]
  node_asr_converter["Kaldi converter"]
end

subgraph group_evaluation_core["Evaluation Core"]
  node_evaluator["Model evaluator<br/>[model_evaluator.py]"]
  node_base_evaluator["Evaluator base<br/>[base_evaluator.py]"]
  node_quant_evaluator["Quantized evaluator"]
  node_asr_evaluator["ASR pipeline"]
  node_adapters["Output adapters"]
  node_representations["Result representations"]
  node_metrics["Evaluation metrics"]
  node_reporting["Progress reporting"]
end

node_user(("Model user"))
node_checker_user(("Evaluation user"))

node_user -->|"selects model"| node_model_assets
node_user -->|"requests download"| node_download_cli
node_download_cli -->|"uses engine"| node_download_engine
node_download_engine -->|"uses cache"| node_cache
node_user -->|"requests conversion"| node_converter
node_converter -->|"uses helpers"| node_convert_helpers
node_checker_user -->|"starts evaluation"| node_checker_cli
node_checker_cli -->|"loads configuration"| node_config
node_checker_cli -->|"creates evaluator"| node_evaluator
node_checker_cli -->|"selects reporter"| node_reporting
node_evaluator -.->|"extends evaluator"| node_base_evaluator
node_quant_evaluator -.->|"extends evaluator"| node_base_evaluator
node_asr_evaluator -->|"extends evaluator"| node_base_evaluator
node_converters -.->|"includes converter"| node_asr_converter
node_user -->|"uses demos"| node_demos
node_model_assets -->|"demonstrated by"| node_demos

click node_model_assets "https://github.com/openvinotoolkit/open_model_zoo/tree/master/models"
click node_download_cli "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/omz_downloader.py"
click node_download_engine "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/download_engine/downloader.py"
click node_cache "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/download_engine/cache.py"
click node_converter "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/omz_converter.py"
click node_convert_helpers "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/_common.py"
click node_checker_cli "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/main.py"
click node_config "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/config/config_reader.py"
click node_converters "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/annotation_converters/format_converter.py"
click node_asr_converter "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/annotation_converters/kaldi_speech_recognition_pipeline.py"
click node_evaluator "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/evaluators/model_evaluator.py"
click node_base_evaluator "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/evaluators/base_evaluator.py"
click node_quant_evaluator "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/evaluators/quantization_model_evaluator.py"
click node_asr_evaluator "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/evaluators/custom_evaluators/asr_pipeline_evaluator.py"
click node_adapters "https://github.com/openvinotoolkit/open_model_zoo/tree/master/tools/accuracy_checker/accuracy_checker/adapters"
click node_representations "https://github.com/openvinotoolkit/open_model_zoo/tree/master/tools/accuracy_checker/accuracy_checker/representation"
click node_metrics "https://github.com/openvinotoolkit/open_model_zoo/tree/master/tools/accuracy_checker/accuracy_checker/metrics"
click node_reporting "https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/progress_reporters.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_model_assets,node_demos,node_user,node_checker_user toneBlue
class node_download_cli,node_download_engine,node_cache,node_converter,node_convert_helpers toneAmber
class node_checker_cli,node_config,node_converters,node_asr_converter toneMint
class node_evaluator,node_base_evaluator,node_quant_evaluator,node_asr_evaluator,node_adapters,node_representations,node_metrics,node_reporting toneRose
```

## Components

### Model Catalog

- [Pretrained models](https://github.com/openvinotoolkit/open_model_zoo/tree/master/models): `models`
- **Inference demos**

### Model Management

- [Model downloader](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/omz_downloader.py): `tools/model_tools/src/omz_tools/omz_downloader.py`
- [Download engine](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/download_engine/downloader.py): `tools/model_tools/src/omz_tools/download_engine/downloader.py`
- [Download cache](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/download_engine/cache.py): `tools/model_tools/src/omz_tools/download_engine/cache.py`
- [Model converter](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/omz_converter.py): `tools/model_tools/src/omz_tools/omz_converter.py`
- [Conversion helpers](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/model_tools/src/omz_tools/_common.py): `tools/model_tools/src/omz_tools/_common.py`

### Accuracy Checker

- [Checker CLI](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/main.py): `tools/accuracy_checker/accuracy_checker/main.py`
- [Config reader](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/config/config_reader.py): `tools/accuracy_checker/accuracy_checker/config/config_reader.py`
- [Annotation converters](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/annotation_converters/format_converter.py): `tools/accuracy_checker/accuracy_checker/annotation_converters/format_converter.py`
- [Kaldi converter](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/annotation_converters/kaldi_speech_recognition_pipeline.py): `tools/accuracy_checker/accuracy_checker/annotation_converters/kaldi_speech_recognition_pipeline.py`

### Evaluation Core

- [Model evaluator](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/evaluators/model_evaluator.py): `tools/accuracy_checker/accuracy_checker/evaluators/model_evaluator.py`
- [Evaluator base](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/evaluators/base_evaluator.py): `tools/accuracy_checker/accuracy_checker/evaluators/base_evaluator.py`
- [Quantized evaluator](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/evaluators/quantization_model_evaluator.py): `tools/accuracy_checker/accuracy_checker/evaluators/quantization_model_evaluator.py`
- [ASR pipeline](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/evaluators/custom_evaluators/asr_pipeline_evaluator.py): `tools/accuracy_checker/accuracy_checker/evaluators/custom_evaluators/asr_pipeline_evaluator.py`
- [Output adapters](https://github.com/openvinotoolkit/open_model_zoo/tree/master/tools/accuracy_checker/accuracy_checker/adapters): `tools/accuracy_checker/accuracy_checker/adapters`
- [Result representations](https://github.com/openvinotoolkit/open_model_zoo/tree/master/tools/accuracy_checker/accuracy_checker/representation): `tools/accuracy_checker/accuracy_checker/representation`
- [Evaluation metrics](https://github.com/openvinotoolkit/open_model_zoo/tree/master/tools/accuracy_checker/accuracy_checker/metrics): `tools/accuracy_checker/accuracy_checker/metrics`
- [Progress reporting](https://github.com/openvinotoolkit/open_model_zoo/blob/master/tools/accuracy_checker/accuracy_checker/progress_reporters.py): `tools/accuracy_checker/accuracy_checker/progress_reporters.py`

### Other components

- **Model user**
- **Evaluation user**

## Connections

- Model user → Pretrained models: selects model
- Model user → Model downloader: requests download
- Model downloader → Download engine: uses engine
- Download engine → Download cache: uses cache (evidence: `tools/model_tools/src/omz_tools/download_engine/downloader.py`)
- Model user → Model converter: requests conversion
- Model converter → Conversion helpers: uses helpers (evidence: `tools/model_tools/src/omz_tools/omz_converter.py`)
- Evaluation user → Checker CLI: starts evaluation (evidence: `tools/accuracy_checker/accuracy_checker/main.py`)
- Checker CLI → Config reader: loads configuration (evidence: `tools/accuracy_checker/accuracy_checker/main.py`)
- Checker CLI → Model evaluator: creates evaluator (evidence: `tools/accuracy_checker/accuracy_checker/main.py`)
- Checker CLI → Progress reporting: selects reporter (evidence: `tools/accuracy_checker/accuracy_checker/main.py`)
- Model evaluator → Evaluator base: extends evaluator
- Quantized evaluator → Evaluator base: extends evaluator
- ASR pipeline → Evaluator base: extends evaluator (evidence: `tools/accuracy_checker/accuracy_checker/evaluators/custom_evaluators/asr_pipeline_evaluator.py`)
- Annotation converters → Kaldi converter: includes converter (evidence: `tools/accuracy_checker/accuracy_checker/annotation_converters/kaldi_speech_recognition_pipeline.py`)
- Model user → Inference demos: uses demos
- Pretrained models → Inference demos: demonstrated by
