将 YOLO 模型导出为 LiteRT,以便在边缘设备和 Web 上部署#
LiteRT(Lite Runtime 的简称)是 Google 面向设备端 AI 的高性能运行时。它是 TensorFlow Lite (TFLite) 的下一代版本和新名称,并运行相同的 .tflite 模型格式。借助 LiteRT,只需导出一个 Ultralytics YOLO 模型,就能部署到移动设备、嵌入式设备、边缘设备和浏览器上——涵盖旧版 tflite 和 tfjs 导出格式分别处理的所有场景,现已统一到一个框架下。
Watch: How to Export Ultralytics YOLO26 to Google LiteRT | Deploy Vision AI on Android & iOS | Mobile AI 📱🚀
LiteRT 导出格式会针对目标检测、分割、姿态估计和分类等任务优化你的模型,使其能够在各种设备上快速离线运行。
官方 Ultralytics YOLO Flutter 插件开箱即用地在 Android 上运行 LiteRT .tflite 导出模型,支持实时摄像头推理、单图像预测、GPU 加速,以及针对 YOLO26 全部七项任务(包括 Depth)的自动模型下载。Apple 设备请使用 CoreML 导出;Qualcomm Snapdragon NPU 请参阅 Qualcomm QNN 集成。
在 imgsz=224 导出分类模型。在
imgsz=640 导出检测、分割、语义、深度、姿态和 OBB 模型。这个 224/640 标准由官方 LiteRT、CoreML 和 QNN 移动端资源共享。
官方 Ultralytics YOLO NPM 包通过 LiteRT.js 直接在浏览器中运行 LiteRT .tflite 导出模型,无需服务器或 Python——支持实时摄像头推理、单图像预测,以及 WebGPU 加速(自动回退到 CPU/WASM),覆盖 YOLO26 的全部六项任务(detect、segment、pose、OBB、classify、semantic)。在 WebGPU 上,其速度通常比 ONNX Runtime Web 快约 ~2×。
npm i @ultralytics/yolo @litertjs/core为什么应该导出为 LiteRT?#
LiteRT 是一个专为设备端推理设计的开源框架,也称为边缘计算。它为开发者提供了在移动设备、嵌入式设备和 IoT 设备、传统计算机上执行训练模型的工具,并可通过 LiteRT.js 直接在 Web 浏览器和 Node.js 中运行。
一种模型格式,覆盖所有目标平台:
- 移动端和嵌入式设备:Android、iOS、嵌入式 Linux 和微控制器 (MCU)。
- 边缘加速器:兼容 Coral Edge TPU,可进一步加速。
- 浏览器和 Node.js:LiteRT.js 通过 WebGPU/WASM 加速在 Web 上运行相同的
.tflite模型——无需单独导出 TensorFlow.js。
LiteRT 模型的主要特性#
- 设备端优化:通过在本地处理数据来降低延迟,不传输个人数据以增强隐私,并减小模型大小以节省空间。
- 多平台支持:可运行于 Android、iOS、嵌入式 Linux、微控制器和现代 Web 浏览器。
- 硬件加速:在 CPU 上利用 XNNPACK,并通过 OpenCL、Metal 和 WebGPU 实现 GPU 加速。GPU delegate 默认以 FP16 运行,进一步提升速度。
- 量化:支持 FP32、静态 INT8(
quantize=8,int8 权重 + int8 激活值)、静态 INT16-activation(quantize="w8a16",int8 权重 + int16 激活值,以获得更高精度)和动态 INT8(quantize="w8a32",int8 权重 + FP32 激活值,无需校准数据),从而压缩模型并加快推理,同时将精度损失降至最低。 - 多语言支持:兼容 Java/Kotlin、Swift、Objective-C、C++、Python 和 JavaScript。
实测性能#
**硬件:**配备 12 GB LPDDR5X 内存和 Android 16 / API 36 的 Xiaomi 17。其 3 nm Snapdragon 8 Elite Gen 5 (SM8850)搭载 8 核 Qualcomm Oryon CPU(2 个最高 4.6 GHz 的 Prime 核心和 6 个最高 3.62 GHz 的 Performance 核心)、 Adreno GPU 和 Hexagon NPU。
| 模型 | 任务 | 尺寸 (像素) | CPU w8a32 LiteRT (毫秒) | GPU w8a32 LiteRT (毫秒) |
|---|---|---|---|---|
| YOLO26n | Detect | 640 | 52.2 1.8 / 48.1 / 2.4 | 15.8 2.3 / 8.9 / 4.6 |
| YOLO26n-seg | Segment | 640 | 73.4 1.8 / 65.6 / 6.0 | 33.2 1.8 / 23.8 / 7.6 |
| YOLO26n-sem | 语义分割 | 640 | 61.2 1.8 / 51.1 / 8.3 | 34.2 1.8 / 24.0 / 8.3 |
| YOLO26n-depth | 深度 | 640 | 124.4 1.9 / 115.1 / 7.4 | 23.0 1.8 / 13.5 / 7.7 |
| YOLO26n-cls | 分类 | 224 | 4.4 0.4 / 4.0 / 0.0 | 3.1 0.8 / 2.1 / 0.2 |
| YOLO26n-pose | 姿态 | 640 | 57.4 1.8 / 53.8 / 1.8 | 16.6 2.7 / 10.1 / 3.9 |
| YOLO26n-obb | OBB | 640 | 50.3 1.8 / 47.2 / 1.4 | 11.7 1.8 / 7.8 / 2.0 |
- 速度值为单图像突发延迟——在
bus.jpg上经过 3 次预热运行后,取 15 次运行的平均值,并使用 Ultralytics Flutter 插件0.6.10和标准化的v0.6.6资源进行测量。CPU/GPU 顺序在一次顺序扫描中于不同任务之间交替。原生日志确认,每个 CPU 行都使用 LiteRT CPU/XNNPACK,每个 GPU 行都将完整计算图委托给 LiteRT OpenCL(LITERT_CL)。 - LiteRT 导出会直接追踪 PyTorch 模型,生成带浮点输入的 NCHW
.tflite——GPU delegate 会编译整个计算图(这里的全部七项任务都在 Adreno GPU 上运行),并且w8a32无需校准数据。使用者应读取张量形状和签名名称,而不是假设采用旧版 onnx2tf NHWC 布局或Identity输出名称;应直接将 RGB 数据按平面 CHW 打包,或在推理前进行转置。语义分割导出会返回 NCHW logits,并需要在主机端执行类别 argmax。官方 Android 资源托管在 yolo-flutter-appv0.6.6release 中,详细基准测试记录请参阅 Flutter 性能文档。 - 匹配的 Snapdragon Hexagon NPU 以及 LiteRT CPU/GPU 数值位于 Qualcomm QNN 集成中。
- 在 CoreML 集成中比较 Apple CPU/加速器结果。
以下设备扫描使用相同的标准化 v0.6.6 资源。
Google Pixel 10#
硬件:Google Pixel 10 配备 12 GB 内存和 Android 16 / API 36。其 3 nm Google Tensor G5 搭载 8 核 CPU(1 个最高 3.78 GHz 的 Prime 核心、5 个最高 3.05 GHz 的 Performance 核心,以及 2 个最高 2.25 GHz 的 Efficiency 核心)、PowerVR D-Series GPU 和 Google TPU。由于 Google 未在链接的规格中公布核心时钟频率和 GPU 驱动名称,因此这些信息读取自基准测试设备。
| 模型 | 任务 | 尺寸 (像素) | CPU w8a32 LiteRT (毫秒) | GPU w8a32 LiteRT (毫秒) |
|---|---|---|---|---|
| YOLO26n | Detect | 640 | 53.3 1.5 / 50.2 / 1.6 | 45.5 3.8 / 37.7 / 4.0 |
| YOLO26n-seg | Segment | 640 | 87.7 1.8 / 78.5 / 7.5 | 50.9 3.0 / 36.9 / 10.9 |
| YOLO26n-sem | 语义分割 | 640 | 68.6 1.5 / 59.0 / 8.0 | 71.6 1.5 / 59.5 / 10.6 |
| YOLO26n-depth | 深度 | 640 | 120.3 1.5 / 112.5 / 6.3 | 52.5 2.0 / 37.5 / 13.0 |
| YOLO26n-cls | 分类 | 224 | 4.0 0.3 / 3.4 / 0.2 | 17.6 0.9 / 16.7 / 0.1 |
| YOLO26n-pose | 姿态 | 640 | 59.7 1.5 / 57.0 / 1.2 | 46.6 3.8 / 39.2 / 3.5 |
| YOLO26n-obb | OBB | 640 | 52.0 1.5 / 48.9 / 1.7 | 45.5 4.0 / 38.5 / 2.9 |
**基准测试:**在 bus.jpg 上预热 3 次后,执行 15 次 predict() 调用并取平均值,使用 ultralytics_yolo、0.6.10 和官方 v0.6.6 资源。CPU/GPU 顺序在一次顺序扫描中于不同任务之间交替。原生日志确认,每个 CPU 行都使用 LiteRT CPU/XNNPACK,每个 GPU 行都将完整计算图委托给 LiteRT OpenCL(LITERT_CL)。
Samsung Galaxy S26#
硬件:Samsung Galaxy S26(SM-S942B)配备 12 GB 内存 和 Android 16 / API 36。其 2 nm Exynos 2600 搭载 10 核 Armv9.3 CPU(1 个最高 3.8 GHz 的 C1-Ultra 核心、3 个最高 3.26 GHz 的 C1-Pro 性能核心,以及 6 个最高 2.76 GHz 的效率 C1-Pro 核心)、Xclipse 960 GPU 和 Samsung NPU。
| 模型 | 任务 | 尺寸 (像素) | CPU w8a32 LiteRT (毫秒) | GPU w8a32 LiteRT (毫秒) |
|---|---|---|---|---|
| YOLO26n | Detect | 640 | 36.7 1.3 / 33.8 / 1.7 | 16.4 1.4 / 12.3 / 2.6 |
| YOLO26n-seg | Segment | 640 | 54.6 1.2 / 48.0 / 5.3 | 32.8 1.3 / 24.5 / 7.0 |
| YOLO26n-sem | 语义分割 | 640 | 47.8 1.2 / 38.4 / 8.1 | 34.2 1.3 / 24.9 / 8.0 |
| YOLO26n-depth | 深度 | 640 | 92.9 1.2 / 84.8 / 6.9 | 33.5 1.3 / 22.4 / 9.8 |
| YOLO26n-cls | 分类 | 224 | 2.7 0.2 / 2.3 / 0.2 | 2.6 0.2 / 2.4 / 0.0 |
| YOLO26n-pose | 姿态 | 640 | 42.8 1.3 / 40.5 / 1.0 | 18.4 1.4 / 14.1 / 2.9 |
| YOLO26n-obb | OBB | 640 | 37.5 1.3 / 35.1 / 1.2 | 18.8 2.5 / 14.6 / 1.8 |
**基准测试:**在 bus.jpg 上预热 3 次后,执行 15 次 predict() 调用并取平均值,使用 ultralytics_yolo、0.6.10 和官方 v0.6.6 资源。CPU/GPU 顺序在一次顺序扫描中于不同任务之间交替。原生日志确认,每个 CPU 行都使用 LiteRT CPU/XNNPACK,每个 GPU 行都将完整计算图委托给 LiteRT OpenCL(LITERT_CL)。
Xiaomi 17T Pro#
硬件:Xiaomi 17T Pro(2602EPTC0G)配备 12 GB LPDDR5X 内存和 Android 16 / API 36。其 3 nm MediaTek Dimensity 9500(MT6993)搭载 8 核 Armv9.3 CPU(1 个最高 4.21 GHz 的 C1-Ultra 核心、3 个最高 3.5 GHz 的 C1-Premium 核心,以及 4 个最高 2.7 GHz 的 C1-Pro 核心)、Mali-G1 Ultra MC12 GPU 和 MediaTek NPU 990。
| 模型 | 任务 | 尺寸 (像素) | CPU w8a32 LiteRT (毫秒) | GPU w8a32 LiteRT (毫秒) |
|---|---|---|---|---|
| YOLO26n | Detect | 640 | 45.4 1.3 / 42.1 / 2.0 | 26.6 1.9 / 22.0 / 2.7 |
| YOLO26n-seg | Segment | 640 | 126.2 2.6 / 113.9 / 9.7 | 46.7 2.6 / 33.3 / 10.8 |
| YOLO26n-sem | 语义分割 | 640 | 117.9 2.6 / 98.8 / 16.5 | 74.3 2.6 / 54.7 / 17.0 |
| YOLO26n-depth | 深度 | 640 | 182.4 2.5 / 167.6 / 12.3 | 47.8 2.5 / 32.3 / 12.9 |
| YOLO26n-cls | 分类 | 224 | 6.2 0.4 / 5.3 / 0.4 | 7.4 0.4 / 6.9 / 0.1 |
| YOLO26n-pose | 姿态 | 640 | 97.6 2.5 / 93.3 / 1.8 | 28.6 2.5 / 23.3 / 2.8 |
| YOLO26n-obb | OBB | 640 | 91.5 2.6 / 85.8 / 3.2 | 27.5 2.7 / 21.8 / 2.9 |
**基准测试:**在 bus.jpg 上预热 3 次后,执行 15 次 predict() 调用并取平均值,使用 ultralytics_yolo、0.6.10 和官方 v0.6.6 资源。CPU/GPU 顺序在一次顺序扫描中于不同任务之间交替。原生日志确认,每个 CPU 行都使用 LiteRT CPU/XNNPACK,每个 GPU 行都将完整计算图委托给 LiteRT OpenCL(LITERT_CL)。
支持的任务#
LiteRT 导出支持 Ultralytics 的全部七项任务。语义分割和深度估计仅适用于 YOLO26,因为它是唯一提供这些检测头的系列。
导出为 LiteRT:转换你的 YOLO 模型#
将模型转换为 LiteRT 格式,可以提高设备端执行效率并拓展部署选项。
安装#
要安装所需的软件包,请运行:
# Install the required package for YOLO
pip install ultralytics如需详细说明和最佳实践,请参阅我们的 Ultralytics 安装指南。如果遇到任何困难,请查阅我们的常见问题指南。
LiteRT 导出目前支持 Linux x86_64 和 macOS。导出的 .tflite 模型本身可运行于所有 LiteRT 支持的平台(移动端、嵌入式设备、边缘设备和浏览器)。
使用方法#
所有 Ultralytics YOLO 模型均开箱即用地支持导出。LiteRT 格式支持 Export、Predict 和 Validate 模式,因此你可以导出模型,然后加载它以在本地运行推理或验证其精度。
from ultralytics import YOLO
# Load a YOLO26 model
model = YOLO("yolo26n.pt")
# Export the model to LiteRT format
model.export(format="litert", imgsz=640) # use imgsz=224 for classificationfrom ultralytics import YOLO
model = YOLO("yolo26n.pt")
# Dynamic INT8: int8 weights, FP32 activations - no calibration data needed
model.export(format="litert", quantize="w8a32", imgsz=640) # use imgsz=224 for classification
# Static INT8: int8 weights + int8 activations - needs calibration data
model.export(format="litert", quantize=8, data="coco8.yaml", imgsz=640) # use 224 for classification
# Static w8a16: int8 weights + int16 activations (higher accuracy) - needs calibration data
model.export(format="litert", quantize="w8a16", data="coco8.yaml", imgsz=640) # use 224 for classificationfrom ultralytics import YOLO
# Load the exported LiteRT model
model = YOLO("yolo26n.tflite")
# Run inference
results = model("https://ultralytics.com/images/bus.jpg")from ultralytics import YOLO
# Load the exported LiteRT model
model = YOLO("yolo26n.tflite")
# Validate accuracy on the COCO8 dataset
metrics = model.val(data="coco8.yaml")导出参数#
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
format | str | 'litert' | 导出模型的目标格式,用于定义其与各种部署环境的兼容性。 |
imgsz | int 或 tuple | 640 | 模型输入所需的图像尺寸。可以使用表示正方形图像的整数,也可以使用元组 (height, width) 指定具体尺寸。 |
quantize | int 或 str | None | 量化精度:8(静态 INT8,int8 权重 + int8 激活值;需要校准 data/fraction)、'w8a16'(静态,int8 权重 + int16 激活值;需要校准 data/fraction)、'w8a32'(动态 INT8,int8 权重 + FP32 激活值;无需校准),或 32/未设置(FP32)。FP16 不会单独导出(见下方说明)。用于替代已弃用的 half/int8 标志。 |
batch | int | 1 | 指定导出模型的批量推理大小,或指定导出模型在 predict 模式下并发处理的最大图像数量。 |
data | str | None | 用于 INT8 校准的数据集 YAML;分类任务则使用数据集目录或内置数据集名称。如果与 quantize=8 或 'w8a16' 一起省略,Ultralytics 会为模型任务选择默认校准数据集。 |
device | str | None | 指定导出所使用的设备。LiteRT 导出在 CPU 上运行(device=cpu)。 |
与旧版 tflite 导出不同,LiteRT 不要求单独导出 FP16。使用 GPU 委托(WebGPU、OpenCL、Metal)时,FP32 .tflite 模型会在运行时以半精度运行——这是 LiteRT 官方采用的 FP16 推理方式。
如需详细了解导出流程,请访问 Ultralytics 导出文档页面。
部署导出的 YOLO LiteRT 模型#
将 Ultralytics YOLO 模型导出为 LiteRT 后,你可以跨平台部署它。要在本地快速验证模型,最简单的方法是使用上文所示的 YOLO("yolo26n.tflite") 方法。要在其他环境中部署,请参阅以下资源:
移动端与嵌入式设备#
- Android:将 LiteRT 集成到 Android 应用中的快速入门指南。
- iOS:在 iOS 应用中集成和部署 LiteRT 模型的指南。
- 嵌入式 Linux 与 Raspberry Pi:在单板计算机上运行 LiteRT 模型,也可以选择使用 Coral Edge TPU 加速。
- 微控制器:在仅有几 KB 内存的 MCU 上进行部署——核心运行时在 Arm Cortex-M3 上约占 16 KB。
浏览器与 Node.js(LiteRT.js)#
- LiteRT.js 概览:借助 WebGPU/WASM 加速,直接在浏览器中运行同一个
.tflite模型,无需服务器端计算,并让数据保留在用户设备上。 - 端到端示例:在移动端、边缘设备和 Web 环境中实现 LiteRT 的实用示例与教程。
总结#
在本指南中,我们介绍了如何将 Ultralytics YOLO 模型导出为 LiteRT 格式。LiteRT 将移动端/边缘设备(以前称为 TFLite)和浏览器(以前称为 TF.js)的部署整合到单个 .tflite 模型中,使你的 YOLO 模型更快、更小,并可移植到几乎所有端侧目标平台。
如需更多详情,请访问 LiteRT 官方文档。
此外,如果你想了解其他 Ultralytics YOLO 集成,请查看我们的集成指南页面,其中有大量实用资源。
常见问题#
使用 Ultralytics 库将 YOLO 模型导出为 LiteRT(
.tflite)。首先,安装软件包:pip install ultralytics然后导出模型:
from ultralytics import YOLO # Load a YOLO26 model model = YOLO("yolo26n.pt") # Export the model to LiteRT format model.export(format="litert", imgsz=640) # use imgsz=224 for classificationCLI 用户:
yolo export model=yolo26n.pt format=litert imgsz=640 # use imgsz=224 for classification如需更多详情,请访问 Ultralytics 导出指南。
LiteRT 是 TensorFlow Lite 的新名称——使用相同的
.tflite模型格式,具有相同的运行时沿革,只是由 Google 重新命名。在 Ultralytics 中,单一的litert导出格式现在涵盖了过去需要两种独立格式的两类用途:- 旧版
tflite格式 → 移动端、嵌入式设备和边缘设备部署。 - 旧版
tfjs格式 → 浏览器和 Node.js 部署,现在由运行相同.tflite文件的 LiteRT.js 处理。
如果你已有
.tflite文件,可以直接使用YOLO("model.tflite")加载它,它将通过 LiteRT 后端运行。- 旧版
可以。将模型导出为 LiteRT 格式,然后在 Raspberry Pi 上运行,以提升推理速度。要进一步优化,可以考虑使用 Coral Edge TPU。详细步骤请参阅我们的 Raspberry Pi 部署指南。
可以。LiteRT.js 可借助 WebGPU/WASM 加速,直接在 Web 浏览器或 Node.js 应用中运行导出的同一个
.tflite模型。这取代了之前的 TensorFlow.js 工作流——不再需要单独的浏览器导出,只需使用 LiteRT.js 运行时部署 LiteRT 模型即可。支持——在运行时支持。FP32 LiteRT 模型在 GPU 委托(WebGPU、OpenCL 或 Metal)上执行时,会自动以 FP16 运行,这是 LiteRT 官方采用的方式。因此,你不需要专门导出 FP16;如需进一步压缩,请使用
quantize=8进行 INT8 量化。