ultralytics 8.4.147

v8.4.147 - Apply Albumentations to grayscale images (#26133)

on Python PyPI

🌟 Summary

Ultralytics v8.4.147 improves preprocessing for grayscale images, strengthens SAM segmentation behavior, and refreshes Platform, installation, and CI documentation. 🚀

📊 Key Changes

• 🖼️ Albumentations now supports grayscale images

  • Albumentations preprocessing runs on images with either 1 channel (grayscale) or 3 channels (color).
  • Images with unsupported channel counts continue to be skipped.
  • This is the primary change in PR #26133 by @onuralpszr.

• 🎯 SAM generation improvements

  • Added min_mask_region_area to SAM generation to remove small mask regions and holes.
  • Corrected crop prompt scaling so prompts cover the full resized crop rather than only part of it.
  • Improved confidence filtering so direct generate() calls behave consistently with normal prediction.
  • Standardized source image shape handling for both image arrays and tensors.
  • Updated SAM documentation with an example using min_mask_region_area.

• 📚 Expanded Platform and agent documentation

  • Added documentation for Platform Agents, including visual workflows, conditions, dataset collection, Slack alerts, execution options, and run monitoring.
  • Added Ask AI Autotraining guidance for dataset exploration, training, model comparison, annotation, export, and deployment.
  • Documented the new platform-cli agent skill and ul cloud workflows.
  • Added guidance for configurable deployment resources and current API-key behavior.

• ⚡ Improved installation and quickstart guidance

  • Reworked the quickstart around installing Ultralytics and running a first prediction with pretrained YOLO26.
  • Moved persistent settings into a dedicated Settings page.
  • Added clearer examples for CLI, Python, Docker, Conda, headless environments, and development installations.

• 🛡️ More reliable downloads

  • safe_download() now makes curl fail on HTTP errors instead of saving an error page as if it were a valid file.
  • This helps surface failed downloads immediately.

• 🧪 Stronger CI and runner environments

  • Re-enabled trusted GPU CI using CUDA 13.2 and TensorRT CUDA 13.
  • Added retry handling for transient APT installation failures.
  • Added GitHub CLI (gh) and jq to CPU and GPU runner images.

🎯 Purpose & Impact

• Better grayscale workflows: Users working with medical, industrial, document, or scientific grayscale imagery can now apply their configured Albumentations transforms during preprocessing. 🩶
• Cleaner SAM results: Small artifacts can be filtered, crop-based prompting is more accurate, and direct SAM generation results are more consistent with standard prediction behavior.
• More dependable tooling: Failed downloads are reported correctly, while updated CI and runner dependencies reduce avoidable workflow failures.
• Easier onboarding: New users can reach a first YOLO26 prediction faster with a simpler quickstart and clearer installation options.
• More accessible Platform automation: The new documentation makes it easier to use Platform Agents, Ask AI, and the Platform CLI for training, dataset management, export, and deployment workflows. 🤖
• No new model family or weights were introduced in this tag: the release primarily delivers preprocessing fixes, SAM enhancements, reliability improvements, and documentation updates.

What's Changed

• Retry apt installs in the isolated export job by @raimbekovm in #26122
• Add https://youtu.be/ZsxHIN2PoiY to docs by @RizwanMunawar in #26124
• Fix curl downloads saving HTTP error pages as valid files by @lakshanthad in #26126
• Enable GPU CI on CUDA 13 runners by @glenn-jocher in #26127
• Install GitHub CLI in CPU and GPU runner images by @glenn-jocher in #26131
• Install jq in CPU and GPU runner images by @glenn-jocher in #26134
• Document the Platform CLI agent skill by @JaviChulvi in #26136
• Document Platform Agents visual workflows by @glenn-jocher in #26135
• Document Platform Autotraining with Ask AI by @JaviChulvi in #26137
• Add min_mask_region_area to SAM generate() and scale crop point prompts to the resized crop by @raimbekovm in #26129
• Rewrite quickstart around installation and a first prediction by @raimbekovm in #26128
• Apply Albumentations to grayscale images by @onuralpszr in #26133

Full Changelog: v8.4.146...v8.4.147