ultralytics 8.3.232

v8.3.232 - `ultralytics 8.3.232` Fix OBB NMS export lower box count (#22783)

on Python PyPI

🌟 Summary

Ultralytics 8.3.232 is a small but important release that fixes OBB export behavior for more reliable deployments, improves ARM64 Docker images, and significantly polishes documentation UX, search, and SAM 3 docs. 🚀

📊 Key Changes

• 🚧 OBB export fix (core model behavior)

  • Updates OBB (Oriented Bounding Box) export logic in ExporterDetectionModel.forward.
  • Uses a fixed multiplier of 8 for OBB NMS instead of scaling by the number of classes.
  • Keeps non-OBB models unchanged (still normalized by number of classes for formats like TFLite).

• 🐧 Docker: ARM64 image modernized

  • Switches ARM64 Docker base from arm64v8/debian:bookworm-slim to arm64v8/ubuntu:24.04.
  • Uses apt with apt upgrade -y for up-to-date, more secure images.

• 🧮 GPU/cuDNN compatibility helper

  • Adds a ready-to-run Python snippet in yolo-common-issues.md to check:
    • GPU compute capability
    • cuDNN version
    • Whether the combo is likely compatible (especially for older GPUs like GTX 1080 Ti).

• 📚 SAM 3 documentation aligned with Meta’s release

  • Updates SAM 3 docs to reflect that Meta has officially released SAM-3.
  • Clarifies Ultralytics integration is in progress and that usage will remain via pip install ultralytics.
  • Marks all examples as API previews until integration lands.

• 🔍 Docs search experience upgrade

  • Adds a custom, chat-powered search button to the docs header with OS-aware hotkey hints (⌘K / Ctrl+K).
  • Hides the default MkDocs search UI in favor of the Ultralytics chat-based search.
  • Introduces theme-aware CSS variables for search styling (light/dark mode).
  • Optimizes search button layout and behavior on mobile (icon-only, touch-friendly).

• 🧭 Docs navigation & links cleanup

  • Standardizes TOC link rewriting for .md files; converts them to trailing-slash internal paths.
  • Updates YOLO history and homepage to link internally (e.g., models/yolov5.md).
  • Cleans and clarifies nav labels (e.g., “Modes:”, “Tasks:”, “Models:”, “HUB:”).

• 📊 Mermaid diagrams in docs

  • Enables Mermaid support via pymdownx.superfences configuration in mkdocs.yml.
  • Allows rich diagrams (flowcharts, sequence diagrams, etc.) in docs using fenced ```mermaid blocks.

• 📘 Docs build & UI tweaks

  • Removes --strict from zensical build to reduce build failures on minor warnings.
  • Hides the Weglot language switcher via CSS to simplify the docs UI.
  • Adds author metadata for new contributors in mkdocs_github_authors.yaml.

🎯 Purpose & Impact

• More reliable OBB deployments 🧱

  • Fixes under-detection issues for exported OBB models, especially under int8 quantization (e.g., TFLite).
  • Ensures NMS behaves consistently after export, giving more predictable box counts and better downstream performance.

• Smoother cross-platform usage & CI 🧪

  • Updated ARM64 Docker base improves compatibility, security, and stability on Apple Silicon, Raspberry Pi, and other ARM hardware.
  • More robust docs build (no --strict) reduces CI friction and local build failures.

• Simpler troubleshooting for GPU issues 🔧

  • Users with older GPUs can quickly see if their card is supported by their cuDNN/PyTorch stack.
  • Cuts down on guesswork and support load related to CUDA/cuDNN compatibility problems.

• Better documentation experience 📖

  • Chat-powered search with tailored examples makes it easier to find answers on YOLO11, custom training, exports, and more.
  • Mermaid diagram support and cleaned-up navigation make complex topics easier to understand and explore.
  • SAM 3 docs now clearly signal current status: Meta released, Ultralytics integration coming soon, with preview APIs shown.

Overall, 8.3.232 is a stability and UX-focused release: production users gain a critical OBB export fix, while everyone benefits from better docs, search, and environment support. ✨

What's Changed

• Fix TOC *.md links by @glenn-jocher in #22768
• Ultralytics chat.js search in Docs by @glenn-jocher in #22769
• fix: 🐞 dark mode styles for search button in CSS by @onuralpszr in #22771
• fix: 🐞 remove unsupported strict mode flag from Zensical build command in documentation script by @onuralpszr in #22770
• Docs Mermaid diagram support by @glenn-jocher in #22773
• Docs search bar mobile fix by @glenn-jocher in #22774
• Fix Zensical navigation by @glenn-jocher in #22775
• fix: 🐞 update Dockerfile to use Ubuntu 24.04 LTS and streamline package installation commands by @onuralpszr in #22763
• Add GPU/cuDNN compatibility check to yolo-common-issues.md by @akdanz in #22779
• SAM3 docs update by @glenn-jocher in #22784
• Update style.css for language switcher by @glenn-jocher in #22788
• ultralytics 8.3.232 Fix OBB NMS export lower box count by @Y-T-G in #22783

New Contributors

• @akdanz made their first contribution in #22779

Full Changelog: v8.3.231...v8.3.232