🌟 Summary
Improved training progress bars for Rich TQDM users, plus robustness and CI/documentation polish for a smoother overall experience. 🎛️✨
📊 Key Changes
- Progress bars (priority)
- Fixed Rich-based TQDM bars to always render clearly: Console width set to 200 and bar width set to 10 when
YOLO_TQDM_RICH=true
. ✅ - Resolves missing or truncated bars seen at width 80 in some terminals/CI/Colab.
- Version bump to 8.3.185.
- Fixed Rich-based TQDM bars to always render clearly: Console width set to 200 and bar width set to 10 when
- Data loading reliability
YOLODataset
now defaults to 3 image channels (RGB) if not provided.yolo_bbox2segment()
explicitly setschannels=3
to avoid missing-key errors.
- CI improvements
- GPU CI job switches to uv for environment management:
uv pip install
anduv pip list
. - Removes extra installs (e.g.,
pynvml
,tensorrt
,onnxruntime-gpu
) to streamline runs.
- GPU CI job switches to uv for environment management:
- Docs and maintenance
- Updated link-check workflow to correctly exclude CI files.
- Clarified
SystemLogger.get_metrics()
docstring with accurate Python examples. - Neural Magic integration links now point to internal docs for a smoother reading experience.
🎯 Purpose & Impact
- Better UX for progress tracking
- Rich TQDM users get consistent, readable progress bars across terminals and notebooks. 🙌
- Default users are unaffected unless
YOLO_TQDM_RICH=true
is set.
- More robust workflows
- Prevents crashes when dataset channel info is missing; safer bbox-to-segmentation conversion. 🛡️
- Faster, cleaner CI
- Quicker, more reproducible tests with uv; note some GPU backend tests may have reduced coverage. ⚡
- Clearer docs
- Easier navigation and more accurate examples for contributors and users. 📚
Enable Rich progress bars:
- CLI:
YOLO_TQDM_RICH=true yolo train ...
- Python:
import os
os.environ["YOLO_TQDM_RICH"] = "true"
from ultralytics import YOLO
YOLO("yolo11n.pt").train(data="coco8.yaml", epochs=1)
See the Ultralytics Docs for details: https://docs.ultralytics.com 🚀
What's Changed
uv pip install
GPU CI requirements by @Laughing-q in #21776- Update links.yml for Lychee v0.20.0 by @glenn-jocher in #21779
- Fix SystemLogger docstring by @glenn-jocher in #21788
- Fix data loading in
yolo_bbox2segment
by @Y-T-G in #21772 - Remove
neuralmagic
blog redirect fromintegration
page by @RizwanMunawar in #21787 - Fix TQDM Rich bars to 10 width by @glenn-jocher in #21789
Full Changelog: v8.3.184...v8.3.185