wandb

What's Changed

Notable Changes

• Removed the deprecated start_method setting that already had no effect.
• The .length property on paginated objects (e.g. Api.runs(), Api.sweeps(), run.files()) has been removed. Use len(...) instead.
  wandb.Video() now requires the format argument when initializing from a numpy array or raw bytes.
• Removed the deprecated summary="best" option and goal argument of run.define_metric(). Use summary="min" or summary="max" instead.
• Removed the deprecated quiet argument of run.finish() and wandb.finish(). Use wandb.Settings(quiet=...) instead.
• Removed the deprecated run.project_name(), run.get_url(), run.get_project_url(), and run.get_sweep_url() methods. Use the run.project, run.url, run.project_url, and run.sweep_url properties instead.
• wandb.Image no longer normalizes pixel values. Callers must now ensure their data already falls within the range [0, 255].
• On macOS, wandb now requires macOS 13 (Ventura) or newer.

Added

• Added run.console_logs() to the public API for reading the console output that W&B captured for a run — the whole log, or only the last N lines with run.console_logs(last=N), for finished and still-running runs alike. Reading from the beginning requires W&B Server 0.77 or newer (@dmitryduev in #12442)
• The automations API now supports team and organization scopes. (@tonyyli-wandb in #12197, #12194)
• The automations API now supports creating and editing automations whose scope is a Registry object (@tonyyli-wandb in #10867)
• Press g in LEET to draw guides behind line charts: a dotted background or horizontal lines aligned with the axis ticks. The choice is saved and can also be set with chart_guides in wandb leet config. (@dmitryduev in #12463)
• Drag the separator lines between LEET's run overview sections to resize them with the mouse. The proportions are saved per view; press 0 to reset them along with the other pane sizes (@dmitryduev in #12525)
• Registry API version queries (Api.registries().versions(), Api.registries().collections().versions(), Registry.versions(), Registry.collections().versions()) now accept an optional order string as a keyword argument for organizations with advanced search. The API supports ordering versions by created_at, artifact_size, and linked_at (@amusipatla-wandb in #12489)
• Added Artifact.linked_at which returns when the version was linked to the relevant portfolio. This is valid only for linked versions, and for source artifacts returns None (@amusipatla-wandb in #12490)
• wandb.Artifact now accepts a digest_algorithm argument ("MD5" or "XXH128", defaulting to "MD5"). Passing digest_algorithm="XXH128" opts the artifact into XXH128 hashing when possible. For artifacts created with digest_algorithm="XXH128", artifact.verify() will fail for SDK versions older than 0.29.0. (@amusipatla-wandb in #12564)
• wandb leet inspect [PATH] browses the raw records in a run's .wandb transaction log: a filterable list of every record next to a text view of the selected one, following live runs as they write. Press i in LEET's single-run view to open it for the current run, and pipe or redirect to print the records instead, e.g. wandb leet inspect | less. (@dmitryduev in #12547, #12548, #12549)

Changed

• The run overview sections in LEET (Environment, Config, Summary) now share the sidebar height proportionally and use all of the available space; previously they stopped growing at fixed sizes, leaving the bottom of tall terminals empty (@dmitryduev in #12523)
• Api.{create,update}_automation() now raise UnsupportedError instead of CommError when the server doesn't support the given automation (@tonyyli-wandb in #12194)
• The message format used to communicate between internal processes has slightly changed. If you use wandb beta core, restart the service after upgrading wandb, as some operations may fail if the SDK and service versions differ. (@tonyyli-wandb in #12374)
• wandb.sandbox now allows GPU resource requests for sandboxes instead of rejecting resources.gpu client-side (@nicholaspun-wandb in #12455)
• Registry search methods (Api.registries(), .collections(), .versions()) now validate filter field names, rejecting unsupported field names. (@tonyyli-wandb in #12182)
• wandb.Video() now requires the format argument when initializing from a numpy array or an io object. (@jacobromero in #12579)
• The macOS wheels now require macOS 13 (Ventura) or newer; macOS 12 reached end of life in 2024 (@dmitryduev in #12599)

Removed

• Removed wandb.tensorboard.log() / wandb.tensorflow.log() (@timoffex in #12423)
• The deprecated start_method setting that already had no effect (@dmitryduev in #12581)
• Removed the deprecated .length property from wandb.apis.paginator.SizedPaginator. Use len(...) instead (@jacobromero in #12575)
• The deprecated summary="best" option and goal argument of run.define_metric(); use summary="min" or summary="max" instead (@dmitryduev in #12583)
• The deprecated quiet argument of run.finish() and wandb.finish(); use wandb.Settings(quiet=...) instead (@dmitryduev in #12584)
• The deprecated run.project_name(), run.get_url(), run.get_project_url(), and run.get_sweep_url() methods; use the run.project, run.url, run.project_url, and run.sweep_url properties instead (@dmitryduev in #12585)
• Removed deprecated normalize argument from wandb.Image; callers should ensure pixel values for NumPy arrays and PyTorch tensors already fall in the range [0, 255] (@jacobromero in #12574)

Fixed

• Artifact.new_file now works for artifacts uploaded with wandb sync (@amusipatla-wandb in #12437)
• At certain pane widths, such as while dragging a sidebar edge, LEET drew metric charts wider than the space available, pushing the right sidebar off screen (@dmitryduev in #12513)
• wandb leet config now works on short terminal windows: the field list scrolls with the selection and Space toggles boolean settings (@dmitryduev in #12529)
• Run.scan_history(keys=...) no longer fails for runs with nested values. (@mameikagou in #12542)
• LEET media panels painted black bars around images in the ANSI view and flashed black when switching to the full-res view; the area around the image now shows the terminal background and mode switches no longer flash or move the image (@dmitryduev in #12569)

Security

• Reject file or artifact name that contain relative path when downloading artifacts via artifact.files(), artifact.checkout() (@pingleiwandb in #12516)

What's Changed

Notable Changes

The wandb sync --clean command now exits with code 1 and prints a hint to use wandb clean, which is the replacement.
wandb login now verifies credentials by default. This can be disabled with wandb login --no-verify or programmatically with wandb.login(verify=False).

Added

• Added support for gzip compression of filestream requests, reducing network traffic when logging metrics. It is currently opt-in and requires server support: set x_file_stream_no_gzip=False in wandb.Settings to enable it. Compression will become the default in a future release (@dmitryduev in #12262)
• Added a --term-timeout flag to wandb agent (@nathancy-wandb in #12246)
• Added run.sync_dir (@timoffex in #12319)

Changed

• The new wandb clean command replaces wandb sync --clean (@timoffex in #12238)
• Hardened argument handling in wandb launch for the local-process resource so that job-supplied values are always shell-quoted (@nicholaspun-wandb in #12220)
• The launch agent now restricts a job's git source URL to https/ssh remotes and pins git's protocol allowlist when fetching it and updating submodules (@nicholaspun-wandb in #12221)
• Response parsing is now faster for many wandb.Api operations, including artifact and registry queries (@tonyyli-wandb in #12213)
• wandb.init() now reports the error it was retrying (such as a network error) when it times out, instead of a generic timeout message. The init_timeout setting now also bounds the backend's retries during run initialization (@skhanna-cw in #12216)
• wandb.Api().create_run_queue(), wandb.Api().create_custom_chart(), and wandb.Api().upsert_run_queue() now raise WandbApiFailedError when the operation fails on the backend. (@jacobromero in #12307)
• Paginated artifact and registry query methods (Api.artifacts(), Api.artifact_collections(), Api.registries(), Registries.collections(), Registries.versions(), Collections.versions(), Registry.collections(), Registry.versions(), Project.collections()) now perform client-side validation of pagination arguments before attempting to fetch any results (@tonyyli-wandb in #12101)
• Ordered registry search now scopes per-registry collection and version queries to the current registry's internal id for more reliable pagination and filtering (@ibindlish in #12188)

Deprecated

• wandb sync --sync-tensorboard is deprecated and will be removed in a later release (@timoffex in #12419)

Removed

• Releases no longer include 32-bit Windows (win32) wheels; use 64-bit Python on Windows (@dmitryduev in #12267)

Fixed

• Registry search registries(order=...).collections(order=...).versions() now returns artifact versions in registry and/or collection order. (@ibindlish in #12154)
• macOS x86_64 wheels now contain x86_64 builds of the wandb-xpu binary and the Rust parquet library, which previously shipped as arm64 and could not run or be loaded on Intel Macs (@dmitryduev in #12267)
• wandb.login(verify=True) and wandb login --verify now verify federated identity (identity token) credentials, which were previously not verified (@dmitryduev in #12294)
• wandb login and wandb verify no longer update the system host settings when failing to login (@jacobromero in #12332)
• wandb verify now reports a failed check instead of crashing when an operation still fails after retries (@dmitryduev in #12360)
• Calling Sweeps agent with a custom WANDB_DIR will now respect it when dumping JSON output (@kelu-wandb in #12344)
• Fixed wandb.Api(overrides={"base_url": ...}) failing to authenticate with federated identity (identity token) credentials when the specified server was not the default one, such as a dedicated cloud deployment, unless WANDB_BASE_URL was also set (@dmitryduev in #12340)
• When using federated identity, the identity token file is now re-read for each access token exchange instead of once at startup, so short-lived identity tokens re-minted to the same path keep working for runs that outlive them (@dmitryduev in #12341)
• When using federated identity, requests now fail immediately with the server's error message when the server rejects the identity token exchange, such as for an invalid or expired identity token. Previously, the rejected exchange was retried until requests timed out with a generic error (@dmitryduev in #12366)
• wandb login validates api keys prior to saving to the .netrc file (@jacobromero in #12347)
• The global_step metric created when syncing TensorBoard files is no longer prefixed, like train/global_step, so that it is easier to compare training and validation metrics (@timoffex in #12372)
• The TensorBoard integration now produces fewer W&B steps by merging data for the same global_step into one W&B step when possible (@timoffex in #12414)
• wandb sync no longer hangs on a run that set its name, tags, or notes after starting (@dmitryduev in #12380)
• wandb login no longer removes or corrupts credentials belonging to other machines in your .netrc file (@dmitryduev in #12386)
• Log messages captured from Python loggers no longer add blank lines to a run's logs (@dmitryduev in #12387)
• del run.summary[key] now removes metrics that were logged as nested values, which it previously ignored (@dmitryduev in #12389)

Security

• Debug logs no longer contain CoreWeave cluster credentials (@dmitryduev in #12385)
• wandb docker and wandb docker-run no longer pass your API key on the command line, where other users of the same machine could read it (@dmitryduev in #12443)

What's Changed

Notable Changes

This version drops support for protobuf v4, and requires protobuf v5 or newer.
This version drops compatibility with server versions older than 0.70.0.

Added

• New filters parameter to Api().project().sweeps() matching the runs filter format (@kmikowicz-wandb in #12059)
• Added Run.stop() to the public API (wandb.Api().run(...).stop()) to programmatically request that an active run stop gracefully, like the "Stop run" button in the W&B App UI (@dmitryduev in #12161)
• Added wandb.Api().organization() to fetch an Organization by name, or the current default organization for the user (@tonyyli-wandb in #12196)

Changed

• Remove temporary Unix socket files and directories on shutdown (@geoffhardy in #12058)
• wandb beta sync now skips online runs by default like wandb sync (@timoffex in #12087)
• wandb sync now routes to wandb beta sync for supported parameter sets (@timoffex in #12093)
  • Restore original behavior with --legacy
• Dropped support for protobuf v4 (@jacobromero in #12115)
• wandb.sandbox now defaults serverless sandboxes to a 12-hour max lifetime (max_lifetime_seconds=43200); override per sandbox with max_lifetime_seconds or via SandboxDefaults (@nicholaspun-wandb in #12136)
• wandb.Api().runs() now raises a RunNotFoundError when unable to load data for a run, such as when a run is deleted prior to fully loading run data (@jacobromero in https://app.graphite.com/github/pr/wandb/wandb/12176)
• wandb.save now has an option glob=False that disables glob expansion (*, ?, [...]) for file paths; updated docs for improved explanation (@geoffhardy in #12192)

Removed

• Removed legacy fallback implementations for downloading artifact files on older EOL W&B Server releases. The following will no longer work on EOL servers: Artifact.files() and Artifact.download() on any artifact, as well as Artifact.get_entry() / Artifact.get_path() file downloads on non-reference artifacts. (@tonyyli-wandb in #12109)
  • To continue using these operations, upgrade your W&B Server to v0.70.0 or newer.
• Removed legacy fallback implementations for fetching an artifact by name on older EOL W&B Server releases. The following will no longer work on EOL servers: wandb.Api().artifact(...) and other methods that fetch artifact(s) by their path. (@tonyyli-wandb in #12112)
  • To continue using these operations, upgrade your W&B Server to v0.70.0 or newer.
• Removed the GitPython dependency. Git metadata is collected by invoking the git executable directly; the GIT_PYTHON_GIT_EXECUTABLE environment variable is still honored for locating it (@dmitryduev in #11983)

Fixed

• Saving a linked registry artifact (for example, when adding an alias) no longer fails when the caller lacks write access to the source project (@ibindlish in #12075)
• np.float16/np.float32 NaN values logged with Run.log() are now recorded as NaN instead of being silently dropped, matching np.float64 and native float (@dmitryduev in #12116)
• Run.upload_file() (via wandb.Api().run(...)) now registers the uploaded file with the run on self-hosted servers. Previously the file's bytes were uploaded but never committed, so the file did not appear on the run on deployments without object-store notifications (@dmitryduev in #12121)
• Sweep agents will now allow the in-progress run to complete before exiting when the sweep is deleted or Api() returns 404 (@kmikowicz-wandb in #11880)
• Fixed some deadlocks introduced in 0.25.1 (@timoffex in #12114 and #12159)
  • Reported when using PyTorch with Python < 3.14 (which uses the "fork" multiprocessing start method by default)
  • May have also happened during GC when using some wandb.Api functionality

What's Changed

Notable Changes

This version drops compatibility with server versions older than 0.65.0.

Added

• High-resolution image rendering in terminals supporting the Kitty protocol with ANSI fallback in the W&B LEET TUI media pane (wandb leet command) (@dmitryduev in #11806)
• Synced scrubbing in the W&B LEET media pane: press l to link scrubbing, then the scrub keys (←/→/↑/↓/home/end) move a shared cursor over the union step timeline and every image tile follows it (@dmitryduev in #12033)
• Basic remote-run support in W&B LEET TUI (wandb leet <run-url> command) (@jacobromero in #11261)
• The following paginated artifacts and registry API methods now accept an optional order string as a keyword argument: Api.artifacts(), Api.artifact_collections(), Api.registries(), Api.registries().collections(), Registry.collections() (@tonyyli-wandb in #11990)

Changed

• W&B LEET, the terminal UI for viewing W&B runs, is now generally available as wandb leet; wandb beta leet is kept as an alias (@dmitryduev in #12028)
• wandb.Api().runs() no longer loads Sweeps for each run by default to improve query performance. Sweep data is loaded on first access of the sweep property (@kmikowicz-wandb in #12019)
• Lists of images logged under a single key are now displayed in the W&B LEET media pane, one tile per image (@dmitryduev in #12033)

Fixed

• File.download() no longer fails after a hardcoded 5-second timeout; downloads go through wandb-core and respect the file transfer settings (@dmitryduev in #12039)
• wandb.Api().viewer (and Api().user() / Api().users()) no longer fail with WandbApiFailedError: relogin required for some API keys, a regression in 0.27.1 (@dmitryduev in #12009)
• When a wandb.Image carrying multiple box or mask layers with distinct class_labels is logged inside a wandb.Table, each layer's labels are now preserved in new box_class_maps / mask_class_maps fields in the table.json. Previously, there was only as single class_map that got incorrectly clobbered by each set of class labels. The next server release will contain a corresponding frontend fix that reads these per-layer fields. Legacy servers will retain the current behavior. (@kelu-wandb in #11901)
• Artifact file operations now consistently require normalized relative paths (@tonyyli-wandb in #11735)
• Logging an artifact (whether via WandbLogger or run.log_artifact) now writes the manifest file to the artifact's staging directory instead of the OS temp dir ($TMPDIR), avoiding silent failures when $TMPDIR is missing or unwritable (@ibindlish in #11958)
• Logging artifacts in shared mode works again, and in particular, wandb.init(mode="shared") with code-saving enabled no longer raises an error (@timoffex in #12017)
• git_root setting is now preferred for creating the diff.patch file, the root_dir setting is now used as a fallback (@TomSiegl in #11967)
• Apple system metrics (GPU, CPU, power, and temperature) are now collected on Apple M5 Macs (@dmitryduev in #12061)
• file download progress is now shown when using wandb.Api().run(...).download_history_exports (@jacobromero in #12063)
• Run.scan_history() no longer returns no rows for a run whose history exists but has not been exported to parquet (e.g. an active run; a regression in 0.27.1) (@dmitryduev in #12073)

What's Changed

Fixed

• Run.scan_history() no longer returns duplicate or missing steps when getting run history (@jacobromero in #12010)

What's Changed

Added

• The automations API now supports artifact tag, collection tag, and artifact unlinking events (@tonyyli-wandb in #11922)

Changed

• wandb.Api GraphQL operations are routed through the wandb-core service instead of the legacy Python GraphQL client. Failures from these operations now raise WandbApiFailedError instead of requests HTTP exceptions, and customizations made by patching requests no longer affect these GraphQL calls (@dmitryduev in #11818)

Removed

• Removed the unsupported wandb.apis.importers API (@dmitryduev in #11923)
• Removed stale OpenAI, Cohere, and LangChain LLM integrations, including legacy autologging and tracing APIs (@dmitryduev in #11925)
• Removed the deprecated Keras WandbCallback and the legacy wandb.integration.yolov8 callback package (@dmitryduev in #11926)

Changed

• Run.scan_history() now reads from exported parquet history when available, which can significantly improve throughput for runs with large history (@jacobromero in #11797)
  • This was introduced under beta_scan_history in v0.23.1

Fixed

• wandb.sandbox now rejects invalid argument values for placement, gpu, and egress (@nicholaspun-wandb in #11934)

What's Changed

Notable Changes

This version drops support for Python 3.9 and Pydantic v1. Pydantic v2.6 or newer is now required.

Added

• The stop_on_fatal_error setting to stop a run (using stop_fn) after a fatal error that prevents it from uploading metrics (@timoffex in #11774)
• New wandb.sandbox package and the wandb beta sandbox cli for using wandb sandbox (@pingleiwandb in #11606)
• The finish_timeout and finish_timeout_raises settings (@timoffex in #11737)
• The run.write_logs() method to write text directly to the Logs tab (@ItsTania in #11702)
• The capture_loggers setting to automatically capture logging.Logger logs using write_logs() (@ItsTania in #11702)

Changed

• Changed CPU and memory system metric percentages in Linux containers to use cgroup v2 resource limits instead of host node totals. Set the private x_stats_no_cgroup setting to True to opt out (@dmitryduev in #11796)
• Python 3.9 is no longer supported (@dmitryduev in #11841)

Removed

• Pydantic v1 is no longer supported; pydantic >= 2.6 is required. The vendored wandb_orjson extension and its WANDB_DISABLE_ORJSON / WANDB_BUILD_SKIP_ORJSON environment variables removed (@dmitryduev in #11869)

What's Changed

Added

• Api methods returning artifacts, registries, automations, and related paginators now accept an optional start argument to resume iteration from a saved cursor (@tonyyli-wandb in #11651)
• The stop_fn setting to customize how a run is stopped (@timoffex in #11773)
  • Allows overriding the default of sending a SIGINT to the Python process

Changed

• Unified keyboard navigation in W&B LEET TUI (wandb beta leet command): wasd and arrow keys are now interchangeable within each focused pane (chart focus in grids, item/page nav in lists), and Home/End/PgUp/PgDn work universally; the media pane retains its deliberate split where arrows scrub and wasd selects tiles (@dmitryduev in #11756)

Fixed

• Made wandb.init(id=run_id, reinit="create_new") raise an error when another run in the same script with the same run_id is still running (@timoffex in #11759)
• wandb.Api no longer raises an error for some api operations when offline mode is enabled via the WANDB_MODE environment variable or the mode setting. (@jacobromero in #11762)

What's Changed

Notable Changes

This version drops compatibility with server versions older than 0.63.0 (for Dedicated Cloud and Self-Managed W&B deployments).

Added

• wandb beta core start|stop commands to run a detached wandb-core service and reuse it across multiple processes via the WANDB_SERVICE env var (@dmitryduev in #11418)
• Run filtering by metadata in multi-run workspace mode in W&B LEET TUI (wandb beta leet command, activate with f) (@dmitryduev in #11497 and #11534)
• Run overview displays tags and notes in W&B LEET TUI (wandb beta leet command) (@dmitryduev in #11523)
• Per-chart log-scale (Y-axis) support in W&B LEET TUI (wandb beta leet command, toggle on a selected chart with y) (@dmitryduev in #11537)
• Standalone system monitor mode in W&B LEET TUI (wandb beta leet symon command) (@dmitryduev in #11559)
• Bucketed heatmap chart mode for system metrics expressed as percentages (e.g. GPU utilization) in W&B LEET TUI (wandb beta leet command, cycle chart mode on a selected chart with y) (@dmitryduev in #11568 and #11607)
• Colorblind-friendly dusk-shore (gradient) and clear-signal (cycle) color schemes in W&B LEET TUI (wandb beta leet command, configure with wandb beta leet config) (@dmitryduev in #11577)
• disable_git_fork_point to prevent calculating git diff patch files closest ancestor commit when no upstream branch is set (@jacobromero in #10132)
• Media pane for displaying wandb.Image data as ANSI thumbnails in W&B LEET TUI (wandb beta leet command), with grid layout, X-axis scrubbing, fullscreen mode, and keyboard/mouse navigation (@dmitryduev in #11630)
• Kubeflow Pipelines v2 (kfp>=2.0.0) support for the @wandb_log decorator (@ayulockin in #11423)
• allow_media_symlink setting to symlink or hardlink media files to the run directory instead of copying, improving logging performance and reducing disk usage (@jacobromero in #11544)
• run.pin_config_keys(keys) to programmatically pin specific config keys for display in a References section on the Run Overview page (@acasey-wandb in #11639)
• Direct TPU metric collection via libtpu.so FFI, capturing tensorcore_util (SDK-only, unavailable via gRPC), duty_cycle_pct, hbm_capacity_total, hbm_capacity_usage, and latency distributions (@dmitryduev in #11528)
• NVML GPM (GPU Performance Monitoring) profiling metrics for Hopper+ GPUs (H100 and newer), providing SM utilization, tensor/FP pipeline activity, DRAM bandwidth, and PCIe/NVLink throughput without requiring the DCGM daemon (@dmitryduev in #11622)
• .runs() on the Agent class to query run status for a given sweep agent (@kmikowicz-wandb in #11558)
• .agent() and .agents() on the Sweep class to query active agents for a given sweep (@kmikowicz-wandb in #11558)

Changed

• JSON serialization and deserialization now use orjson for improved performance (@jacobromero in #11163)
• Improved system metrics UX with multi-series overlays, inspection, and live/history zoom in W&B LEET TUI (wandb beta leet command) (@dmitryduev in #11512)
• Prevent run base color collisions in W&B LEET TUI's workspace (wandb beta leet command) (@dmitryduev in #11567)

Fixed

• Fixed update_automation() silently dropping event filters (e.g. alias conditions on OnAddArtifactAlias) when a new event is provided (@matthoare117-wandb in #11613)
• Fixed artifact client ID collisions in forked child processes by reseeding the fast ID generator after fork() (@tonyyli-wandb in #11491)
• Fixed WANDB__EXTRA_HTTP_HEADERS not being applied to presigned object-store upload and download requests (@pingleiwandb in #11620)
• Fixed deadlock in artifact.download() for artifacts with many large files. (@amusipatla-wandb in #11615)
• Fixed User.generate_api_key() failing for users with hashed API keys by using the existing authenticated client instead of querying non-secret key names (@ArtsiomWB in #11663)

What's Changed

Added

• Run console logs pane in W&B LEET TUI (wandb beta leet command, toggle with l). (@dmitryduev in #11345)
• System metrics pane in multi-run workspace mode in W&B LEET TUI (wandb beta leet command, toggle with s). (@dmitryduev in #11391)
• System metrics filtering in W&B LEET TUI (wandb beta leet command, toggle with \). (@dmitryduev in #11391)
• ArtifactType.collections() now supports filtering and ordering of collections. (@amusipatla-wandb in #11268)
• Warning message when run.log_artifact does not create a new version because the artifact content is identical to an existing version. (@pingleiwandb in #11340)
• Project.collections() to fetch filtered and ordered artifact collections in a project. (@amusipatla-wandb in #11319)
• wandb purge-cache command to clean up cached files (@jacobromero in #10996)

Fixed

• Fixed a rare deadlock caused when GC triggers at an unlucky time and runs a __del__ method that prints (@timoffex in #11402)
• api.Run.user raising AttributeError when accessing runs from an api.Runs iteration (@jacobromero in #11439)

What's Changed

Notable Changes

This version drops support for Python 3.8.

Added

• Multi-run workspace experience in W&B LEET TUI (wandb beta leet command). (@dmitryduev in #11299)
• Config editor for W&B LEET TUI (wandb beta leet config command). (@dmitryduev in #11327)
• owner property on wandb.apis.public.Project to access the project owner's user information. (@jacobromero in #11278)

Changed

• Python 3.8 is no longer supported (@tonyyli-wandb in #11198, #11290, #11164)

Fixed

• Sweep agents now exit gracefully when the sweep is deleted, instead of running indefinitely with repeated 404 errors (@domphan-wandb in #11226)
• wandb-core crashes no longer produce extremely long, repetitive tracebacks in older Python versions (@timoffex in #11284)
• TensorBoard sync no longer stops after 1 MB of data (@timoffex in #11334)
  • Regression introduced in 0.24.0

What's Changed

Added

• wandb.Api() now supports Federated Auth (JWT based authentication). (@ryanbuccellato in https://github.com/wandb/wandb/pull/11243)

Fixed

• Refresh presigned download url when it expires during artifact file downloads. (@pingleiwandb in https://github.com/wandb/wandb/pull/11242)

What's Changed

Notable Changes

Runs created with wandb==0.24.0 may fail to upload some data, which this release fixes. Missing data is stored in the run's .wandb file and can be reuploaded with wandb sync.

Added

• download_history_exports in api.Run class to download exported run history in parquet file format (@jacobromero in https://github.com/wandb/wandb/pull/11094)

Changed

• When a settings file (such as ./wandb/settings or ~/.config/wandb/settings) contains an invalid setting, all settings files are ignored and an error is printed (@timoffex in https://github.com/wandb/wandb/pull/11207)

Fixed

• After wandb login --host <invalid-url>, using wandb login --host <valid-url> works as usual (@timoffex in https://github.com/wandb/wandb/pull/11207)
  • Regression introduced in 0.24.0
• wandb beta sync correctly loads credentials (@timoffex in https://github.com/wandb/wandb/pull/11231)
  • Regression introduced in 0.24.0
  • Caused wandb beta sync to get stuck on Syncing...
• Fixed occasional unuploaded data in 0.24.0 (@timoffex in https://github.com/wandb/wandb/pull/11249)
  • All data is stored in the run's .wandb file and can be reuploaded with wandb sync

⚠️ This release has been yanked from PyPI. Do not use this version. Runs created with wandb==0.24.0 may in rare cases silently fail to upload data. Upgrade immediately to v0.24.1, which fixes this issue. If you've already used this version, missing data is stored in the run's .wandb file and can be recovered with wandb sync.

What's Changed

Notable Changes

This version removes the legacy, deprecated wandb.beta.workflows module, including its log_model()/use_model()/link_model() functions. This is formally a breaking change.

Added

• wandb agent and wandb.agent() now accept a forward_signals flag (CLI: --forward-signals/-f) to relay SIGINT/SIGTERM and other catchable signals from the agent to its sweep child runs, enabling cleaner shutdowns when you interrupt an agent process (@kylegoyette, @domphan-wandb in https://github.com/wandb/wandb/pull/9651)
• wandb beta sync now supports a --live option for syncing a run while it's being logged (@timoffex in https://github.com/wandb/wandb/pull/11079)

Removed

• Removed the deprecated wandb.beta.workflows module, including its log_model(), use_model(), and link_model() functions, and whose modern successors are the Run.log_artifact, Run.use_artifact, and Run.link_artifact methods, respectively (@tonyyli-wandb in [TODO: PR link])

Fixed

• Fixed Run.__exit__ type annotations to accept None values, which are passed when no exception is raised (@moldhouse in https://github.com/wandb/wandb/pull/11100)
• Fixed Invalid Client ID digest error when creating artifacts after calling random.seed(). Client IDs could collide when random state was seeded deterministically. (@pingleiwandb in https://github.com/wandb/wandb/pull/11039)
• Fixed CLI error when listing empty artifacts (@ruhiparvatam in https://github.com/wandb/wandb/pull/11157)
• Fixed regression for calling api.run() on a Sweeps run (@willtryagain in https://github.com/wandb/wandb/pull/11088 and @kelu-wandb in https://github.com/wandb/wandb/pull/11097)
• Fixed the "View run at" message printed at the end of a run which sometimes did not include a URL (@timoffex in https://github.com/wandb/wandb/pull/11113)
• Runs queried from wandb.Api() now display a string representation in VSCode notebooks instead of a broken HTML window (@jacobromero in https://github.com/wandb/wandb/pull/11040)

What's Changed

Added

• Regex support in metrics and run overview filters in W&B LEET TUI (@dmitryduev in https://github.com/wandb/wandb/pull/10919)
• Chart inspection in W&B LEET TUI: right-click and drag to show (x, y) at the nearest data point; hold Alt for synchronized inspection across all visible charts (@dmitryduev in https://github.com/wandb/wandb/pull/10989)
• The automations API now supports creating and editing automations that trigger on run states (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10848)
• The automations API now support basic zscore automation events (@matthoare117-wandb in https://github.com/wandb/wandb/pull/10931)
• Simplified the syntax for creating z-score metric automation triggers in the automations API (@matthoare117-wandb in https://github.com/wandb/wandb/pull/10953)
• beta_history_scan method to Run objects for faster history scanning performance with wandb.Api (@jacobromero in https://github.com/wandb/wandb/pull/10779)

Changed

• wandb.Api() now raises a UsageError if WANDB_IDENTITY_TOKEN_FILE is set and an explicit API key is not provided (@timoffex in https://github.com/wandb/wandb/pull/10970)
  • wandb.Api() has only ever worked using an API key

Deprecated

• Anonymous mode, including the anonymous setting, the WANDB_ANONYMOUS environment variable, wandb.init(anonymous=...), wandb login --anonymously and wandb.login(anonymous=...) is deprecated and will emit warnings (@timoffex in https://github.com/wandb/wandb/pull/10909)

Fixed

• wandb.Image() no longer prints a deprecation warning (@jacobromero in https://github.com/wandb/wandb/pull/10880)
• Registry.description and ArtifactCollection.description no longer reject empty strings (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10891)
• Instantiating Artifact objects is now significantly faster (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10819)
• wandb.Run.save() now falls back to hardlinks and, if needed, copying (downgrading the 'live' file policy to 'now', if applicable) when symlinks are disabled or unavailable (e.g., cross‑volume or no Developer Mode on Windows) (@dmitryduev in https://github.com/wandb/wandb/pull/10894)
• Artifact collection aliases are now fetched lazily on accessing ArtifactCollection.aliases instead of on instantiating ArtifactCollection, improving performance of Api.artifact_collections(), Api.registries().collections(), etc. (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10731)
• Use explicitly provided API key in wandb.init(settings=wandb.Settings(api_key="...")) for login. Use the key from run when logging artifacts via run.log_artifact (@pingleiwandb in https://github.com/wandb/wandb/pull/10914)
• W&B LEET TUI correctly displays negative Y axis tick values and base/display units of certain system metrics (@dmitryduev in https://github.com/wandb/wandb/pull/10905)
• Fixed a rare infinite loop in console_capture.py (@timoffex in https://github.com/wandb/wandb/pull/10955)
• File upload/download now respects WANDB_X_EXTRA_HTTP_HEADERS except for reference artifacts

What's Changed

Added

• Experimental wandb beta leet command - Lightweight Experiment Exploration Tool - a terminal UI for viewing W&B runs locally with real-time metrics visualization and system monitoring (@dmitryduev in https://github.com/wandb/wandb/pull/10764)
• The registry API now supports programmatic management of user and team members of individual registries. (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10542)
• Registry.id has been added as a (read-only) property of Registry objects (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10785).

Fixed

• Artifact.files() now has a correct len() when filtering by the names parameter (@matthoare117-wandb in https://github.com/wandb/wandb/pull/10796)
• The numerator for file upload progress no longer occasionally exceeds the total file size (@timoffex in https://github.com/wandb/wandb/pull/10812)
• Artifact.link() now logs unsaved artifacts instead of raising an error, consistent with the behavior of Run.link_artifact() (@tonyyli-wandb in https://github.com/wandb/wandb/10822)
• Automatic code saving now works when running ipython notebooks in VSCode's Jupyter notebook extension (@jacobromero in https://github.com/wandb/wandb/pull/10746)
• Logging an artifact with infinite floats in Artifact.metadata now raises a ValueError early, instead of waiting on request retries to time out (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10845).

What's Changed

Added

• Settings console_chunk_max_seconds and console_chunk_max_bytes for size- and time-based multipart console logs file chunking (@dmitryduev in https://github.com/wandb/wandb/pull/10162)
• Registry API query methods (Api.registries(), Registry.{collections,versions}(), Api.registries().{collections,versions}()) now accept a per_page keyword arg to override the default batch size for paginated results (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10713).

Changed

• API keys longer than 40 characters are now supported. (@jennwandb in https://github.com/wandb/wandb/pull/10688)

Fixed

• run.config now properly returns a dict when calling artifact.logged_by() in v0.22.1 (@thanos-wandb in #10682)
• wandb.Api(api_key=...) now prioritizes the explicitly provided API key over thread-local cached credentials (@pingleiwandb in https://github.com/wandb/wandb/pull/10657)
• Fixed a rare deadlock in console_capture.py (@timoffex in https://github.com/wandb/wandb/pull/10683)
  • If you dump thread tracebacks during the deadlock and see the wandb-AsyncioManager-main thread stuck on a line in console_capture.py: this is now fixed.
• Fixed an issue where TensorBoard sync would sometimes stop working if the tfevents files were being written live (@timoffex in https://github.com/wandb/wandb/pull/10625)
• Artifact.manifest delays downloading and generating the download URL for the artifact manifest until it's first used. If the manifest has not been locally modified, Artifact.size and Artifact.digest can return without waiting to fetch the full manifest (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10680)
• Fixed uploading GCS folder references via artifact.add_reference (@amusipatla-wandb in https://github.com/wandb/wandb/pull/10679)
• The SDK now correctly infers notebooks paths in Jupyter sessions, using th server's root directory, so code saving works in subdirectories (e.g. code/nested/<notebook>.ipynb) (@jacobromero in https://github.com/wandb/wandb/pull/10709)

What's Changed

Fixed

• Possibly fixed some cases where the output.log file was not being uploaded (@timoffex in https://github.com/wandb/wandb/pull/10620)
• Fixed excessive data uploads when calling run.save() repeatedly on unchanged files (@dmitryduev in https://github.com/wandb/wandb/pull/10639)

What's Changed

Added

• Optimize artifacts downloads re-verification with checksum caching (@thanos-wandb in https://github.com/wandb/wandb/pull/10157)
• Lazy loading support for Api().runs() to improve performance when listing runs. The new lazy=True parameter (default) loads only essential metadata initially, with automatic on-demand loading of heavy fields like config and summary when accessed (@thanos-wandb in https://github.com/wandb/wandb/pull/10034)
• Add storage_region option when creating artifacts. Users can use CoreWeave AI Object Storage by specifying wandb.Artifact(storage_region="coreweave-us") when using wandb.ai for faster artifact upload/download on CoreWeave's infrastructure. (@pingleiwandb in https://github.com/wandb/wandb/pull/10533)

Fixed

• Api.artifact_exists() and Api.artifact_collection_exists() now raise on encountering timeout errors, rather than (potentially erroneously) returning False. (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10591)

What's Changed

Notable Changes

This version removes support of MacOS 10.

Removed

• Remove a build targeting MacOS 10.x due to multiple security and supply chain considerations (@dmitryduev in https://github.com/wandb/wandb/pull/10529)

Fixed

• Resuming a run with a different active run will now raise an error unless you call run.finish() first, or call wandb.init() with the parameter reinit='create_new' (@jacobromero in https://github.com/wandb/wandb/pull/10468)
• Fix Api().runs() for wandb server < 0.51.0 (when project.internalId was added to gql API) (@kelu-wandb in https://github.com/wandb/wandb/pull/10507)
• Sweeps: command run scripts that import readline whether directly or indirectly (e.g. import torch on Python 3.13) should no longer deadlock (@kelu-wandb in https://github.com/wandb/wandb/pull/10489)

What's Changed

Added

• Add DSPy integration: track evaluation metrics over time, log predictions and program signature evolution to W&B Tables, and save DSPy programs as W&B Artifacts (complete program or state as JSON/PKL) (@ayulockin in https://github.com/wandb/wandb/pull/10327)

What's Changed

Changed

• Updated click dependency constraint from >=7.1 to >=8.0.1 (@willtryagain in https://github.com/wandb/wandb/pull/10418)

Fixed

• The message "Changes to your wandb environment variables will be ignored" is no longer printed when nothing changed (@timoffex in https://github.com/wandb/wandb/pull/10420)

What's Changed

Notable Changes

This version raises errors that would previously have been suppressed during calls to Artifact.link() or Run.link_artifact(). While this prevents undetected failures in those methods, it is also a breaking change.

Added

• New settings for max_end_of_run_history_metrics and max_end_of_run_summary_metrics (@timoffex in https://github.com/wandb/wandb/pull/10351)
• New wandb.integration.weave module for automatically initializing Weave when a W&B run is active and weave is imported (@andrewtruong in https://github.com/wandb/wandb/pull/10389)

Changed

• Errors encountered while linking an artifact are no longer suppressed/silenced, and Artifact.link() and Run.link_artifact() no longer return None (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9968)
• The "Run history" and "Run summary" printed at the end of a run are now limited to 10 metrics each (@timoffex in https://github.com/wandb/wandb/pull/10351)

Fixed

• Dataclasses in a run's config no long raise Object of type ... is not JSON serializable when containing real classes as fields to the dataclass (@jacobromero in https://github.com/wandb/wandb/pull/10371)
• Artifact.link() and Run.link_artifact() should be faster on server versions 0.74.0+, requiring 4-5 fewer unnecessary blocking GraphQL requests (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10393).

What's Changed

Notable Changes

The default ordering for Api().runs(...) and Api().sweeps(...) is now ascending order based on the runs created_at time.

Added

• Support first summary option in define_metric (@kptkin in https://github.com/wandb/wandb/pull/10121)
• Add support for paginated sweeps (@nicholaspun-wandb in https://github.com/wandb/wandb/pull/10122)
• pattern parameter to Api().run().files to only get files matching a given pattern from the W&B backend (@jacobromero in https://github.com/wandb/wandb/pull/10163)
• Add optional format key to Launch input JSONSchema to specify a string with a secret format (@domphan-wandb in https://github.com/wandb/wandb/pull/10207)

Changed

• Sweep.name property will now return user-edited display name if available (falling back to original name from sweep config, then sweep ID as before) (@kelu-wandb in https://github.com/wandb/wandb/pull/10144)
• Api().runs(...) and Api().sweeps(...) now returns runs in ascending order according to the runs created_at time. (@jacobromero in https://github.com/wandb/wandb/pull/10130)
• Artifact with large file (>2GB) uploads faster by using parallel hashing on system with more cores (@pingleiwandb in https://github.com/wandb/wandb/pull/10136)
• Remove the implementation of __bool__ for the registry iterators to align with python lazy iterators. (@estellazx in https://github.com/wandb/wandb/pull/10259)

Deprecated

• The wandb.beta.workflows module and its contents (including log_model(), use_model(), and link_model()) are deprecated and will be removed in a future release (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10205).

Fixed

• Correct the artifact url for organization registry artifacts to be independent of the artifact type (@ibindlish in https://github.com/wandb/wandb/pull/10049)
• Suffixes on sanitized InternalArtifact names have been shortened to 6 alphanumeric characters (@tonyyli-wandb in https://github.com/wandb/wandb/pull/10102)
• wandb.Video will not print a progress spinner while encoding video when WANDB_SILENT/WANDB_QUIET environment variables are set (@jacobromero in https://github.com/wandb/wandb/pull/10064)
• Fixed registries fetched using api.registries() from having an extra wandb-registry- prefix in the name and full_name fields (@estellazx in https://github.com/wandb/wandb/pull/10187)
• Fixed a crash that could happen when using sync_tensorboard (@timoffex in https://github.com/wandb/wandb/pull/10199)
• Api().run(...).upload_file no longer throws an error when uploading a file in a different path relative to the provided root directory (@jacobromero in https://github.com/wandb/wandb/pull/10228)
• Calling load() function on a public API run object no longer throws TypeError. (@jacobromero in https://github.com/wandb/wandb/pull/10050)
• When a Sweeps run function called by wandb.agent() API throws an exception, it will now appear on the logs page for the run. (This previously only happened for runs called by the wandb agent CLI command.) (@kelu-wandb in https://github.com/wandb/wandb/pull/10244)

What's Changed

Notable Changes

This version removes the legacy implementation of the service process. This is a breaking change.

Added

• Setting x_stats_track_process_tree to track process-specific metrics such as the RSS, CPU%, and thread count in use for the entire process tree, starting from x_stats_pid. This can be expensive and is disabled by default (@dmitryduev in https://github.com/wandb/wandb/pull/10089)
• Notes are now returned to the client when resuming a run (@kptkin in https://github.com/wandb/wandb/pull/9739)
• Added support for creating custom Vega chart presets through the API. Users can now define and upload custom chart specifications that can be then reused across runs with wandb.plot_table() (@thanos-wandb in https://github.com/wandb/wandb/pull/9931)

Changed

• Calling Artifact.link() no longer instantiates a throwaway placeholder run (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9828)
• wandb now attempts to use Unix sockets for IPC instead of listening on localhost, making it work in environments with more restrictive permissions (such as Databricks) (@timoffex in https://github.com/wandb/wandb/pull/9995)
• Api.artifact() will now display a warning while fetching artifacts from migrated model registry collections. (@ibindlish in https://github.com/wandb/wandb/pull/10047)
• The .length for objects queried from wandb.Api has been deprecated. Use len(...) instead (@jacobromero in https://github.com/wandb/wandb/pull/10091)

Removed

• Removed the legacy python implementation of the service process. The legacy-service option of wandb.require as well as the x_require_legacy_service and x_disable_setproctitle settings with the corresponding environment variables have been removed and will now raise an error if used (@dmitryduev in https://github.com/wandb/wandb/pull/9965)

• Removed the private wandb.Run._metadata attribute. To override the auto-detected CPU and GPU counts as well as the GPU type, please use the new settings x_stats_{cpu_count,cpu_logical_count,gpu_count,gpu_type} (@dmitryduev in https://github.com/wandb/wandb/pull/9984)

Fixed

• Allow s3 style CoreWeave URIs for reference artifacts. (@estellazx in https://github.com/wandb/wandb/pull/9979)
• Fixed rare bug that made Ctrl+C ineffective after logging large amounts of data (@timoffex in https://github.com/wandb/wandb/pull/10071)
• Respect silent, quiet, and show_warnings settings passed to a Run instance for warnings emitted by the service process (@kptkin in https://github.com/wandb/wandb/pull/10077)
• api.Runs no longer makes an API call for each run loaded from W&B. (@jacobromero in https://github.com/wandb/wandb/pull/10087)
• Correctly parse the x_extra_http_headers setting from the env variable (@dmitryduev in https://github.com/wandb/wandb/pull/10103)
• .length calls the W&B backend to load the length of objects when no data has been loaded rather than returning None (@jacobromero in https://github.com/wandb/wandb/pull/10091)

What's Changed

Fixed

• wandb.Image() was broken in 0.20.0 when given NumPy arrays with values in the range [0, 1], now fixed (@timoffex in https://github.com/wandb/wandb/pull/9982)

What's Changed

• wandb.Table: Added new constructor param, log_mode, with options "IMMUTABLE" and "MUTABLE". IMMUTABLE log mode (default) is existing behavior that only allows a table to be logged once. MUTABLE log mode allows the table to be logged again if it has been mutated. (@domphan-wandb in https://github.com/wandb/wandb/pull/9758)
• wandb.Table: Added a new log_mode, "INCREMENTAL", which logs newly added table data incrementally. (@domphan-wandb in https://github.com/wandb/wandb/pull/9810)

Notable Changes

This version removes the ability to disable the service process. This is a breaking change.

Added

• Added merge parameter to Artifact.add_dir to allow overwrite of previously-added artifact files (@pingleiwandb in https://github.com/wandb/wandb/pull/9907)
• Support for pytorch.tensor for masks and boxes parameters when creating a wandb.Image object. (@jacobromero in https://github.com/wandb/wandb/pull/9802)
• sync_tensorboard now supports syncing tfevents files stored in S3, GCS and Azure (@timoffex in https://github.com/wandb/wandb/pull/9849)
  • GCS paths use the format gs://bucket/path/to/log/dir and rely on application-default credentials, which can be configured using gcloud auth application-default login
  • S3 paths use the format s3://bucket/path/to/log/dir and rely on the default credentials set through aws configure
  • Azure paths use the format az://account/container/path/to/log/dir and the az login credentials, but also require the AZURE_STORAGE_ACCOUNT and AZURE_STORAGE_KEY environment variables to be set. Some other environment variables are supported as well, see here.
• Added support for initializing some Media objects with pathlib.Path (@jacobromero in https://github.com/wandb/wandb/pull/9692)
• New setting x_skip_transaction_log that allows to skip the transaction log. Note: Should be used with caution, as it removes the gurantees about recoverability. (@kptkin in https://github.com/wandb/wandb/pull/9064)
• normalize parameter to wandb.Image initialization to normalize pixel values for Images initialized with a numpy array or pytorch tensor. (@jacobromero in https://github.com/wandb/wandb/pull/9883)

Changed

• Various APIs now raise TypeError instead of ValueError or other generic errors when given an argument of the wrong type. (@timoffex in https://github.com/wandb/wandb/pull/9902)
• Various Artifacts and Automations APIs now raise CommError instead of ValueError upon encountering server errors, so as to surface the server error message. (@ibindlish in https://github.com/wandb/wandb/pull/9933)
• wandb.sdk.wandb_run.Run::save method now requires the glob_str argument (@dmitryduev in https://github.com/wandb/wandb/pull/9962)

Removed

• Removed support for disabling the service process. The x_disable_service/_disable_service setting and the WANDB_DISABLE_SERVICE/WANDB_X_DISABLE_SERVICE environment variable have been deprecated and will now raise an error if used (@kptkin in https://github.com/wandb/wandb/pull/9829)
• Removed ability to use wandb.docker after only importing wandb (@timoffex in https://github.com/wandb/wandb/pull/9941)
  • wandb.docker is not part of wandb's public interface and is subject to breaking changes. Please do not use it.
• Removed no-op sync argument from wandb.Run::log function (@kptkin in https://github.com/wandb/wandb/pull/9940)
• Removed deprecated wandb.sdk.wandb_run.Run.mode property (@dmitryduev in https://github.com/wandb/wandb/pull/9958)
• Removed deprecated wandb.sdk.wandb_run.Run::join method (@dmitryduev in https://github.com/wandb/wandb/pull/9960)

Deprecated

• The start_method setting is deprecated and has no effect; it is safely ignored (@kptkin in https://github.com/wandb/wandb/pull/9837)
• The property Artifact.use_as and parameter use_as for run.use_artifact() are deprecated since these have not been in use for W&B Launch (@ibindlish in https://github.com/wandb/wandb/pull/9760)

Fixed

• Calling wandb.teardown() in a child of a process that called wandb.setup() no longer raises WandbServiceNotOwnedError (@timoffex in https://github.com/wandb/wandb/pull/9875)
  • This error could have manifested when using W&B Sweeps
• Offline runs with requested branching (fork or rewind) sync correctly (@dmitryduev in https://github.com/wandb/wandb/pull/9876)
• Log exception as string when raising exception in Job wait_until_running method (@KyleGoyette in https://github.com/wandb/wandb/pull/9607)
• wandb.Image initialized with tensorflow data would be normalized differently than when initialized with a numpy array (@jacobromero in https://github.com/wandb/wandb/pull/9883)
• Using wandb login no longer prints a warning about wandb.require("legacy-service") (@timoffex in https://github.com/wandb/wandb/pull/9912)
• Logging a Table (or other objects that create internal artifacts) no longer raises ValueError when logged from a run whose ID contains special characters. (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9943)
• wandb.Api initialized with the base_url now respects the provided url, rather than the last login url (@jacobromero in https://github.com/wandb/wandb/pull/9942)

What's Changed

Added

• Added creation, deletion, and updating of registries in the SDK. (@estellazx in https://github.com/wandb/wandb/pull/9453)
• artifact.is_link property to artifacts to determine if an artifact is a link artifact (such as in the Registry) or source artifact. (@estellazx in https://github.com/wandb/wandb/pull/9764)
• artifact.linked_artifacts to fetch all the linked artifacts to a source artifact and artifact.source_artifact to fetch the source artifact of a linked artifact. (@estellazx in https://github.com/wandb/wandb/pull/9789)
• run.link_artifact(), artifact.link(), and run.link_model() all return the linked artifact upon linking (@estellazx in https://github.com/wandb/wandb/pull/9763)
• Multipart download for artifact file larger than 2GB, user can control it directly using artifact.download(multipart=True). (@pingleiwandb in https://github.com/wandb/wandb/pull/9738)
• Project.id property to get the project ID on a wandb.public.Project (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9194).
• New public API for W&B Automations (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9693, https://github.com/wandb/wandb/pull/8935, https://github.com/wandb/wandb/pull/9194, https://github.com/wandb/wandb/pull/9197, https://github.com/wandb/wandb/pull/8896, https://github.com/wandb/wandb/pull/9246)
  • New submodules and classes in wandb.automations.* to support programmatically managing W&B Automations.
  • Api.integrations(), Api.slack_integrations(), Api.webhook_integrations() to fetch a team's existing Slack or webhook integrations.
  • Api.create_automation(), Api.automation()/Api.automations(), Api.update_automation(), Api.delete_automation() to create, fetch, edit, and delete Automations.
• Create and edit automations triggered on RUN_METRIC_CHANGE events, i.e. on changes in run metric values (absolute or relative deltas). (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9775)
• Ability to collect profiling metrics for Nvidia GPUs using DCGM. To enable, set the WANDB_ENABLE_DCGM_PROFILING environment variable to true. Requires the nvidia-dcgm service to be running on the machine. Enabling this feature can lead to increased resource usage. (@dmitryduev in https://github.com/wandb/wandb/pull/9780)

Fixed

• run.log_code correctly sets the run configs code_path value. (@jacobromero in https://github.com/wandb/wandb/pull/9753)
• Correctly use WANDB_CONFIG_DIR for determining system settings file path (@jacobromero in https://github.com/wandb/wandb/pull/9711)
• Prevent invalid Artifact and ArtifactCollection names (which would make them unloggable), explicitly raising a ValueError when attempting to assign an invalid name. (@tonyyli-wandb in https://github.com/wandb/wandb/pull/8773)
• Prevent pydantic ConfigError in Pydantic v1 environments from not calling .model_rebuild()/.update_forward_refs() on generated types with ForwardRef fields (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9795)
• wandb.init() no longer raises Permission denied error when the wandb directory is not writable or readable (@jacobromero in https://github.com/wandb/wandb/pull/9751)
• Calling file.delete() on files queried via api.Runs(...) no longer raises CommError (@jacobromero in https://github.com/wandb/wandb/pull/9748)
  • Bug introduced in 0.19.1

What's Changed

Added

• The new reinit="create_new" setting causes wandb.init() to create a new run even if other runs are active, without finishing the other runs (in contrast to reinit="finish_previous"). This will eventually become the default (@timoffex in https://github.com/wandb/wandb/pull/9562)
• Added Artifact.history_step to return the nearest run step at which history metrics were logged for the artifact's source run (@ibindlish in https://github.com/wandb/wandb/pull/9732)
• Added data_is_not_path flag to skip file checks when initializing wandb.Html with a sting that points to a file.

Changed

• Artifact.download() no longer raises an error when using WANDB_MODE=offline or when an offline run exists (@timoffex in https://github.com/wandb/wandb/pull/9695)

Removed

• Dropped the -q / --quiet argument to the wandb magic in IPython / Jupyter; use the quiet run setting instead (@timoffex in https://github.com/wandb/wandb/pull/9705)

Deprecated

• The following wandb.Run methods are deprecated in favor of properties and will be removed in a future release (@kptkin in https://github.com/wandb/wandb/pull/8925):
  • run.project_name() is deprecated in favor of run.project
  • run.get_url() method is deprecated in favor of run.url
  • run.get_project_url() method is deprecated in favor of run.project_url
  • run.get_sweep_url() method is deprecated in favor of run.sweep_url

Fixed

• Fixed ValueError on Windows when running a W&B script from a different drive (@jacobromero in https://github.com/wandb/wandb/pull/9678)
• Fix base_url setting was not provided to wandb.login (@jacobromero in https://github.com/wandb/wandb/pull/9703)
• wandb.Html() no longer raises IsADirectoryError with a value that matched a directory on the users system. (@jacobromero in https://github.com/wandb/wandb/pull/9728)

What's Changed

Added

• The reinit setting can be set to "default" (@timoffex in https://github.com/wandb/wandb/pull/9569)
• Added support for building artifact file download urls using the new url scheme, with artifact collection membership context (@ibindlish in https://github.com/wandb/wandb/pull/9560)

Changed

• Boolean values for the reinit setting are deprecated; use "return_previous" and "finish_previous" instead (@timoffex in https://github.com/wandb/wandb/pull/9557)
• The "wandb" logger is configured with propagate=False at import time, whereas it previously happened when starting a run. This may change the messages observed by the root logger in some workflows (@timoffex in https://github.com/wandb/wandb/pull/9540)
• Metaflow now requires plum-dispatch package. (@jacobromero in https://github.com/wandb/wandb/pull/9599)
• Relaxed the pydantic version requirement to support both v1 and v2 (@dmitryduev in https://github.com/wandb/wandb/pull/9605)
• Existing pydantic types have been adapted to be compatible with Pydantic v1 (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9623)
• wandb.init(dir=...) now creates any nonexistent directories in dir if it has a parent directory that is writeable (@ringohoffman in https://github.com/wandb/wandb/pull/9545)
• The server now supports fetching artifact files by providing additional collection information; updated the artifacts api to use the new endpoints instead (@ibindlish in https://github.com/wandb/wandb/pull/9551)
• Paginated methods (and underlying paginators) that accept a per_page argument now only accept int values. Default per_page values are set directly in method signatures, and explicitly passing None is no longer supported (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9201)

Fixed

• Calling wandb.init() in a notebook finishes previous runs as previously documented (@timoffex in https://github.com/wandb/wandb/pull/9569)
  • Bug introduced in 0.19.0
• Fixed an error being thrown when logging jpg/jpeg images containing transparency data (@jacobromero in https://github.com/wandb/wandb/pull/9527)
• wandb.init(resume_from=...) now works without explicitly specifying the run's id (@kptkin in https://github.com/wandb/wandb/pull/9572)
• Deleting files with the Public API works again (@jacobromero in https://github.com/wandb/wandb/pull/9604)
  • Bug introduced in 0.19.1
• Fixed media files not displaying in the UI when logging to a run with a custom storage bucket (@jacobromero in https://github.com/wandb/wandb/pull/9661)

What's Changed

Fixed

• Media file paths containing special characters (?, *, ], [ or \) no longer cause file uploads to fail in wandb-core (@jacobromero in https://github.com/wandb/wandb/pull/9475)

Changed

• The system monitor now samples metrics every 15 seconds by default, up from 10 seconds (@kptkin in https://github.com/wandb/wandb/pull/9554)

What's Changed

Added

• Registry search api (@estellazx in https://github.com/wandb/wandb/pull/9472)

Changed

• changed moviepy constraint to >=1.0.0 (@jacobromero in https://github.com/wandb/wandb/pull/9419)
• wandb.init() displays more detailed information, in particular when it is stuck retrying HTTP errors (@timoffex in https://github.com/wandb/wandb/pull/9431)

Removed

• Removed the private x_show_operation_stats setting (@timoffex in https://github.com/wandb/wandb/pull/9427)

Fixed

• Fixed incorrect logging of an "wandb.Video requires moviepy [...]" exception when using moviepy v2. (@Daraan in https://github.com/wandb/wandb/pull/9375)
• wandb.setup() correctly starts up the internal service process; this semantic was unintentionally broken in 0.19.2 (@timoffex in https://github.com/wandb/wandb/pull/9436)
• Fixed TypeError: Object of type ... is not JSON serializable when using numpy number types as values. (@jacobromero in https://github.com/wandb/wandb/pull/9487)

What's Changed

Added

• Prometheus API support for Nvidia DCGM GPU metrics collection (@dmitryduev in https://github.com/wandb/wandb/pull/9369)

Changed

• Changed Nvidia GPU ECC counters from aggregated to volatile (@gritukan in https://github.com/wandb/wandb/pull/9347)

Fixed

• Fixed a performance issue causing slow instantiation of wandb.Artifact, which in turn slowed down fetching artifacts in various API methods. (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9355)
• Some errors from wandb.Api have better string representations (@timoffex in https://github.com/wandb/wandb/pull/9361)
• Artifact.add_reference, when used with file URIs for a directory and the name parameter, was incorrectly adding the value of name to the path of the file references (@ssisk in https://github.com/wandb/wandb/pull/9378)
• Fixed a bug causing Artifact.add_reference() with checksum=False to log new versions of local reference artifacts without changes to the reference URI. (@tonyyli-wandb in https://github.com/wandb/wandb/pull/9326)

What's Changed

Added

• Added wandb login --base-url {host_url} to login as an alias of wandb login --host {host_url}. (@jacobromero in https://github.com/wandb/wandb/pull/9323)

Changed

• Temporarily disabled collecting per-core CPU utilization stats (@dmitryduev in https://github.com/wandb/wandb/pull/9350)

Fixed

• Fixed a bug causing offline mode to make network requests when logging media artifacts. If you are using an older version of W&B Server that does not support offline artifact uploads, use the setting allow_offline_artifacts=False to revert to older compatible behavior. (@domphan-wandb in https://github.com/wandb/wandb/pull/9267)
• Expand sanitization rules for logged table artifact name to allow for hyphens and dots. This update brings the rules up-to-date with the current rules for artifact names. (Allowing letters, numbers, underscores, hyphens, and dots) (@nicholaspun-wandb in https://github.com/wandb/wandb/pull/9271)
• Correctly handle run rewind settings fork_from and resume_from. (@dmitryduev in https://github.com/wandb/wandb/pull/9331)

What's Changed

Fixed

• Fix incorrectly reported device counts and duty cycle measurements for TPUs with single devices per chip / multiple devices on the host and make TPU metrics sampling more robust (@dmitryduev in https://github.com/wandb/wandb/pull/9266)
• Handle non-consecutive TPU device IDs in system monitor (@dmitryduev in https://github.com/wandb/wandb/pull/9276)

What's Changed

Fixed

• Fix wandb.Settings update regression in wandb.integration.metaflow (@kptkin in https://github.com/wandb/wandb/pull/9211)

What's Changed

Added

• Support JWT authentication in wandb-core (@elainaRenee in https://github.com/wandb/wandb/pull/8431)
• Add support for logging nested custom charts. (@jacobromero in https://github.com/wandb/wandb/pull/8789)

Changed

• Calling wandb.init(mode="disabled") no longer disables all later runs by default. Use wandb.setup(settings=wandb.Settings(mode="disabled")) for this instead, or set mode="disabled" explicitly in each call to wandb.init(). (@timoffex in https://github.com/wandb/wandb/pull/9172)

Fixed

• The stop button correctly interrupts runs whose main Python thread is running C code, sleeping, etc. (@timoffex in https://github.com/wandb/wandb/pull/9094)
• Remove unintentional print that occurs when inspecting wandb.Api().runs() (@tomtseng in https://github.com/wandb/wandb/pull/9101)
• Fix uploading large artifacts when using Azure Blob Storage. (@amulya-musipatla in https://github.com/wandb/wandb/pull/8946)
• The wandb offline command no longer adds an unsupported setting to wandb.Settings, resolving ValidationError. (@kptkin in https://github.com/wandb/wandb/pull/9135)
• Fix error when reinitializing a run, caused by accessing a removed attribute. (@MathisTLD in https://github.com/wandb/wandb/pull/8912)
• Fixed occasional deadlock when using multiprocessing to update a single run from multiple processes (@timoffex in https://github.com/wandb/wandb/pull/9126)
• Prevent errors from bugs in older versions of botocore < 1.5.76 (@amusipatla-wandb, @tonyyli-wandb in https://github.com/wandb/wandb/pull/9015)
• Fixed various checks against invalid anonymous settings value. (@jacobromero in https://github.com/wandb/wandb/pull/9193)

Removed

• The wandb.wandb_sdk.wandb_setup._setup() function's reset parameter has been removed. Note that this is a private function, even though there appear to be usages outside of the repo. Please wandb.teardown() instead of _setup(reset=True). (@timoffex in https://github.com/wandb/wandb/pull/9165)
• In the private wandb.wandb_sdk.wandb_setup module, the logger and _set_logger symbols have been removed (@timoffex in https://github.com/wandb/wandb/pull/9195)

What's Changed

Fixed

• Fixed bug where setting WANDB__SERVICE_WAIT led to an exception during wandb.init (@TimSchneider42 in https://github.com/wandb/wandb/pull/9050)

Changed

• run.finish() displays more detailed information in the terminal and in Jupyter notebooks (by @timoffex, enabled in https://github.com/wandb/wandb/pull/9070)
• Improved error message for failing tensorboard.patch() calls to show the option to call tensorboard.unpatch() first (@daniel-bogdoll in https://github.com/wandb/wandb/pull/8938)
• Add projectId to deleteFiles mutation if the server supports it. (@jacobromero in https://github.com/wandb/wandb/pull/8837)

What's Changed

Changed

• Set default behavior to not create a W&B Job (@KyleGoyette in https://github.com/wandb/wandb/pull/8907)

Removed

• Remove wandb.Run.plot_table method. The functionality is still available and should be accessed using wandb.plot_table, which is now the recommended way to use this feature. (@kptkin in https://github.com/wandb/wandb/pull/8686)
• Drop support for Python 3.7. (@kptkin in https://github.com/wandb/wandb/pull/8858)

Fixed

• Fix ultralytics reporting if there are no positive examples in a validation batch. (@Jamil in https://github.com/wandb/wandb/pull/8870)
• Debug printing for hyperband stopping algorithm printed one char per line (@temporaer in https://github.com/wandb/wandb/pull/8955)
• Include the missing log_params argument when calling lightgbm's wandb_callback function. (@i-aki-y https://github.com/wandb/wandb/pull/8943)

What's Changed

Added

• Added create_and_run_agent to __all__ in wandb/sdk/launch/__init__.py to expose it as a public API (@marijncv in https://github.com/wandb/wandb/pull/8621)

Changed

• Tables logged in offline mode now have updated keys to artifact paths when syncing. To revert to old behavior, use setting allow_offline_artifacts = False. (@domphan-wandb in https://github.com/wandb/wandb/pull/8792)

Deprecated

• The quiet argument to wandb.run.finish() is deprecated, use wandb.Settings(quiet=...) to set this instead. (@kptkin in https://github.com/wandb/wandb/pull/8794)

Fixed

• Fix api.artifact() to correctly pass the enable_tracking argument to the Artifact._from_name() method (@ibindlish in https://github.com/wandb/wandb/pull/8803)

What's Changed

Added

• Add a boolean overwrite param to Artifact.add()/Artifact.add_file() to allow overwrite of previously-added artifact files (@tonyyli-wandb in https://github.com/wandb/wandb/pull/8553)

Fixed

• Add missing type hints of the wandb.plot module in the package stub (@kptkin in https://github.com/wandb/wandb/pull/8667)
• Fix limiting azure reference artifact uploads to max_objects (@amusipatla-wandb in https://github.com/wandb/wandb/pull/8703)
• Fix downloading azure reference artifacts with skip_cache=True (@amusipatla-wandb in https://github.com/wandb/wandb/pull/8706)
• Fix multipart uploads for files with no content type defined in headers (@amusipatla-wandb in https://github.com/wandb/wandb/pull/8716)
• Fixed tensorboard failing to sync when logging batches of images. (@jacobromero in https://github.com/wandb/wandb/pull/8641)
• Fixed behavior of mode='x'/mode='w' in Artifact.new_file() to conform to Python's built-in file modes (@tonyyli-wandb in https://github.com/wandb/wandb/pull/8553)
• Do not ignore parameter distribution when configuring sweep parameters from SDK. (@temporaer in https://github.com/wandb/wandb/pull/8737)

Changed

• Added internal method, api._artifact(), to fetch artifacts so that usage events are not created if not called by an external user. (@ibindlish in https://github.com/wandb/wandb/pull/8674)
• Changed default mode in Artifact.new_file() from 'w' to 'x' to accurately reflect existing default behavior (@tonyyli-wandb in https://github.com/wandb/wandb/pull/8553)

What's Changed

Fixed

• Import Literal from typing_extensions in Python 3.7; broken in 0.18.4 (@timoffex in https://github.com/wandb/wandb/pull/8656)

What's Changed

Added

• Track detailed metrics for Apple ARM systems including GPU, eCPU, and pCPU utilization, power consumption, and temperature, and memory/swap utilization (@dmitryduev in https://github.com/wandb/wandb/pull/8550)
• Allow users to link Registry artifacts without inputting the organization entity name (@estellazx in https://github.com/wandb/wandb/pull/8482)
• Added a warning message indicating that the fps argument will be ignored when creating a wandb.Video object from a file path string or a bytes object. (@jacobromero in https://github.com/wandb/wandb/pull/8585)
• Update docstrings for logged_artifacts and used_artifacts methods in Run class (@trane293 in https://github.com/wandb/wandb/pull/8624)
• The _show_operation_stats setting enables a preview of a better run.finish() UX (@timoffex in https://github.com/wandb/wandb/pull/8644)

Fixed

• Log power on AMD MI300X series GPUs (@dmitryduev in https://github.com/wandb/wandb/pull/8630)
• Fixed typing issue of wandb.Api (@bdvllrs in https://github.com/wandb/wandb/pull/8548)

Changed

• Updated minimum version of sentry-sdk to 2.0.0 to address deprecation warnings. (@jacobromero in https://github.com/wandb/wandb/compare/WB-20890)

What's Changed

Added

• Add the ability to monitor the utilization metrics of Google's Cloud TPU devices (@dmitryduev in https://github.com/wandb/wandb/pull/8504)

Fixed

• Capture Nvidia GPU stats on Windows (@dmitryduev in https://github.com/wandb/wandb/pull/8524)
• Fixed a regression introduced in v0.18.2 that affected capturing the names of Nvidia GPU devices (@dmitryduev in https://github.com/wandb/wandb/pull/8503)
• run.log_artifact() no longer blocks other data uploads until the artifact upload finishes (@timoffex in https://github.com/wandb/wandb/pull/8466)
• Fixed media dependency for rdkit updated from rdkit-pypi to rdkit (@jacobromero in https://github.com/wandb/wandb/compare/WB-20894)
• Saving an artifact with many large files no longer exhausts OS threads (@timoffex in https://github.com/wandb/wandb/pull/8518)

Changed

• After artifact = run.log_artifact(), you must use artifact.wait() before operations that rely on the artifact having been uploaded. Previously, this wasn't necessary in some cases because run.log_artifact() blocked other operations on the run (@timoffex in https://github.com/wandb/wandb/pull/8466)

What's Changed

Added

• Add upsert_run_queue method to wandb.Api. (@bcsherma in https://github.com/wandb/wandb/pull/8348)
• Add tags parameter to wandb.Api.artifacts() to filter artifacts by tag. (@moredatarequired in https://github.com/wandb/wandb/pull/8441)

Fixed

• Update the signature and docstring of wandb.api.public.runs.Run.log_artifact() to support artifact tags like Run instances returned by wandb.init(). (@tonyyli-wandb in https://github.com/wandb/wandb/pull/8414)
• Add docstring for wandb.watch to support auto-complete (@kptkin in https://github.com/wandb/wandb/pull/8425)
• Fix glob matching in define metric to work with logged keys containing / (@KyleGoyette in https://github.com/wandb/wandb/pull/8434)
• Allow a\.b syntax in run.define_metric to refer to a dotted metric name (@jacobromero in https://github.com/wandb/wandb/pull/8445)
• Fix Unknown image format error when uploading a gif through tensorboard. (@jacobromero in https://github.com/wandb/wandb/pull/8476)
• Fix OSError from calling Artifact.add_file with file paths on mounted filesystems (@tonyyli-wandb in https://github.com/wandb/wandb/pull/8473)
• Restored compatibility for macOS versions <= 10.15 for wandb-core. (@dmitryduev in https://github.com/wandb/wandb/pull/8487)

What's Changed

Fixed

• Allow all users to read cache files when core is enabled (@moredatarequired in https://github.com/wandb/wandb/pull/8362)
• Infinite scalars logged in TensorBoard are uploaded successfully rather than skipped (@timoffex in https://github.com/wandb/wandb/pull/8380)
• Properly respect WANDB_ERROR_REPORTING=false. This fixes a regression introduced in 0.18.0 (@kptkin in https://github.com/wandb/wandb/pull/8379)

Changed

• Default to capturing requirements.txt in Run.log_code (@KyleGoyette in https://github.com/wandb/wandb/pull/7864)

What's Changed

Added

• Add support for artifact tags, via Artifact.tags and Run.log_artifact() (@tonyyli-wandb in https://github.com/wandb/wandb/pull/8085)

Fixed

• Detect the notebook name in VS Code's built-in jupyter server (@dmitryduev in https://github.com/wandb/wandb/pull/8311)

Changed

• The new "core" backend, previously activated using wandb.require("core"), is now used by default. To revert to the legacy behavior, add wandb.require("legacy-service") at the beginning of your script. Note: In the upcoming minor release, the option to disable this new behavior will be removed (@kptkin in https://github.com/wandb/wandb/pull/7777)