There is a newer version of the record available.

Published April 20, 2026 | Version v8.4.40
Software Open

Ultralytics YOLO

  • 1. Ultralytics

Description

๐ŸŒŸ Summary

Ultralytics v8.4.40 introduces per-image precision/recall/F1 tracking during validation (led by PR #24089 from @Laughing-q), making it much easier to see exactly which images your model handles well or poorly. ๐Ÿ“ˆ๐Ÿ–ผ๏ธ

๐Ÿ“Š Key Changes

  • New per-image validation metrics added to results:
    • precision, recall, f1, tp, fp, fn for each image.
    • Exposed via metrics.box.image_metrics (and also for seg and pose where applicable). โœ…
  • Detection validation pipeline updated to store image name and compute image-level stats consistently with validation matching logic. ๐Ÿ”
  • Distributed (multi-GPU) validation support now gathers and merges image_metrics correctly across ranks, so results remain complete in larger training setups. ๐Ÿง โš™๏ธ
  • Metrics classes extended with:
    • image_metrics storage
    • update helpers
    • clear/reset helpers to prevent stale metrics between runs.
  • Docs updated across validation/task guides (detect, segment, pose, OBB, insights, custom trainer) with examples showing how to access per-image metrics. ๐Ÿ“š
  • Version bump:
    • 8.4.39 โžœ 8.4.40 ๐Ÿš€

๐ŸŽฏ Purpose & Impact

  • Faster debugging of weak samples: You can now pinpoint problematic images directly instead of relying only on dataset-wide averages. ๐ŸŽฏ
  • Better dataset curation: Find images causing high false positives/false negatives and decide whether to relabel, augment, or rebalance. ๐Ÿงน
  • More actionable model evaluation: Teams get practical, image-level insight for error analysis and iterative improvement. ๐Ÿ”
  • Reliable at scale: Works cleanly in multi-GPU validation, so enterprise and research workflows benefit too. ๐Ÿ—๏ธ
  • Broad usability: Useful for both beginners and advanced users working with YOLO models, especially YOLO26 validation workflows. ๐Ÿค

What's Changed

  • ultralytics 8.4.40 Per-image Precision and Recall by @Laughing-q in https://github.com/ultralytics/ultralytics/pull/24089

Full Changelog: https://github.com/ultralytics/ultralytics/compare/v8.4.39...v8.4.40

Notes

If you use this software, please cite it using the metadata from this file.

Files

ultralytics/ultralytics-v8.4.40.zip

Files (2.9 MB)

Name Size Download all
md5:ad23c9009722c5beae8552dc6d13ab0a
2.9 MB Preview Download

Additional details

Related works