# qualcomm/ai-hub-models architecture

> Architecture diagram of the GitHub repository qualcomm/ai-hub-models, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/qualcomm/ai-hub-models
- Repository: https://github.com/qualcomm/ai-hub-models

## Overview

Qualcomm AI Hub Models is a catalog and Python package for deploying machine-learning models on Qualcomm devices, with a companion catalog/download CLI. Users browse or fetch published assets, or select a model and run its export workflow to compile, optionally quantize, profile, infer, and download; they can also evaluate accuracy or run local/on-device demos. The graph captures documented capabilities and indexed module relationships; several internal utility paths are named in the source index but were not excerpted, so their detailed behavior is not inferred.

Main entry points: [`src/qai_hub_models/utils/export/pipeline.py`](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/export/pipeline.py) (Export orchestration), [`src/qai_hub_models/models`](https://github.com/qualcomm/ai-hub-models/tree/main/src/qai_hub_models/models) (Model recipes), [`src/qai_hub_models/models/templates/yolo/app.py`](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/models/templates/yolo/app.py) (Demo applications), [`src/qai_hub_models/utils/evaluate/pipeline.py`](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/evaluate/pipeline.py) (Accuracy evaluation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Catalog CLI"]
  node_cli["Catalog commands<br/>[cli.py]"]
  node_cli_common["CLI common<br/>[common.py]"]
  node_cli_fetch["Asset fetch<br/>[fetch.py]"]
end

subgraph group_models["Models and Data"]
  node_model_catalog["Model recipes"]
  node_model_apps["Demo applications<br/>[app.py]"]
  node_datasets["Dataset adapters"]
end

subgraph group_workflows["Export and Evaluation"]
  node_export["Export orchestration<br/>[pipeline.py]"]
  node_collection_export["Collection export"]
  node_multi_export["Multi-graph export"]
  node_evaluate["Accuracy evaluation<br/>[pipeline.py]"]
  node_collection_evaluate["Collection evaluation"]
  node_hub_helpers["Workbench helpers<br/>[qai_hub_helpers.py]"]
end

subgraph group_runtime["Runtime Foundations"]
  node_inference["Inference executors<br/>[inference.py]"]
  node_asset_loaders["Asset loading<br/>[asset_loaders.py]"]
  node_input_spec["Tensor specifications<br/>[input_spec.py]"]
  node_image_processing["Image processing"]
  node_base_model["Model interfaces<br/>[base_model.py]"]
  node_base_app["App interfaces<br/>[base_app.py]"]
  node_base_dataset["Dataset interfaces<br/>[base_dataset.py]"]
end

subgraph group_metadata["Model Metadata"]
  node_metadata["Model configuration<br/>[model_metadata.py]"]
  node_manifest["Recipe manifests<br/>[manifest_yaml.py]"]
end

node_user(("Model user"))
node_hub{{"AI Hub Workbench"}}
node_device(("Qualcomm device"))

node_user -->|"browse or fetch"| node_cli
node_cli -->|"fetch assets"| node_cli_fetch
node_cli -->|"use shared CLI"| node_cli_common
node_user -->|"choose model"| node_model_catalog
node_model_catalog -.->|"provide app example"| node_model_apps
node_model_apps -->|"preprocess inputs"| node_image_processing
node_model_apps -->|"run inference"| node_inference
node_model_catalog -.->|"implement model interface"| node_base_model
node_datasets -.->|"extend dataset interface"| node_base_dataset
node_user -->|"request export"| node_export
node_export -->|"dispatch collection"| node_collection_export
node_export -->|"dispatch multi-graph"| node_multi_export
node_export -->|"load recipe metadata"| node_manifest
node_export -->|"load model assets"| node_asset_loaders
node_collection_export -->|"use Workbench helpers"| node_hub_helpers
node_collection_export -->|"compile and profile"| node_hub
node_hub -->|"run on device"| node_device
node_user -->|"evaluate accuracy"| node_evaluate
node_evaluate -->|"dispatch collection"| node_collection_evaluate
node_evaluate -.->|"evaluate with data"| node_datasets
node_evaluate -->|"run model executor"| node_inference
node_inference -->|"submit inference"| node_hub
node_base_model -.->|"describe inputs"| node_input_spec
node_model_apps -->|"wrap model inference"| node_base_app
node_model_catalog -.->|"publish model details"| node_metadata

click node_cli "https://github.com/qualcomm/ai-hub-models/blob/main/cli/qai_hub_models_cli/cli.py"
click node_cli_common "https://github.com/qualcomm/ai-hub-models/blob/main/cli/qai_hub_models_cli/common.py"
click node_cli_fetch "https://github.com/qualcomm/ai-hub-models/blob/main/cli/qai_hub_models_cli/fetch.py"
click node_model_catalog "https://github.com/qualcomm/ai-hub-models/tree/main/src/qai_hub_models/models"
click node_model_apps "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/models/templates/yolo/app.py"
click node_datasets "https://github.com/qualcomm/ai-hub-models/tree/main/src/qai_hub_models/datasets"
click node_export "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/export/pipeline.py"
click node_collection_export "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/export/collection_pipeline.py"
click node_multi_export "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/export/multi_graph_collection_pipeline.py"
click node_evaluate "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/evaluate/pipeline.py"
click node_collection_evaluate "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/evaluate/collection_pipeline.py"
click node_hub_helpers "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/qai_hub_helpers.py"
click node_inference "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/inference.py"
click node_asset_loaders "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/asset_loaders.py"
click node_input_spec "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/input_spec.py"
click node_image_processing "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/image_processing.py"
click node_base_model "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/base_model.py"
click node_base_app "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/base_app.py"
click node_base_dataset "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/base_dataset.py"
click node_metadata "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/configs/model_metadata.py"
click node_manifest "https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/configs/manifest_yaml.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_cli,node_cli_common,node_cli_fetch,node_user toneBlue
class node_model_catalog,node_model_apps,node_datasets toneAmber
class node_export,node_collection_export,node_multi_export,node_evaluate,node_collection_evaluate,node_hub_helpers toneMint
class node_inference,node_asset_loaders,node_input_spec,node_image_processing,node_base_model,node_base_app,node_base_dataset toneRose
class node_metadata,node_manifest,node_hub,node_device toneIndigo
```

## Components

### Catalog CLI

- [Catalog commands](https://github.com/qualcomm/ai-hub-models/blob/main/cli/qai_hub_models_cli/cli.py): `cli/qai_hub_models_cli/cli.py`
- [CLI common](https://github.com/qualcomm/ai-hub-models/blob/main/cli/qai_hub_models_cli/common.py): `cli/qai_hub_models_cli/common.py`
- [Asset fetch](https://github.com/qualcomm/ai-hub-models/blob/main/cli/qai_hub_models_cli/fetch.py): `cli/qai_hub_models_cli/fetch.py`

### Models and Data

- [Model recipes](https://github.com/qualcomm/ai-hub-models/tree/main/src/qai_hub_models/models): `src/qai_hub_models/models`
- [Demo applications](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/models/templates/yolo/app.py): `src/qai_hub_models/models/templates/yolo/app.py`
- [Dataset adapters](https://github.com/qualcomm/ai-hub-models/tree/main/src/qai_hub_models/datasets): `src/qai_hub_models/datasets`

### Export and Evaluation

- [Export orchestration](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/export/pipeline.py): `src/qai_hub_models/utils/export/pipeline.py`
- [Collection export](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/export/collection_pipeline.py): `src/qai_hub_models/utils/export/collection_pipeline.py`
- [Multi-graph export](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/export/multi_graph_collection_pipeline.py): `src/qai_hub_models/utils/export/multi_graph_collection_pipeline.py`
- [Accuracy evaluation](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/evaluate/pipeline.py): `src/qai_hub_models/utils/evaluate/pipeline.py`
- [Collection evaluation](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/evaluate/collection_pipeline.py): `src/qai_hub_models/utils/evaluate/collection_pipeline.py`
- [Workbench helpers](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/qai_hub_helpers.py): `src/qai_hub_models/utils/qai_hub_helpers.py`

### Runtime Foundations

- [Inference executors](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/inference.py): `src/qai_hub_models/utils/inference.py`
- [Asset loading](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/asset_loaders.py): `src/qai_hub_models/utils/asset_loaders.py`
- [Tensor specifications](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/input_spec.py): `src/qai_hub_models/utils/input_spec.py`
- [Image processing](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/image_processing.py): `src/qai_hub_models/utils/image_processing.py`
- [Model interfaces](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/base_model.py): `src/qai_hub_models/utils/base_model.py`
- [App interfaces](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/base_app.py): `src/qai_hub_models/utils/base_app.py`
- [Dataset interfaces](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/utils/base_dataset.py): `src/qai_hub_models/utils/base_dataset.py`

### Model Metadata

- [Model configuration](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/configs/model_metadata.py): `src/qai_hub_models/configs/model_metadata.py`
- [Recipe manifests](https://github.com/qualcomm/ai-hub-models/blob/main/src/qai_hub_models/configs/manifest_yaml.py): `src/qai_hub_models/configs/manifest_yaml.py`

### Other components

- **Model user**
- **AI Hub Workbench**
- **Qualcomm device**

## Connections

- Model user → Catalog commands: browse or fetch (evidence: `README.md`)
- Catalog commands → Asset fetch: fetch assets (evidence: `cli/qai_hub_models_cli/cli.py`)
- Catalog commands → CLI common: use shared CLI (evidence: `cli/qai_hub_models_cli/cli.py`)
- Model user → Model recipes: choose model (evidence: `README.md`)
- Model recipes → Demo applications: provide app example (evidence: `src/qai_hub_models/models/templates/yolo/app.py`)
- Demo applications → Image processing: preprocess inputs (evidence: `src/qai_hub_models/models/templates/yolo/app.py`)
- Demo applications → Inference executors: run inference (evidence: `README.md`)
- Model recipes → Model interfaces: implement model interface
- Dataset adapters → Dataset interfaces: extend dataset interface (evidence: `src/qai_hub_models/datasets/__init__.py`)
- Model user → Export orchestration: request export (evidence: `README.md`)
- Export orchestration → Collection export: dispatch collection (evidence: `src/qai_hub_models/utils/export/pipeline.py`)
- Export orchestration → Multi-graph export: dispatch multi-graph (evidence: `src/qai_hub_models/utils/export/pipeline.py`)
- Export orchestration → Recipe manifests: load recipe metadata (evidence: `src/qai_hub_models/utils/export/pipeline.py`)
- Export orchestration → Asset loading: load model assets (evidence: `src/qai_hub_models/utils/export/pipeline.py`)
- Collection export → Workbench helpers: use Workbench helpers (evidence: `src/qai_hub_models/utils/export/collection_pipeline.py`)
- Collection export → AI Hub Workbench: compile and profile (evidence: `README.md`)
- AI Hub Workbench → Qualcomm device: run on device (evidence: `README.md`)
- Model user → Accuracy evaluation: evaluate accuracy (evidence: `README.md`)
- Accuracy evaluation → Collection evaluation: dispatch collection (evidence: `src/qai_hub_models/utils/evaluate/pipeline.py`)
- Accuracy evaluation → Dataset adapters: evaluate with data
- Accuracy evaluation → Inference executors: run model executor (evidence: `src/qai_hub_models/utils/evaluate/pipeline.py`)
- Inference executors → AI Hub Workbench: submit inference (evidence: `README.md`)
- Model interfaces → Tensor specifications: describe inputs
- Demo applications → App interfaces: wrap model inference (evidence: `README.md`)
- Model recipes → Model configuration: publish model details
