中文 · 한국어 · 日本語 · Русский · Deutsch · Français · Español · Português · Türkçe · Tiếng Việt · العربية
Ultralytics YOLO 文档#
Ultralytics YOLO 是一系列实时计算机视觉模型,可用于目标检测、实例分割、语义分割、深度估计、分类、姿态估计、有向边界框和跟踪,并通过一个 Python 包和 CLI 提供。YOLO26 基于深度学习和计算机视觉领域的进展构建,支持可选的无 NMS 端到端推理,并针对边缘部署进行了优化。其精简的设计适用于各种应用,也能轻松适配不同的硬件平台,从边缘设备到云 API 均可支持。对于稳定的生产工作负载,建议使用 YOLO26 和 YOLO11。
探索 Ultralytics 文档,全面了解 YOLO 包和 CLI,以及 Ultralytics Platform;该平台基于相同模型,提供数据标注、云端训练和部署功能。无论你是经验丰富的机器学习从业者,还是刚刚入门,这些资源都能帮助你在项目中充分发挥 YOLO 的作用。
如需商业用途,请通过 Ultralytics Licensing 申请企业许可证。
探索 YOLO27 预览版,了解架构详情、初步基准测试结果,以及发布后可供参考的示例。模型正在进行最后阶段的研发,预计将于今年晚些时候推出;目前尚未开放使用,也未确定发布日期。
将单张照片转换为深度图,为每个像素提供以米为单位的距离。
两条命令即可开始#
# Install the ultralytics package from PyPI
pip install ultralytics
# Detect objects in an image with a pretrained YOLO26 model
yolo predict model=yolo26n.pt source='https://github.com/ultralytics/assets/releases/download/v0.0.0/bus.jpg'模型权重和示例图像会自动下载,带标注的结果将保存在命令输出的目录中;首次运行时,该目录为 runs/detect/predict。
查看 快速入门 指南,了解所有安装方式以及如何运行你的首次预测。
你想做什么?#
本文档的组织方式#
大多数模型工作流 yolo 命令都遵循同一种语法 yolo [TASK] MODE ARGS,其中 Task 为可选项;本文档也围绕相同的三个部分组织,并额外提供一个快捷入口:
- 任务回答了你想从图像中获取什么:检测、实例分割、语义分割、深度估计、分类、姿态估计或有向框。
- 模式回答了你如何使用模型:训练、验证、预测、导出、跟踪或基准测试。
- 参数用于配置命令,包括选择要运行的模型(使用
model=),以及设置epochs和imgsz等超参数。 - 解决方案是快捷入口:它提供现成的应用,例如目标计数或安全警报,无需经过 Task 和 Mode。
其他所有内容都围绕这一语法展开:模型列出所有可传递给 model= 的架构——YOLO26、YOLO11、SAM 3、RT-DETR 等;数据集介绍每个 Task 使用的训练数据;指南汇集了丰富的深度教程,涵盖硬件部署、超参数调优、数据集转换和完整项目实践;集成将工作流连接到你已在使用的训练和部署工具;参考部分则记录了 Python API 中的所有类和函数。
除了 Python 包之外,还有两个基于相同模型运行的入口:Ultralytics Platform用于云端标注、训练和部署;Ultralytics Inference则是一个独立的 Rust 库和 CLI,可在不运行 Python 环境的情况下运行导出的模型。
YOLO 许可:Ultralytics YOLO 如何授权?#
Ultralytics 提供两种许可选项,以满足不同的使用场景:
- AGPL-3.0 许可证:这项经 OSI 批准的开源许可证非常适合学生和爱好者,有助于推动开放协作和知识共享。更多详情请参阅 LICENSE 文件。
- 企业许可证:此许可证适用于开发和生产用途,可将 Ultralytics 软件和 AI 模型无缝集成到商业产品和服务中,包括内部工具、自动化工作流和生产部署,同时免除 AGPL-3.0 的开源要求。要开始使用,请通过 Ultralytics Licensing 联系我们。
我们的许可策略旨在确保对开源项目所做的任何改进都能回馈社区。我们相信开源;我们的使命是确保每个人都能以有益于所有人的方式使用和拓展我们的贡献。
常见问题#
使用自己的数据集训练自定义 YOLO 模型,需要完成以下几个步骤:
- 准备好已标注的数据集,并在数据集 YAML 文件中描述该数据集。
- 加载一个预训练模型,例如在 Python 中使用
YOLO("yolo26n.pt")。 - 使用
model.train(data="path/to/dataset.yaml", epochs=100, imgsz=640)启动训练,或在命令行中运行yolo detect train data=path/to/dataset.yaml epochs=100 imgsz=640。
如需详细操作说明,请参阅我们的训练模型指南,其中包含示例以及优化训练流程的技巧。
Ultralytics 为 YOLO 提供两种许可选项:
- AGPL-3.0 许可证:这项开源许可证非常适合教育和非商业用途,并鼓励开放协作。
- 企业许可证:适用于开发和生产用途,包括内部工具、自动化工作流和生产部署,同时免除 AGPL-3.0 的开源要求。
如需了解详情,请访问我们的许可页面。
Ultralytics YOLO 支持高效且可自定义的多目标跟踪。在 Python 中调用
YOLO("yolo26n.pt").track(source="path/to/video.mp4"),或在命令行中运行yolo track source=path/to/video.mp4——两者都支持视频文件、实时流和网络摄像头输入。如需了解如何设置和运行目标跟踪,请参阅我们的跟踪模式文档,其中介绍了实时场景中的配置和实际应用。







