CoolFace
Modelpublic

Arm/yolo26n-480-int8-onnx-raspberrypi5

sourceHugging Faceagpl-3.0updated 2d agoView on Hugging Face
0likes11downloads
Model Card

YOLO26n (480x480) optimized for Arm-based Edge Linux systems

An INT8-quantized version of yolo26n for object detection, exported to ONNX (.onnx) and optimized for Arm-based Edge Linux systems.

Summary

This repository contains an Arm-optimized version of yolo26n for object detection, run at a reduced 480x480 input resolution. YOLO26n is Ultralytics' NMS-free, end-to-end object detector with a one2one Detect head: predictions are already deduplicated internally, so no separate non-maximum-suppression pass is required at inference time. The model is provided in ONNX (.onnx) format and run with ONNX Runtime, targeting Edge Linux systems.

The detection head is quantized like the rest of the network rather than being kept in FP32.

This version is intended to demonstrate efficient inference on Arm-based platforms while preserving the original model's intended behavior. Arm has evaluated this model on COCO 2017 and measured performance on a representative evaluation target.

Key results

AreaResult
Model formatONNX (.onnx)
Target device classEdge Linux
Reference deviceRaspberry Pi 5 (Cortex-A76, linux Raspberry Pi OS 64-bit based on Debian 13 "Trixie")
Primary performance resultp50 latency 88.090 ms (1.01x faster than baseline), 11.35 frames per second
Accuracy resultmAP@0.5:0.95 35.92%, mAP@0.5 50.83%
Size / memory result3.951 MB (2.37x smaller), peak memory 115.39 MB

Original model

FieldValue
Original modelyolo26n
Original sourceHugging Face
Original developerUltralytics
Original model cardUltralytics/YOLO26
Original licenseAGPL-3.0

Model files

FileDescription
yolo26n_raspberry_onnx_optimized.onnxArm-optimized INT8 model for deployment
example.pyMinimal inference example
pyproject.tomlPinned runtime dependencies for example.py, resolved with uv
uv.lockLocked dependency resolution for pyproject.toml
config.yamlModel I/O contract used by the example
benchmarks/FP32 baseline and Arm-optimized benchmark records

Performance

Performance was measured on the reference configuration below. Results are intended to make the optimization reproducible but do not guarantee identical performance on every Arm-based system.

Reference configuration

FieldValue
Device / platformRaspberry Pi 5
CPUCortex-A76, 4 cores, arm64
OSlinux, Raspberry Pi OS 64-bit based on Debian 13 "Trixie"
RuntimeONNX Runtime 1.29.0
Execution backendCPU execution provider (MLAS, KleidiAI)
Threads4
PrecisionINT8 static, symmetric — 8-bit per-channel weights, 8-bit activations
Batch size1
Input resolution480x480
Runs / warmup100 / 100

Performance results

MetricOriginal / baselineArm-optimizedImprovement
Model size (MB)9.3773.9512.37x smaller
End-to-end latency p50 (ms)89.32888.0901.01x faster
End-to-end latency p90 (ms)93.20996.2220.97x (slower)
End-to-end latency p99 (ms)100.44799.1671.01x faster
Time to first inference (ms)69.89472.3650.97x (slower)
Model load time (ms)91.278303.5270.30x (slower)
Frames per second11.1911.351.01x
Peak memory (MB)101.28115.390.88x (more)
Average memory (MB)101.25115.360.88x (more)

Accuracy

Accuracy was evaluated using the same preprocessing, input resolution, and evaluation protocol described below. Where possible, the optimized model is compared against the original model under the same evaluation conditions.

Evaluation setup

FieldValue
DatasetCOCO 2017
Splitval2017
Sample count5000
Metric(s)mAP@0.5:0.95, mAP@0.5, mAP@0.75
Confidence threshold0.001 (keeps the full precision-recall curve)
RuntimeONNX Runtime 1.29.0 (CPU execution provider)

Accuracy results

MetricOriginal / baselineArm-optimizedChange
mAP@0.5:0.95 (%)36.4635.92-0.54 pp
mAP@0.5 (%)51.3250.83-0.49 pp
mAP@0.75 (%)39.0438.5-0.54 pp

Accuracy was measured using the evaluation setup described above. Users should re-evaluate the model on their own data before production use.

Arm optimization approach

Arm optimized this model for efficient inference on Arm-based platforms using a hardware-aware conversion and validation flow.

For this release, Arm used:

Optimization areaApplied?Notes
Model conversionYesConverted to ONNX .onnx
QuantizationYesINT8 static symmetric, per-channel weights, calibrated on 300 randomly selected COCO 2017 samples; the detection head is quantized like the rest of the network
Runtime/backend selectionYesONNX Runtime CPU execution provider with MLAS and KleidiAI
Graph/runtime compatibility updatesYesPerformed as part of the shared PT2E export pipeline, with ONNX-specific graph translation
Accuracy validationYesCompared against the original model or published baseline
Performance validationYesMeasured on the reference Arm platform

The goal of this process is to improve deployment characteristics such as latency, memory use, model size, and runtime compatibility while preserving the model's intended behavior. Detailed conversion scripts, calibration configuration, or backend-specific implementation details may be provided separately where appropriate.

Using this model

Install dependencies

Dependencies are declared in pyproject.toml, which ships with this repository. Resolve and install them into a local virtual environment with uv:

bash
uv python install
uv sync --frozen

Run the example

bash
uv run example.py

Expected input

PropertyValue
Input shape[1, 3, 480, 480]
Input typefloat32
Input range[0.0, 1.0]
Preprocessingletterbox to 480x480 (aspect-preserving, centered), pad value 114 (gray fill), to tensor with no mean/std normalization

Expected output

PropertyValue
Output shape[1, 300, 6]
Output type300 pre-deduplicated one2one detections; 4 box coordinates (xyxy, pixel-space in the 480x480 letterboxed frame) + 1 score + 1 class index, already top-k selected by the head
Postprocessingconfidence threshold 0.4, no non-maximum suppression (the head already deduplicates predictions), boxes mapped back to original image coordinates (letterbox padding removed and rescaled)

Intended use

This model is intended for developers evaluating object detection workloads on Arm-based platforms. It is suitable as a reference implementation for benchmarking, prototyping, and integration exploration.

Limitations

  • —Accuracy was evaluated on COCO 2017 val2017 (5000 samples) and may not generalize to all domains.
  • —The model expects a fixed 480x480 input; other resolutions require re-export.
  • —Performance measurements are from Raspberry Pi 5 hardware; results may differ on other Arm devices.

Additional notes

YOLO26n detects the 80 COCO object categories using its NMS-free one2one head; this release runs it at a reduced 480x480 input resolution rather than the model's native 640x640. The quantized artifact keeps the same architecture and parameter count as the source weights; only numeric precision changes.

The bundled example.py reads sample_input.jpg and writes an annotated sample_output.jpg plus a detections.json file beside itself.

The sample input sample_input.jpg is derived from Living room (Unsplash) by Jarosław Ceborski, via Wikimedia Commons (CC0 1.0).

About this version

Original Model: YOLO26n by Ultralytics - Repository

Optimization/conversion: Arm-Optimized version for execution on Arm-based platforms.

Converted/optimized by: Arm

License: The Original Model and the Optimized Model are subject to AGPL-3.0.

This repository contains a converted or optimized version of the Original Model (the “Optimized Model”). The Original Model has been converted or optimized as described above for execution on Arm-based platforms.

No retraining or fine-tuning of the Original Model was performed as part of the conversion or optimization. The conversion or optimization was not intended to change the Original Model’s behavior or intended use.

Original Model and Documentation

For information about the Original Model, including its development, training data, intended uses, limitations and other relevant information, please refer to the Original Model repository. Information in that repository was provided by the original developer or other third parties and, unless expressly stated otherwise, has not been independently verified by Arm.

Licenses and Third-Party Terms

Use of the Original Model and the Optimized Model is subject to the applicable licenses, usage restrictions and other terms identified above and in the relevant repositories. Publication of the Optimized Model does not grant any rights beyond those provided under the applicable license terms.

You are responsible for reviewing those terms and ensuring that your use of the Original Model and the Optimized Model is permitted.

Purpose of this Release

The Optimized Model is provided as a reference implementation to demonstrate and evaluate execution and performance on Arm-based systems. It is not a production-ready or supported solution.

Arm’s publication of the Optimized Model does not constitute an endorsement or certification of the Original Model or a representation that the Optimized Model is suitable for production use or any particular purpose.

To the fullest extent permitted by applicable law (i) the Optimized Model is provided “as is.” Arm makes no representations or warranties that the Original Model, the Optimized Model or their outputs are accurate, safe, secure, non-infringing, legally compliant, suitable for production use or fit for any particular purpose; and (ii) Arm will not be liable for any loss or damage arising from or in connection with the Optimized Model, its use or its outputs.

You are responsible for independently evaluating the Optimized Model, its outputs and its suitability for your intended use, including compliance with applicable legal, regulatory, safety and security requirements.

Arm does not commit to provide ongoing support, maintenance or updates for the Optimized Model. Any use of or reliance on the Optimized Model or its outputs is at your own risk.

Use of Ultralytics models

Ultralytics provides Ultralytics YOLO software and models available through the Arm AI Portal and/or Arm's Hugging Face Organization under the GNU Affero General Public License v3.0 ("AGPL-3.0"), unless you have entered into a separate written license agreement with Ultralytics. Accessing, downloading, or retraining these materials through Arm AI Portal does not grant you an Ultralytics Enterprise License or any other proprietary Ultralytics license.

AGPL-3.0 requires you to release the complete source code of any application that uses Ultralytics YOLO, including applications made available over a network, under the same license. If you are embedding YOLO in a commercial product, internal tool, or production deployment and cannot open-source your code, you need an Ultralytics Enterprise License.

You are responsible for determining which applies to your use. Terms and enterprise licensing options are available at ultralytics.com.