Skip to main content

A CLI and library for interacting with the Weights & Biases API.

Project description



Use W&B to build better models faster. Track and visualize all the pieces of your machine learning pipeline, from datasets to production machine learning models. Get started with W&B today, sign up for a W&B account!


Building an LLM app? Track, debug, evaluate, and monitor LLM apps with Weave, our new suite of tools for GenAI.

 

Documentation

See the W&B Developer Guide and API Reference Guide for a full technical description of the W&B platform.

 

Quickstart

Install W&B to track, visualize, and manage machine learning experiments of any size.

Install the wandb library

pip install wandb

Sign up and create an API key

Sign up for a W&B account. Optionally, use the wandb login CLI to configure an API key on your machine. You can skip this step -- W&B will prompt you for an API key the first time you use it.

Create a machine learning training experiment

In your Python script or notebook, initialize a W&B run with wandb.init(). Specify hyperparameters and log metrics and other information to W&B.

import wandb

# Project that the run is recorded to
project = "my-awesome-project"

# Dictionary with hyperparameters
config = {"epochs" : 1337, "lr" : 3e-4}

# The `with` syntax marks the run as finished upon exiting the `with` block,
# and it marks the run "failed" if there's an exception.
#
# In a notebook, it may be more convenient to write `run = wandb.init()`
# and manually call `run.finish()` instead of using a `with` block.
with wandb.init(project=project, config=config) as run:
    # Training code here

    # Log values to W&B with run.log()
    run.log({"accuracy": 0.9, "loss": 0.1})

Visit wandb.ai/home to view recorded metrics such as accuracy and loss and how they changed during each training step. Each run object appears in the Runs column with generated names.

 

Integrations

W&B integrates with popular ML frameworks and libraries making it fast and easy to set up experiment tracking and data versioning inside existing projects.

For developers adding W&B to a new framework, follow the W&B Developer Guide.

 

W&B Hosting Options

Weights & Biases is available in the cloud or installed on your private infrastructure. Set up a W&B Server in a production environment in one of three ways:

  1. Multi-tenant Cloud: Fully managed platform deployed in W&B’s Google Cloud Platform (GCP) account in GCP’s North America regions.
  2. Dedicated Cloud: Single-tenant, fully managed platform deployed in W&B’s AWS, GCP, or Azure cloud accounts. Each Dedicated Cloud instance has its own isolated network, compute and storage from other W&B Dedicated Cloud instances.
  3. Self-Managed: Deploy W&B Server on your AWS, GCP, or Azure cloud account or within your on-premises infrastructure.

See the Hosting documentation in the W&B Developer Guide for more information.

 

Python Version Support

We are committed to supporting our minimum required Python version for at least six months after its official end-of-life (EOL) date, as defined by the Python Software Foundation. You can find a list of Python EOL dates here.

When we discontinue support for a Python version, we will increment the library’s minor version number to reflect this change.

 

Contribution guidelines

Weights & Biases ❤️ open source, and we welcome contributions from the community! See the Contribution guide for more information on the development workflow and the internals of the wandb library. For wandb bugs and feature requests, visit GitHub Issues or contact support@wandb.com.

 

W&B Community

Be a part of the growing W&B Community and interact with the W&B team in our Discord. Stay connected with the latest ML updates and tutorials with W&B Fully Connected.

 

License

MIT License

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wandb-0.27.0.tar.gz (41.1 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

wandb-0.27.0-py3-none-win_arm64.whl (23.0 MB view details)

Uploaded Python 3Windows ARM64

wandb-0.27.0-py3-none-win_amd64.whl (25.0 MB view details)

Uploaded Python 3Windows x86-64

wandb-0.27.0-py3-none-win32.whl (25.0 MB view details)

Uploaded Python 3Windows x86

wandb-0.27.0-py3-none-musllinux_1_2_x86_64.whl (27.6 MB view details)

Uploaded Python 3musllinux: musl 1.2+ x86-64

wandb-0.27.0-py3-none-musllinux_1_2_aarch64.whl (25.6 MB view details)

Uploaded Python 3musllinux: musl 1.2+ ARM64

wandb-0.27.0-py3-none-manylinux_2_28_x86_64.whl (27.3 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ x86-64

wandb-0.27.0-py3-none-manylinux_2_28_aarch64.whl (25.5 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ ARM64

wandb-0.27.0-py3-none-macosx_12_0_x86_64.whl (26.0 MB view details)

Uploaded Python 3macOS 12.0+ x86-64

wandb-0.27.0-py3-none-macosx_12_0_arm64.whl (24.9 MB view details)

Uploaded Python 3macOS 12.0+ ARM64

File details

Details for the file wandb-0.27.0.tar.gz.

File metadata

  • Download URL: wandb-0.27.0.tar.gz
  • Upload date:
  • Size: 41.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for wandb-0.27.0.tar.gz
Algorithm Hash digest
SHA256 579e75300173059f9334e1f513a79ef15f6d9ea5c74e20d695633648cdd02031
MD5 9ffcccc6062c113cc7ff9393df2b3c93
BLAKE2b-256 8e31fe53d06b75ef0a7f2f0ee5931a89f7aedc27d233840b1839616860fed256

See more details on using hashes here.

File details

Details for the file wandb-0.27.0-py3-none-win_arm64.whl.

File metadata

  • Download URL: wandb-0.27.0-py3-none-win_arm64.whl
  • Upload date:
  • Size: 23.0 MB
  • Tags: Python 3, Windows ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for wandb-0.27.0-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 a6c129c311edf210a2b4f2f4acc557eff522628125f5f28ed27df19c16c07079
MD5 5f5494a1117b2a12df2a8b8f6b8b0e84
BLAKE2b-256 f638f7efd7a87297a55c7e9a331a1dbb5b19e54aeacc11fe6f43f8636a73987c

See more details on using hashes here.

File details

Details for the file wandb-0.27.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: wandb-0.27.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 25.0 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for wandb-0.27.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 89d584b73166eecee96fb446f18d0e45b1aa45aba6a3696296f3f06d7454516b
MD5 c74c89b071dd411488b0e6321fdbae3f
BLAKE2b-256 54ff69f88e7d90c22b79bcb911143c13e59742ee192080b21015ff83a5a1f60a

See more details on using hashes here.

File details

Details for the file wandb-0.27.0-py3-none-win32.whl.

File metadata

  • Download URL: wandb-0.27.0-py3-none-win32.whl
  • Upload date:
  • Size: 25.0 MB
  • Tags: Python 3, Windows x86
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for wandb-0.27.0-py3-none-win32.whl
Algorithm Hash digest
SHA256 0bd5659417e386bf6538b5e2ffe6885774c6197f0e4853bfed517d5b0db457f1
MD5 2bf6e9f18fe8397980e6b3a79ea9c834
BLAKE2b-256 5f40bf510c8758727df020f83b717ebc1fcc1739ed7f6ae1796ebef60bf6f592

See more details on using hashes here.

File details

Details for the file wandb-0.27.0-py3-none-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for wandb-0.27.0-py3-none-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 17aae6e4a88cd05c00ea8f546220918e3ebb6f8c1c36b70ef04a5ac75f0d7160
MD5 b268b198169c9af0f1f438591ea9024c
BLAKE2b-256 9451a69ac59300e3c813939d0764348959ed2a21e14c668cb1cebcb04010da6a

See more details on using hashes here.

File details

Details for the file wandb-0.27.0-py3-none-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for wandb-0.27.0-py3-none-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 63acfc5b994e4a90e4a2fbdee6d45e664da3dd865bb1419942c8995c06c41cf1
MD5 73486ae482225f8fe96e47aaa1265cf5
BLAKE2b-256 005e279d167ba79fb7a8a43401c9f25efd0f6663ee9bd1eaf5a8578530198888

See more details on using hashes here.

File details

Details for the file wandb-0.27.0-py3-none-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for wandb-0.27.0-py3-none-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 f772da7005cc26a2a32b729a16982a583dc68b3d493df6a09d0aa5c5ca5a2060
MD5 d423347df4dbf97d1eb9127960dc4f8e
BLAKE2b-256 5f6a8721fcdf71d42639191040a77a585d2982402b1754700cb2ecfc2ca1470a

See more details on using hashes here.

File details

Details for the file wandb-0.27.0-py3-none-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for wandb-0.27.0-py3-none-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 626497d7975fa898d0a4a239da7a510483495ca3514510dbe75004a25963af4d
MD5 93faf05af06ca06d2e68fc28a09a3d0f
BLAKE2b-256 100ad3f159a201530b84b72ca5f98c68d1f351c2d9a1864558ed76c811407fae

See more details on using hashes here.

File details

Details for the file wandb-0.27.0-py3-none-macosx_12_0_x86_64.whl.

File metadata

File hashes

Hashes for wandb-0.27.0-py3-none-macosx_12_0_x86_64.whl
Algorithm Hash digest
SHA256 20179f38afb0158859a4141d29ac650d3fdbd0cf801a74ce25565c934f03776c
MD5 ac0944fac899dcda24a272b2af07e26b
BLAKE2b-256 0bcda617c871cd304a9804e56a7ec2ec2c65685bf0091a2b9f91910175a149e2

See more details on using hashes here.

File details

Details for the file wandb-0.27.0-py3-none-macosx_12_0_arm64.whl.

File metadata

File hashes

Hashes for wandb-0.27.0-py3-none-macosx_12_0_arm64.whl
Algorithm Hash digest
SHA256 c156be4851485f3c4160cb6eb2e8991b4cdeffbccefc5636d33cf5e254847365
MD5 879204a343a50c65952d9caf20a4826d
BLAKE2b-256 ea5e2c199e70e636ecfd217cde0bc7469f4511e1d03d0685eb92bfdfce391430

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page