Docs
{{ g.name }} {{ pg.name }}
Docs/Model Deploy/Model Deploy: How to Convert, Optimize, and Perform Inference with YOLO26 Models

Model Deploy: How to Convert, Optimize, and Perform Inference with YOLO26 Models

Model DeployYOLO26INT8EXMP-Q911iQ-Foundry

This iQ-Studio tutorial follows the iQ-Foundry YOLO26 workflow for EXMP-Q911 (Qualcomm QCS9075). It covers the default flow for INT8 quantization, conversion, quality assurance, and ADB-based inference.

YOLO model deploy overview
YOLO model deploy overview

Overview

This guide follows a straightforward end-to-end flow:

  1. 1
    Quantize and convert the FP32 YOLO model to INT8 .tflite model with Qualcomm AI Hub.
  2. 2
    Compare FP and INT8 model quality with mAP.
  3. 3
    Run inference on Qualcomm Dragonwing IQ9 through ADB.

If you need pretrained YOLO weights (.pt), download the official models from Ultralytics.

Requirements

Item Requirement
Host OSUbuntu 22.04
TargetEXMP-Q911 (Qualcomm QCS9075)
ConnectionUSB for ADB-based execution

Step 1. Connect Device

Connect the Qualcomm Dragonwing IQ9 target to the host with a USB-C cable.

Host to target USB-C connection
Host to target USB-C connection

adb reference: adb overview. No steps are required from that page for this tutorial.

For more about ADB interaction, see Interact with the system using adb.

Step 2. Clone the Repository and Set Up the Environment

Clone the iQ-Foundry repository, go to the repository directory, and source the setup script:

{{ cb1.fname }} bash

This prepares the Python environment, installs the required host packages, and checks ADB access.

Setup script output
Setup script output

Step 3. Authenticate with Qualcomm AI Hub

Log in to the Qualcomm AI Hub Workbench.

Navigate to Account -> Settings -> API Token to find your unique key.

Configure the host with your API token:

{{ cb2.fname }} bash

Step 4. Run the Modes

The --type option supports yolov10, yolov11, and yolov26.

Follow the steps for each mode below to convert the model (qc), evaluate its quality (mAP), and deploy YOLO inference (test).

1. QC

qc quantizes the YOLO model to INT8 and converts it from .pt to .tflite.

Configure the required paths:

{{ cb3.fname }} bash

When prompted, enter the requested model and calibration paths.

QC configure output
QC configure output

Run the mode:

{{ cb4.fname }} bash

This generates the converted YOLO .tflite model in the output directory.

QC mode output
QC mode output

Output location: out/model/yolov26/

2. mAP

mAP compares the FP model and the INT8 model at mAP@0.5.

Configure the required paths:

{{ cb5.fname }} bash

When prompted, enter the requested annotation, image, FP model, and INT8 model paths.

Run the mode:

{{ cb6.fname }} bash

For a smaller validation run, you can limit the number of images:

{{ cb7.fname }} bash

This produces the FP versus INT8 quality comparison report.

mAP mode output
mAP mode output

Output location: out/mAP_results/yolov26/

3. Test

test runs ADB-based YOLO inference on Qualcomm Dragonwing IQ9 and saves the output artifacts.

Configure the required paths:

{{ cb8.fname }} bash

When prompted, enter the requested model, YAML, and test image paths.

Run the mode:

{{ cb9.fname }} bash

This runs inference on the target and saves the generated result artifacts.

Test mode output
Test mode output
Inference output
Inference output

This inference example was generated using a pretrained Ultralytics YOLO26 model.

Output location: out/test/yolov26/

To review the currently saved mode paths, run python3 cli.py --configure.

Use iQ-Foundry for More Options

This iQ-Studio tutorial focuses on the default yolov26 workflow with LiteRT INT8. If you want to use other YOLO models, precisions, or runtimes, continue with the iQ-Foundry Ubuntu or Windows host guide and adjust the --type, --runtime, and --precision options there.

iQ-Foundry Supports:

CategorySupported Options
YOLO modelsyolov10, yolov11, yolov26
RuntimesLiteRT, ONNX Runtime
PrecisionsFP32, w8a16 (mixed precision), INT8
You are here {{ railNum }}/ {{ railTotal }} {{ railPct }}