New Release: Ultralytics v8.4.115

Discussion
, ,
1

:rocket: Ultralytics v8.4.115: A Streamlined Platform Experience

Ultralytics v8.4.115 transitions legacy HUB integrations to the streamlined Ultralytics Platform experience, introducing validated CLI authentication, safer settings migration, cleaner training workflows, updated documentation, and expanded tests.

:glowing_star: New Features

:locked_with_key: Validated Platform CLI authentication

Authentication is now simpler and more secure. Log in using a Platform API key:

yolo login YOUR_API_KEY

API keys are validated against the Platform before being saved. To remove stored credentials, run:

yolo logout

:counterclockwise_arrows_button: Automatic settings migration

Settings now migrate to schema 0.0.7 during upgrades:

  • Compatible custom dataset and run directories are preserved.
  • Legacy HUB configuration is removed automatically.
  • Incompatible HUB API keys are discarded.
  • Users with outdated credentials are guided toward creating a Platform API key.

:high_voltage: Improvements

:brain: Leaner model and training workflows

This release removes legacy HUB session management from model and trainer workflows:

  • Models no longer load directly from HUB URLs.
  • Training no longer manages HUB sessions, remote checkpoints, heartbeats, or HUB-specific arguments.
  • Platform callbacks remain available for streaming training information.

These changes reduce integration complexity and make the training codebase easier to maintain.

:books: Updated documentation and examples

Guides, notebooks, CLI help, quickstarts, and API documentation now reference the Ultralytics Platform instead of HUB. The updated experience makes it easier to annotate datasets, train models, export deployments, and monitor results in one place.

:broom: Legacy HUB Removal

The legacy ultralytics.hub package has been removed, including:

  • HUB authentication and remote training sessions
  • HUB model loading and exports
  • Dataset utilities and callbacks
  • HUB-specific exceptions
  • Related API references, documentation pages, navigation entries, and example notebooks

:warning: Compatibility note: Applications importing ultralytics.hub, loading models from HUB URLs, using HUB training sessions, or relying on HUB-specific utilities must migrate to Ultralytics Platform workflows.

:white_check_mark: Testing and Reliability

Test coverage has been expanded for:

  • Settings migration
  • API-key validation
  • CLI login behavior
  • CLI logout behavior

This helps ensure safer upgrades while preserving compatible user configuration.

:raising_hands: Contributor Spotlight

This release was delivered through PR #25608: Deprecate HUB in favor of Ultralytics Platform, contributed by @sergiuwaxmann. Thank you for helping simplify and modernize the Ultralytics experience! :tada:

:package: Try v8.4.115

Upgrade to the latest release:

pip install -U ultralytics

Then create a Platform API key and authenticate:

yolo login YOUR_API_KEY

You can review the complete changes in the v8.4.114 to v8.4.115 changelog or visit the Ultralytics v8.4.115 release page for release details.

Give v8.4.115 a try and share your feedback, migration experience, or any issues you encounter with the community. :rocket: