ultralytics 8.3.188

v8.3.188 - `ultralytics 8.3.188` Faster downloads via a single `request` (#21850)

on Python PyPI

🌟 Summary

Faster, more reliable downloads and smoother developer workflows, plus improved export compatibility and clearer JSON outputs — all wrapped in Ultralytics 8.3.188. 🚀

📊 Key Changes

• Faster downloads via single request flow and smarter disk-space checks (PR #21850 by @glenn-jocher) ⚡
  • Eliminates slow HEAD requests; checks disk only after getting Content-Length.
  • Adaptive buffer size for streaming; precise progress updates.
  • Immediate fail on low disk space to avoid pointless retries.
  • Modernized type hints and cleaner signatures across download utilities.
• Export compatibility updates (PR #21758 by @Y-T-G) 🔄
  • ONNX upper bound removed on Linux/Windows; macOS retains <1.18.0 due to TensorFlow hangs.
  • Updated simplification stack: onnxslim>=0.1.65.
• JSON outputs include file_name for easier traceability (PR #21837 by @olena-hul-dataspan) 🏷️
  • Added "file_name" across RT-DETR, YOLO Detect, and YOLO OBB validators.
• TQDM robustness improvements (PR #21849 by @Laughing-q) 📈
  • Handles total=0 gracefully; richer type hints for better DX.
• Docs developer UX upgrades (PRs #21842 by @glenn-jocher, #21848 by @Laughing-q) 🧰
  • Auto-serve docs after build on macOS and Linux with unified logging.
• Benchmark display polish (PR #21820 by @onuralpszr) 🧪
  • Clear, full, and indexed tables with safe null handling.
• Docs/content touch-ups (PRs #21835 typo fixes, #21841 authors metadata) ✨

🎯 Purpose & Impact

• Speed and reliability: Large model and asset downloads are faster and more robust, improving setup and update times. 🚄
• Fewer dependency conflicts: Relaxed ONNX constraints reduce install friction on Linux/Windows; macOS remains stable. 🧩
• Easier result tracking: Including file_name in predictions.json simplifies mapping outputs back to source images. 🔎
• Better progress feedback: More accurate progress bars and safer behavior for edge cases. ✅
• Smoother docs workflows: Auto-serve on macOS/Linux and consistent logging streamline local documentation development. 🧑‍💻
• Cleaner benchmarks: Readable, complete tables help compare formats and performance at a glance. 📊

Upgrade with:
pip install -U ultralytics

What's Changed

• Update typo in sam-2.md by @Laughing-q in #21835
• Update mkdocs_github_authors.yaml by @glenn-jocher in #21841
• Serve Docs automatically during development by @glenn-jocher in #21842
• Add downloads.py buffer size by @glenn-jocher in #21843
• refactor: ♻️ enhance polars configuration for better benchmark data display by @onuralpszr in #21820
• Add file_name field to predictions.json for better image-annotation alignment by @olena-hul-dataspan in #21837
• Fix TensorFlow export with onnx>=1.18.0 by @Y-T-G in #21758
• Add support of serving docs automatically for Linux by @Laughing-q in #21848
• Fix TQDM progress bars when working with empty sequence by @Laughing-q in #21849
• ultralytics 8.3.188 Faster downloads via a single request by @glenn-jocher in #21850

New Contributors

• @olena-hul-dataspan made their first contribution in #21837

Full Changelog: v8.3.187...v8.3.188