●Change8

Migrating to Weights & Biases v0.23.1

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

Released: 12/3/2025

1
Breaking Changes
5
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

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

wandb.Apiwandb.ImageRegistry.descriptionArtifactCollection.descriptionArtifactwandb.Run.saveArtifactCollection.aliaseswandb.initconsole_captureRun.beta_history_scan

Breaking Changes

●Issue #1

wandb.Api() now raises a UsageError when WANDB_IDENTITY_TOKEN_FILE is set without an explicit API key, causing code that relied on automatic token authentication to fail. Fix by providing an API key via wandb.Settings(api_key=...), the WANDB_API_KEY environment variable, or removing the token file.

Migration Steps

  1. 1
    If you set WANDB_IDENTITY_TOKEN_FILE, provide an explicit API key via wandb.Settings(api_key=...), the WANDB_API_KEY environment variable, or remove the token file.
  2. 2
    Remove usage of anonymous mode flags and settings; switch to authenticated runs.
  3. 3
    No action required for wandb.Image() deprecation warning removal.
  4. 4
    If your code relied on immediate fetching of ArtifactCollection.aliases, adjust to handle lazy loading (generally no change needed).
  5. 5
    Ensure any custom file upload logic accounts for WANDB_X_EXTRA_HTTP_HEADERS being applied, except for reference artifacts.

Release Summary

This release adds regex filtering and chart inspection to the LEET TUI, expands the automations API, introduces a beta_history_scan method, deprecates anonymous mode, and includes several performance and bug fixes.

Need More Details?

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

View Full Changelog