v1.8.1: Stability Fixes
π Summary
RF-DETR 1.8.1 is a patch release with seven bug fixes and three quality-of-life improvements. The highlights: two compatibility crashes are fixed β one hitting environments that have tensorflow alongside NumPy 2.0, another hitting Albumentations 2.x users β and per-epoch metric tables show up again during training instead of being hidden behind the progress bar. No breaking changes, and nothing to migrate from v1.8.0.
ποΈ Notable changes
π± Changed
pathlib.Pathaccepted for path parameters β path fields onTrainConfigand related config classes now acceptpathlib.Pathobjects directly. (#1124)- Horizontal flip disabled for keypoint training β flip augmentation is turned off for keypoint training for now, since it could produce incorrect labels without keypoint flip-pair reordering. (#1122)
- Training metric plots β improved plotting with optional error bands, AP@0.75 grouping, and configurable AP metric groups. (#1122)
π§ Fixed
- TensorBoard + NumPy 2.0 crash β training falls back to CSV logging with a warning instead of crashing when TensorBoard can't be imported. (#1123)
- Albumentations 2.x compatibility β fixed a crash in horizontal-flip detection when using Albumentations 2.x. (#1126)
- Metric tables hidden by the progress bar β per-epoch metric tables now render correctly alongside the live training progress bar. (#1128)
- Keypoint checkpoint selection β best-checkpoint selection for keypoint models is now smoothed, avoiding spurious switches on noisy OKS metrics; smoothing also survives a training resume. (#1122)
- Keypoint encoder evaluation β fixed query routing in eval mode so keypoint predictions are computed correctly. (#1135)
- Group DETR train-time evaluation β fixed a crash during train-time evaluation in Group DETR mode. (#1122)
- DINOv2 backbone config compatibility β internal call sites updated from deprecated
config.use_return_dicttoconfig.return_dict. (#1135)
π Contributors
Thanks to everyone who contributed to this release:
- Jirka Borovec (@Borda, LinkedIn) β keypoint encoder fix, metric table display, training stability, TensorBoard compatibility
- Juan Pablo Oberhauser (@jpoberhauser, LinkedIn) β Albumentations 2.x compatibility
- Brian Cong (@congbrian) β
pathlib.Pathconfig support - Stefan Schneider (@hinogi) β type hint modernisation
Full changelog: 1.8.0...v1.8.1