Skip to content

About

A unified pipeline for preparing, validating, and running computer vision models on Qualcomm targets.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

iQ-Foundry



Simplify the Workflow, Accelerate Deployment.

This tool simplifies model quantization and validation for edge AI, reducing friction from preparation to real-device deployment—making workflows repeatable and scalable.

🚀 Bring Your Own Model

Supports custom-trained and pretrained models.

Repository overview

Supported runtime and precision combinations
New in v1.0.0: QAIRT offline conversion with INT8, W8A16 and FP16 support!!
🤖 Use iQ-Foundry with your coding agent

iQ-Foundry helps prepare computer vision models for innodisk Qualcomm solution. The current workflow supports compiling compatible computer vision .pt models into .tflite, .onnx, and QAIRT .bin HTP context binary artifacts, validating reference-versus-converted quality with mAP@0.5, and running on-device inference on EXMP-Q911 (Qualcomm QCS9075).

iQ-Foundry supports a Bring Your Own Model workflow. You can use your own compatible yolov10, yolov11, or yolov26 models with the pipeline. If you need pretrained YOLO weights, you can download official pretrained models from Ultralytics.

Note: iQ-Foundry is focused on computer vision model conversion, optimization, and deployment. For more comprehensive deployment information related to hardware and applications, see iQ-Studio.

Workflow At A Glance

  1. Choose your host workflow: Ubuntu 22.04 or Windows 11.
  2. Run qc to generate the quantized and compiled model.
  3. Run mAP to compare source and converted model quality on the same dataset.
  4. Run test for on-device inference, either from the host through ADB or directly on the target.

iQ-Foundry modes overview

Quick Start

Ubuntu logo
Ubuntu Host
Native Ubuntu 22.04 with Docker Engine

Open Ubuntu Host Guide
Windows logo
Windows Host
Windows 11 with Docker Engine inside WSL

Open Windows Host Guide

Platform Capabilities Overview

Workflow Modes

Mode Stage Description
qc Quantize and Compile Convert a supported model into a deployment-ready artifact for validation and device execution.
mAP Evaluate Converted Model Quality Measure detection quality so you can compare the original model against the converted result.
test On-Device Inference Run the prepared model on target device and save outputs for quick functional and visual verification.

Model and Deployment Support

Category Support
Input Format .pt
Model Families yolov10, yolov11, yolov26
Quantization FP32 (float), FP16 (half precision, QAIRT only), INT8 (W8A8), W8A16 (INT mixed precision)
Target Device EXMP-Q911 (Qualcomm QCS9075)
Runtime
LiteRT
LiteRT (TensorFlow Lite)
ONNX Runtime
ONNX Runtime
QAIRT
QAIRT (Qualcomm AI Runtime)
Backend NPU (Qualcomm HTP), CPU

Runtime and Precision Support Matrix

Runtime FP32 INT8 W8A16 FP16
LiteRT ✓ ✓ ✗ ✗
ONNX Runtime ✓ ✗ ✓ ✗
QAIRT ✗ ✓ ✓ ✓

Release Versions

Version Tag Docker Image Known Issues How to Troubleshoot
QLI1.8 v0.0.3 innodiskorg/iqf:v0.0.3 None N/A
QLI2.0 v1.0.0 innodiskorg/iqf:latest Ubuntu ADB connection issue (device offline)
Windows currently only supports QC mode
Restart the device

Note

The default Docker image tag is latest. For QLI1.8, run export IQF_DOCKER_IMAGE=innodiskorg/iqf:v0.0.3 in your terminal.

Explore Other Documentation

Document Purpose Use It When
docs/other_model_flow.md High-level flow guide for unsupported or custom models outside the current native iQ-Foundry path. You want to explore bring-your-own-model onboarding beyond the built-in workflows.
docs/iqf_assistant.md Guide to the iqf-assistant agent skill, which runs qc, mAP and test for you through a chat with Claude Code or Codex. You prefer chatting with a coding agent over typing commands, or you are new to iQ-Foundry.
docker/Docker.md Fallback guide for building the iQF Docker image locally. You need to build the container image instead of pulling it from Docker Hub.

Changelog

Please refer to the Changelog for all updates.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

About

A unified pipeline for preparing, validating, and running computer vision models on Qualcomm targets.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages