●Change8

Migrating to Weights & Biases v0.21.2

Version v0.21.2 introduces 1 breaking change. This guide details how to update your code.

Released: 8/28/2025

1
Breaking Changes
4
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

Artifact.linkRun.link_artifactwandb.integration.weavemax_end_of_run_history_metricsmax_end_of_run_summary_metrics

Breaking Changes

●Issue #1

`Artifact.link()` and `Run.link_artifact()` now raise errors instead of silently failing and no longer return `None`. Code that relied on a `None` return must catch the exceptions or check for success.

Migration Steps

  1. 1
    Update any code that expects `Artifact.link()` or `Run.link_artifact()` to return `None` to handle raised exceptions instead.
  2. 2
    If you rely on the previous silent-failure behavior, add explicit error handling around these calls.
  3. 3
    Ensure your W&B server is version 0.74.0 or newer to benefit from the performance improvements.
  4. 4
    Optionally configure the new settings `max_end_of_run_history_metrics` and `max_end_of_run_summary_metrics` if you need a different limit than the default of 10.

Release Summary

This update introduces new run-metric limits and a Weave integration, makes linking artifacts raise errors instead of returning `None` (a breaking change), and fixes config dataclass serialization and artifact-link performance.

Need More Details?

View the full release notes and all changes for Weights & Biases v0.21.2.

View Full Changelog