●Change8

v0.28.1

Breaking Changes
📦 weights-biasesView on GitHub →
⚠ 3 breaking✨ 4 features🐛 10 fixes🔧 18 symbols

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.

⚠️ Breaking Changes

  • Support for protobuf v4 has been dropped. Users must now use protobuf v5 or newer.
  • 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.
  • 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. Upgrade your W&B Server to `v0.70.0` or newer to continue using artifact download and fetch operations.
  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.

✨ New Features

  • Added a `filters` parameter to `Api().project().sweeps()` that matches the runs filter format.
  • Added `Run.stop()` to the public API (`wandb.Api().run(...).stop()`) to programmatically request that an active run stop gracefully.
  • Added `wandb.Api().organization()` to fetch an `Organization` by name, or the current default organization for the user.
  • The `wandb.save` function now has an option `glob=False` that disables glob expansion for file paths.

🐛 Bug Fixes

  • Temporary Unix socket files and directories are now removed on shutdown.
  • `wandb beta sync` now skips online runs by default, matching `wandb sync` behavior.
  • `wandb sync` now routes to `wandb beta sync` for supported parameter sets. The original behavior can be restored with `--legacy`.
  • `wandb.sandbox` now defaults serverless sandboxes to a 12-hour max lifetime, which can be overridden.
  • `wandb.Api().runs()` now raises a `RunNotFoundError` when unable to load data for a run (e.g., if a run is deleted before fully loading).
  • Saving a linked registry artifact no longer fails when the caller lacks write access to the source project.
  • `np.float16`/`np.float32` NaN values logged with `Run.log()` are now recorded as `NaN` instead of being silently dropped.
  • `Run.upload_file()` now registers the uploaded file with the run on self-hosted servers.
  • Sweep agents will now allow the in-progress run to complete before exiting when the sweep is deleted or Api() returns 404.
  • Fixed some deadlocks introduced in 0.25.1, which were reported when using PyTorch with Python < 3.14 or during GC with some `wandb.Api` functionality.

Affected Symbols

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