●Change8

Migrating to Weights & Biases v0.28.1

Version v0.28.1 introduces 3 breaking changes. This guide details how to update your code.

Released: 7/16/2026

3
Breaking Changes
2
Migration Steps
18
Affected Symbols

⚠️ Check Your Code

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

protobufwandb.Api().project().sweeps()wandb.Api().run().stop()wandb.Api().organization()wandb.sandboxwandb.Api().runs()RunNotFoundErrorwandb.saveArtifact.files()Artifact.download()Artifact.get_entry()Artifact.get_path()wandb.Api().artifact()GitPythonRun.log()Run.upload_file()wandb.syncwandb beta sync

Breaking Changes

●Issue #1

Support for protobuf v4 has been dropped. Users must now use protobuf v5 or newer.

●Issue #2

Compatibility with W&B server versions older than 0.70.0 has been dropped. Users must upgrade their W&B server to v0.70.0 or newer to continue using artifact download and fetch operations.

●Issue #3

The `GitPython` dependency has been removed. Git metadata is now collected by invoking the `git` executable directly. The `GIT_PYTHON_GIT_EXECUTABLE` environment variable is still honored for locating it.

Migration Steps

  1. 1
    Upgrade your W&B Server to `v0.70.0` or newer to continue using artifact download and fetch operations.
  2. 2
    If you were relying on `GitPython` for Git metadata collection, ensure the `git` executable is available in your system's PATH or set the `GIT_PYTHON_GIT_EXECUTABLE` environment variable.

Release Summary

This release introduces new API features for managing sweeps and organizations, improves error handling for run loading, and removes legacy fallback implementations for artifact operations on older server versions. It also drops support for protobuf v4 and older server versions.

Need More Details?

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

View Full Changelog