Quickstart Guide

Object detection

Given a video frame, identify objects, and draw bounding boxes around them.

Ensure you have QIM SDK installed. QIM SDK Installation Guide

Prerequisites

Run these commands on your device first:

Set environment variables

mkdir -p $HOME/Downloads/qimsdk_samples/models $HOME/Downloads/qimsdk_samples/labels $HOME/Downloads/qimsdk_samples/media $HOME/Downloads/qimsdk_samples/media/output
export MODEL_NAME=yolox_w8a8.tflite
export LABELS_NAME=yolov8.json
export SRC_VIDEO_NAME=ai_demo_sample.mp4

Download the label, model, and video file

# Download YOLO-X W8A8 model
curl -L -o $HOME/models/$MODEL_NAME \
  https://huggingface.co/Qualcomm/Yolo-X/resolve/v0.30.5/Yolo-X_w8a8.tflite

# Download detection labels
curl -L -o $HOME/labels/$LABELS_NAME \
  https://imsdkdocs.qualcomm.com/labels/yolov8.json

# Download sample video
curl -L -o $HOME/media/$SRC_VIDEO_NAME \
  https://github.com/qualcomm/sample-apps-for-qualcomm-linux/raw/refs/heads/main/qualcomm-linux/artifacts/videos/demo_samples/ai_demo_sample.mp4

Object detection pipeline command

Ensure you have followed the prerequisites before continuing

Run the pipeline command

gst-launch-1.0 -e --gst-debug=2 \
filesrc location=$HOME/media/$SRC_VIDEO_NAME ! qtdemux ! h264parse ! \
v4l2h264dec capture-io-mode=4 output-io-mode=4 ! video/x-raw,format=NV12 ! queue ! \
tee name=t ! qtimetamux name=obj_mux ! qtivoverlay ! waylandsink fullscreen=true sync=true \
t. ! queue ! qtimlvconverter ! queue ! \
qtimltflite model=$HOME/models/$MODEL_NAME delegate=external external-delegate-path=libQnnTFLiteDelegate.so external-delegate-options="QNNExternalDelegate,backend_type=htp,log_level=(string)1;" ! queue ! \
qtimlpostprocess module=yolov8 labels=$HOME/labels/$LABELS_NAME settings="{\"confidence\": 51.0}" ! text/x-raw ! queue ! obj_mux.

View results

Your display shows the video feed with bounding boxes and class labels rendered over each detected object. The pipeline processes frames in real time
Press Ctrl+C to stop the pipeline gracefully.

In case you want to build around this demo, command line might not be the most robust solution
You could paste it into a shell file…
But if you want other code to interact with this, you would want a cpp or python file (pipeline application).

How it works

The pipeline reads an H.264 video file, hardware-decodes it, branches the decoded stream, runs YOLO-X inference on the Qualcomm® AI Engine (HTP backend), post-processes the bounding-box results, blends the annotations back onto the original frame using a hardware compositor, and displays the output to a screen. Pipeline Diagram

Next Steps

You’ve run an object detection pipeline on Qualcomm® hardware. Here’s where to go next:

AI Sample Pipelines

Ready-to-run GStreamer pipelines for classification, segmentation, pose estimation, super resolution, and more.

Blogs

Real-world examples built by the QIM SDK community — covering object detection, PPE compliance, security cameras, and more.

Supported Models

Full catalogue of quantized TFLite models tested on Qualcomm® hardware, with pipeline commands for each.

Plugin Reference

API-level documentation for every QIM SDK GStreamer plugin — properties, caps, and usage examples.

Getting Started

Building AI Pipelines

Examples

Reference

Plugins

Object detection

Prerequisites

Object detection pipeline command

How it works

Next Steps

AI Sample Pipelines

Blogs

Supported Models

Plugin Reference

​Object detection

​Prerequisites

​Object detection pipeline command

​How it works

​Next Steps

AI Sample Pipelines

Blogs

Supported Models

Plugin Reference

Object detection

Prerequisites

Object detection pipeline command

How it works

Next Steps