yolort实战教程：如何轻松部署YOLOv5模型到TensorRT加速推理

【免费下载链接】yolortyolort is a runtime stack for yolov5 on specialized accelerators such as tensorrt, libtorch, onnxruntime, tvm and ncnn.项目地址: https://gitcode.com/gh_mirrors/yo/yolort

yolort是一个专为YOLOv5设计的运行时框架，能够将模型高效部署到TensorRT、libtorch、onnxruntime等专用加速器上，实现快速推理。本教程将带你一步步完成YOLOv5模型到TensorRT的部署过程，让你轻松掌握模型加速推理的关键技能。

🚀 为什么选择TensorRT加速YOLOv5？

TensorRT是NVIDIA推出的高性能深度学习推理SDK，通过优化神经网络模型、量化精度和层融合等技术，能够显著提升模型的推理速度。对于实时性要求高的YOLOv5目标检测任务，使用TensorRT加速可以带来以下优势：

• 更快的推理速度：相比原生PyTorch推理，TensorRT加速可提升2-5倍性能
• 更低的延迟：优化后的引擎减少了推理时间，适合实时应用场景
• 更高的吞吐量：能够同时处理更多输入，提高系统整体效率

📋 准备工作与环境配置

在开始部署前，请确保你的系统满足以下要求：

系统要求

• TensorRT 8.2+
• OpenCV
• CUDA与cuDNN（需与TensorRT版本匹配）
• Python 3.6+（用于模型转换）

快速安装yolort

首先克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/yo/yolort cd yolort

安装所需依赖：

pip install -r requirements.txt

🔄 模型转换：从YOLOv5到TensorRT引擎

步骤1：导出TensorRT引擎文件

yolort提供了便捷的模型导出工具，可以直接将训练好的YOLOv5模型转换为TensorRT引擎。使用以下命令导出：

python tools/export_model.py --checkpoint_path {path/to/your/best.pt} --include engine

注意：如果你的环境中安装了完整的TensorRT Python库，上述命令将直接生成ONNX模型和TensorRT引擎文件。否则只会生成带".trt.onnx"后缀的ONNX模型，这时你需要使用TensorRT提供的trtexec工具手动转换：

trtexec --onnx=best.trt.onnx --saveEngine=best.engine --workspace=8192

步骤2：验证导出的TensorRT引擎

导出完成后，可以使用Python接口快速测试引擎是否正常工作：

import torch from yolort.runtime import PredictorTRT # 加载TensorRT引擎 engine_path = "best.engine" device = torch.device("cuda") y_runtime = PredictorTRT(engine_path, device=device) # 对图片进行推理 predictions = y_runtime.predict("test/assets/bus.jpg")

🏗️ 构建C++推理程序

对于生产环境，推荐使用C++接口进行部署，以获得更高的性能。

步骤1：配置构建环境

首先需要准备OpenCV和TensorRT的库文件：

• 编译OpenCV库
• 下载并安装CUDA、cuDNN和TensorRT

步骤2：编译yolort TensorRT项目

创建构建目录并编译：

cd deployment/tensorrt mkdir -p build && cd build cmake -DTENSORRT_DIR={path/to/your/TensorRT/install/directory} -DOpenCV_DIR={path/to/your/OpenCV_BUILD_DIR} .. cmake --build .

Windows用户注意：编译完成后，需要将以下依赖的动态链接库复制到可执行文件目录：

• CUDA和cuDNN相关：cudnn_cnn_infer64_8.dll、cudnn_ops_infer64_8.dll等
• OpenCV相关：opencv_corexxx.dll、opencv_imgcodecsxxx.dll等

🖼️ 运行推理并查看结果

使用编译好的可执行文件进行图片推理：

./yolort_trt --image test/assets/bus.jpg \ --model_path best.engine \ --class_names notebooks/assets/coco.names

测试图片展示

下面是使用TensorRT加速推理的示例图片：

🧩 YOLOv5模型结构解析

了解模型结构有助于更好地理解部署过程。yolort中的YOLOv5模型结构如下：

该结构包含以下主要组件：

• Backbone：特征提取网络
• PAN：路径聚合网络，用于多尺度特征融合
• YOLOHead：检测头，负责生成边界框和类别概率
• AnchorGenerator：锚框生成器
• PostProcess：后处理模块，包括NMS等操作

📚 相关资源与参考文档

• 项目官方文档：docs/source/index.rst
• TensorRT部署代码：deployment/tensorrt/
• 模型导出工具：tools/export_model.py
• 推理运行时代码：yolort/runtime/y_tensorrt.py

🔍 常见问题解决

Q: 导出TensorRT引擎时提示内存不足怎么办？

A: 可以通过增加--workspace参数的值来分配更多的工作空间，如--workspace=16384（16GB）。

Q: 推理结果与PyTorch不一致如何处理？

A: 确保使用相同的输入尺寸和预处理方式，可参考yolort/runtime/transform.py中的预处理代码。

Q: 如何在Windows系统上编译项目？

A: 在cmake命令中添加-G "Visual Studio 16 2019"参数指定VS版本，然后使用生成的解决方案文件进行编译。

通过本教程，你已经掌握了使用yolort将YOLOv5模型部署到TensorRT的完整流程。现在你可以将自己训练的YOLOv5模型部署到生产环境，享受TensorRT带来的加速效果！

【免费下载链接】yolortyolort is a runtime stack for yolov5 on specialized accelerators such as tensorrt, libtorch, onnxruntime, tvm and ncnn.项目地址: https://gitcode.com/gh_mirrors/yo/yolort