ultralytics 8.4.61

v8.4.61 - Fix INT8 ONNX calibration batch mismatch and read-only onnx2tf patching (#24721)

on Python PyPI

🌟 Summary

v8.4.61 is mainly a stability and export reliability release 🛠️, led by an important fix for INT8 ONNX export failures and another fix for read-only onnx2tf patching, with additional improvements to CI, export testing, docs accuracy, and platform documentation.

📊 Key Changes

• 🚨 Fixed INT8 ONNX export crashes on small calibration datasets in PR #24721 by @glenn-jocher

  • Previously, exporting an INT8 ONNX model could fail if the calibration dataset had fewer images than the requested batch size.
  • This especially affected static-batch ONNX exports during quantization.
  • The fix now ensures calibration input batches match what the exported ONNX graph expects.

• 🔒 Fixed read-only onnx2tf patching issues in PR #24721 by @glenn-jocher

  • Another export bug was resolved for environments where files could not be patched because they were read-only.
  • This improves conversion reliability in stricter production or managed environments.

• 🧪 Stronger export validation in CI

  • PR #24663 validates RKNN FP16 and INT8 export paths in CI using yolo26n.pt, helping catch export problems earlier.
  • Several CI workflow updates improve isolated export environments, dependency handling, and reduce flaky test failures on ARM runners.

• 🤖 TensorRT compatibility improvement

  • PR #24647 automatically disables end2end export when using older TensorRT versions that do not support it.
  • This is especially useful for older Jetson setups and avoids hard-to-debug export/runtime failures.

• 🎯 SAM duplicate-mask cleanup fix

  • PR #24688 fixes duplicate suppression in SAM post-processing when removing small regions.
  • This improves mask cleanup for affected SAM workflows.

• 🧠 Semantic segmentation support made clearer across the product

  • Platform docs now consistently describe semantic segmentation as a supported task.
  • Warning messages also now include task=semantic as a valid option.

• 📚 Large documentation and accuracy refresh

  • Many docs, examples, links, and model references were corrected.
  • YOLO26 docs were updated to align with the new paper and current behavior.
  • Platform docs were refreshed to reflect current features, export formats, integrations, and version requirements.

🎯 Purpose & Impact

• ✅ More reliable model export workflows

  • The biggest practical impact is that INT8 ONNX export should now work more reliably, even with small calibration datasets like quick test datasets.
  • This is especially important for users deploying optimized models to edge or production systems.

• 🚀 Fewer production export failures

  • The onnx2tf and ONNX calibration fixes target bugs already seen in real-world error tracking, so this release should reduce export breakages in actual deployments.

• 🧪 Better confidence in deployment formats

  • Expanded CI checks for RKNN, TensorRT, isolated export environments, and related dependencies mean export issues are more likely to be caught before release.

• 📦 Improved compatibility on specialized hardware

  • Users targeting Jetson, Rockchip, ARM systems, or other edge devices should see smoother behavior and fewer environment-specific failures.

• 🧹 Cleaner and more accurate user experience

  • SAM mask handling is improved in specific cases, warning messages are clearer, and docs now better match the actual product behavior.

• 🌍 Better guidance for a broad user base

  • Non-expert users benefit from clearer docs and more dependable defaults, while advanced users get more predictable export and deployment behavior across formats and devices.

In short, v8.4.61 is less about new models and more about making YOLO26 deployment safer, smoother, and more production-ready 🔧📈

What's Changed

• Validate RKNN FP16 export in CI by @glenn-jocher in #24663
• Fix tip case in docs by @lakshanthad in #24669
• Harden ARM CI against runner flakes by @glenn-jocher in #24665
• Sync Platform docs with current implement by @laodouya in #24671
• Update YOLO26 paper citations by @glenn-jocher in #24683
• fix: CLIP pkg_resources import failure on Python 3.8 by @onuralpszr in #24684
• Fix SAM remove_small_regions duplicate suppression by @raimbekovm in #24688
• Clarify YOLOE-26 visual prompt box format by @glenn-jocher in #24690
• Improve docs and docstring accuracy by @glenn-jocher in #24694
• Add 'semantic' to model task warning message by @picsalex in #24702
• Fix broken documentation links by @glenn-jocher in #24708
• Use watch URL for Tiger-Pose video links by @glenn-jocher in #24711
• Automatically disable end2end to be compatible with older versions of TensorRT<8.5.0 by @yzfzzz in #24647
• Fix broken link checker failures by @glenn-jocher in #24713
• Register GPU CI runner image at org level by @glenn-jocher in #24717
• Improve docs, comments, and correctness by @glenn-jocher in #24714
• Fix CLIP test asset cache location by @glenn-jocher in #24720
• Fix INT8 ONNX calibration batch mismatch and read-only onnx2tf patching by @glenn-jocher in #24721

New Contributors

• @yzfzzz made their first contribution in #24647

Full Changelog: v8.4.60...v8.4.61