New Release: Ultralytics v8.4.165

[glenn-jocher]

Ultralytics v8.4.165 is here

Quick overview: This release makes Ultralytics YOLO easier to install and more dependable to export and run. It also improves depth and semantic outputs, protects dataset files during conversion, and fixes several vision utilities. Explore the v8.4.165 release for the full release entry.

Installation and deployment

• Python wheels no longer install a top-level tests package that could conflict with other projects. Tests remain available in the source distribution for Conda builds — #26408 by @Y-T-G.
• ONNX export now checks the minimum supported opset before exporting and gives a clearer error when the requested opset is too low — #26396 by @onuralpszr.
• Windows OpenVINO inference avoids a CPU instruction path that could crash on some machines — #26403 by @glenn-jocher. Related Windows OpenVINO and CI runtime-warning fixes are in #26317, also by @glenn-jocher.

Model outputs and dataset reliability

• Depth export and prediction resizing now use the alignment convention applied during training and validation — #26393 by @cainiao33.
• Semantic validation masks are saved at the original image size without letterbox padding — #26385 by @Nicholas022400701. Mask cropping also handles odd padding correctly — #26379 by @Nicholas022400701.
• Dataset scanning now flags semantic masks with unmapped class IDs — #26392 by @cainiao33.
• Label parsing skips whitespace-only lines — #26391 by @cainiao33. Duplicate-segment checks compare polygons rather than just bounding boxes, preserving distinct shapes — #26377 by @Nicholas022400701.
• Classification auto-splits remain deterministic across reruns — #26387 by @MohammadHijjawi97. Custom spatial Albumentations lists also work with older Albumentations releases — #26399 by @raimbekovm.
• Multispectral conversion keeps original images when an output collides or cannot be written — #26406 by @Vaishnavi220506.
• COCO conversion creates label subfolders for nested image paths — #26388 by @MohammadHijjawi97. LVIS image lists now use paths relative to the list file — #26390 by @MohammadHijjawi97.
• TXT and CSV prediction sources ignore empty paths — #26371 by @aswanth-07. File checks also treat unreadable paths as missing — #26382 by @glenn-jocher.

Vision utilities

• Flips of left-top-width-height instance boxes are corrected — #26397 by @Nikhi00718.
• Tracked pose keypoints retain their track-ID colors in Results.plot instance mode — #26389 by @MohammadHijjawi97.
• DistanceCalculation selects one object per click — #26402 by @MohammadHijjawi97. Analytics area charts now keep class histories correctly associated — #26386 by @MohammadHijjawi97.

Documentation and CI

• Ultralytics Platform guidance now covers annotator panning, face blurring, and similar-image search — #26401 by @raimbekovm.
• The Ascend export table corrects its Ascend310B1/B4 device mapping — #26394 by @Tsingxuan. Welcome to first-time contributor @Tsingxuan!
• World trainer documentation names the grounding data format and explains the empty background class — #26398 by @raimbekovm.
• Contributor guidance is refreshed — #26381 by @glenn-jocher. CI also updates its Actions runner — #26375 by @glenn-jocher — and fails faster when an xdist worker crashes — #26405 by @glenn-jocher.

Give v8.4.165 a try and let us know what you see in your installation, export, inference, or dataset workflows. Your feedback helps the YOLO community and Ultralytics team keep improving the release.