wandb 0.20.2rc20250616__py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl → 0.23.0rc1__py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

package_readme.md

@@ -1,88 +1,107 @@
 <div align="center">
-  <img src="https://i.imgur.com/RUtiVzH.png" width="600" /><br><br>
+  <img src="https://i.imgur.com/dQLeGCc.png" width="600" /><br><br>
 </div>
 
-# Weights and Biases [![PyPI](https://img.shields.io/pypi/v/wandb)](https://pypi.python.org/pypi/wandb) [![Conda (channel only)](https://img.shields.io/conda/vn/conda-forge/wandb)](https://anaconda.org/conda-forge/wandb) [![CircleCI](https://img.shields.io/circleci/build/github/wandb/wandb/main)](https://circleci.com/gh/wandb/wandb) [![Codecov](https://img.shields.io/codecov/c/gh/wandb/wandb)](https://codecov.io/gh/wandb/wandb)
+<p align="center">
+<a href="https://pypi.python.org/pypi/wandb"><img src="https://img.shields.io/pypi/v/wandb" /></a>
+<a href="https://anaconda.org/conda-forge/wandb"><img src="https://img.shields.io/conda/vn/conda-forge/wandb" /></a>
+<a href="https://pypi.python.org/pypi/wandb"><img src="https://img.shields.io/pypi/pyversions/wandb" /></a>
+<a href="https://circleci.com/gh/wandb/wandb"><img src="https://img.shields.io/circleci/build/github/wandb/wandb/main" /></a>
+<a href="https://codecov.io/gh/wandb/wandb"><img src="https://img.shields.io/codecov/c/gh/wandb/wandb" /></a>
+</p>
+<p align='center'>
+<a href="https://colab.research.google.com/github/wandb/examples/blob/master/colabs/intro/Intro_to_Weights_%26_Biases.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" /></a>
+</p>
 
-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 an account!](https://wandb.com?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=readme)
+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](https://wandb.com?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=readme)!
 
+<br>
 
+Building an LLM app? Track, debug, evaluate, and monitor LLM apps with [Weave](https://wandb.github.io/weave?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=readme), our new suite of tools for GenAI.
 
-See the [W&B Developer Guide](https://docs.wandb.ai/?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=documentation) and [API Reference Guide](https://docs.wandb.ai/ref?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=documentation) for a full technical description of the W&B platform.
+&nbsp;
+
+# Documentation
+
+See the [W&B Developer Guide](https://docs.wandb.ai/?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=documentation) and [API Reference Guide](https://docs.wandb.ai/training/api-reference#api-overview?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=documentation) for a full technical description of the W&B platform.
 
 &nbsp;
 
 # Quickstart
 
-Get started with W&B in four steps:
+Install W&B to track, visualize, and manage machine learning experiments of any size.
 
-1. First, sign up for a [W&B account](https://wandb.ai/login?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=quickstart).
-
-2. Second, install the W&B SDK with [pip](https://pip.pypa.io/en/stable/). Navigate to your terminal and type the following command:
+## Install the wandb library
 
 ```shell
 pip install wandb
 ```
 
-3. Third, log into W&B:
+## Sign up and create an API key
 
-```python
-wandb.login()
-```
+Sign up for a [W&B account](https://wandb.ai/login?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=quickstart). 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.
 
-4. Use the example code snippet below as a template to integrate W&B to your Python script:
+## 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.
 
 ```python
 import wandb
 
-# Start a W&B Run with wandb.init
-run = wandb.init(project="my_first_project")
-
-# Save model inputs and hyperparameters in a wandb.config object
-config = run.config
-config.learning_rate = 0.01
+# Project that the run is recorded to
+project = "my-awesome-project"
 
-# Model training code here ...
+# Dictionary with hyperparameters
+config = {"epochs" : 1337, "lr" : 3e-4}
 
-# Log metrics over time to visualize performance with wandb.log
-for i in range(10):
-    run.log({"loss": ...})
+# 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
 
-# Mark the run as finished, and finish uploading all data
-run.finish()
+    # Log values to W&B with run.log()
+    run.log({"accuracy": 0.9, "loss": 0.1})
 ```
 
-For example, if the preceding code was stored in a script called train.py:
+Visit [wandb.ai/home](https://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.
 
-```shell
-python train.py
-```
+&nbsp;
 
-You will see a URL in your terminal logs when your script starts and finishes. Data is staged locally in a directory named _wandb_ relative to your script. Navigate to the W&B App to view a dashboard of your first W&B Experiment. Use the W&B App to compare multiple experiments in a unified place, dive into the results of a single run, and much more!
+# Integrations
+
+W&B [integrates](https://docs.wandb.ai/models/integrations) 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](https://docs.wandb.ai/models/integrations/add-wandb-to-any-library).
 
 &nbsp;
 
-# Integrations
+# 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:
 
-Use your favorite framework with W&B. W&B integrations make it fast and easy to set up experiment tracking and data versioning inside existing projects. For more information on how to integrate W&B with the framework of your choice, see [W&B Integrations](https://docs.wandb.ai/guides/integrations) in the W&B Developer Guide.
+1. [Multi-tenant Cloud](https://docs.wandb.ai/platform/hosting/hosting-options/multi_tenant_cloud?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=hosting): Fully managed platform deployed in W&B’s Google Cloud Platform (GCP) account in GCP’s North America regions.
+2. [Dedicated Cloud](https://docs.wandb.ai/platform/hosting/hosting-options/dedicated_cloud?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=hosting): 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](https://docs.wandb.ai/platform/hosting/hosting-options/self-managed?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=hosting): Deploy W&B Server on your AWS, GCP, or Azure cloud account or within your on-premises infrastructure.
+
+See the [Hosting documentation](https://docs.wandb.ai/guides/hosting?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=hosting) in the W&B Developer Guide for more information.
 
 &nbsp;
 
 # 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](https://devguide.python.org/versions/).
+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](https://devguide.python.org/versions/).
 
 When we discontinue support for a Python version, we will increment the library’s minor version number to reflect this change.
 
 &nbsp;
 
 # Contribution guidelines
-Weights & Biases ❤️ open source, and we welcome contributions from the community! See the [Contribution guide](https://github.com/wandb/wandb/blob/main/CONTRIBUTING.md) for more information on the development workflow and the internals of the wandb library. For wandb bugs and feature requests, visit [GitHub Issues](https://github.com/wandb/wandb/issues) or contact support@wandb.com.
 
-&nbsp;
-
-# Academic Researchers
-Reach out to W&B Support at support@wandb.com to get a [free academic license](https://www.wandb.com/academic) for you and your research group.
+Weights & Biases ❤️ open source, and we welcome contributions from the community! See the [Contribution guide](https://github.com/wandb/wandb/blob/main/CONTRIBUTING.md) for more information on the development workflow and the internals of the wandb library. For wandb bugs and feature requests, visit [GitHub Issues](https://github.com/wandb/wandb/issues) or contact support@wandb.com.
 
 &nbsp;
 

wandb/__init__.py

@@ -6,11 +6,11 @@ For guides and examples, see https://docs.wandb.ai.
 
 For scripts and interactive notebooks, see https://github.com/wandb/examples.
 
-For reference documentation, see https://docs.wandb.com/ref/python.
+For reference documentation, see https://docs.wandb.ai/models/ref/python.
 """
 from __future__ import annotations
 
-__version__ = "0.20.2rc20250616"
+__version__ = "0.23.0rc1"
 
 
 from wandb.errors import Error
@@ -31,7 +31,6 @@ wandb.wandb_lib = wandb_sdk.lib  # type: ignore
 init = wandb_sdk.init
 setup = wandb_sdk.setup
 attach = _attach = wandb_sdk._attach
-_sync = wandb_sdk._sync
 teardown = _teardown = wandb_sdk.teardown
 finish = wandb_sdk.finish
 join = finish
@@ -53,7 +52,6 @@ _lazyloader = wandb.wandb_lib.lazyloader  # type: ignore
 
 from wandb.integration.torch import wandb_torch
 
-# Move this (keras.__init__ expects it at top level)
 from wandb.sdk.data_types._private import _cleanup_media_tmp_dir
 
 _cleanup_media_tmp_dir()
@@ -61,8 +59,6 @@ _cleanup_media_tmp_dir()
 from wandb.data_types import Graph
 from wandb.data_types import Image
 from wandb.data_types import Plotly
-
-# from wandb.data_types import Bokeh # keeping out of top level for now since Bokeh plots have poor UI
 from wandb.data_types import Video
 from wandb.data_types import Audio
 from wandb.data_types import Table
@@ -79,71 +75,47 @@ from wandb.wandb_agent import agent
 from wandb.plot import visualize, plot_table
 from wandb.integration.sagemaker import sagemaker_auth
 from wandb.sdk.internal import profiler
+from wandb.sdk.wandb_run import Run
 
 # Artifact import types
 from wandb.sdk.artifacts.artifact_ttl import ArtifactTTL
 
-# Used to make sure we don't use some code in the incorrect process context
-_IS_INTERNAL_PROCESS = False
-
-
-def _set_internal_process(disable=False):
-    global _IS_INTERNAL_PROCESS
-    if _IS_INTERNAL_PROCESS is None:
-        return
-    if disable:
-        _IS_INTERNAL_PROCESS = None
-        return
-    _IS_INTERNAL_PROCESS = True
-
-
-def _assert_is_internal_process():
-    if _IS_INTERNAL_PROCESS is None:
-        return
-    assert _IS_INTERNAL_PROCESS
-
-
-def _assert_is_user_process():
-    if _IS_INTERNAL_PROCESS is None:
-        return
-    assert not _IS_INTERNAL_PROCESS
-
 
 # globals
 Api = PublicApi
 api = InternalApi()
-run: wandb_sdk.wandb_run.Run | None = None
+run: Run | None = None
 config = _preinit.PreInitObject("wandb.config", wandb_sdk.wandb_config.Config)
 summary = _preinit.PreInitObject("wandb.summary", wandb_sdk.wandb_summary.Summary)
-log = _preinit.PreInitCallable("wandb.log", wandb_sdk.wandb_run.Run.log)  # type: ignore
-watch = _preinit.PreInitCallable("wandb.watch", wandb_sdk.wandb_run.Run.watch)  # type: ignore
-unwatch = _preinit.PreInitCallable("wandb.unwatch", wandb_sdk.wandb_run.Run.unwatch)  # type: ignore
-save = _preinit.PreInitCallable("wandb.save", wandb_sdk.wandb_run.Run.save)  # type: ignore
+log = _preinit.PreInitCallable("wandb.log", Run.log)  # type: ignore
+watch = _preinit.PreInitCallable("wandb.watch", Run.watch)  # type: ignore
+unwatch = _preinit.PreInitCallable("wandb.unwatch", Run.unwatch)  # type: ignore
+save = _preinit.PreInitCallable("wandb.save", Run.save)  # type: ignore
 restore = wandb_sdk.wandb_run.restore
 use_artifact = _preinit.PreInitCallable(
-    "wandb.use_artifact", wandb_sdk.wandb_run.Run.use_artifact  # type: ignore
+    "wandb.use_artifact", Run.use_artifact  # type: ignore
 )
 log_artifact = _preinit.PreInitCallable(
-    "wandb.log_artifact", wandb_sdk.wandb_run.Run.log_artifact  # type: ignore
+    "wandb.log_artifact", Run.log_artifact  # type: ignore
 )
 log_model = _preinit.PreInitCallable(
-    "wandb.log_model", wandb_sdk.wandb_run.Run.log_model  # type: ignore
+    "wandb.log_model", Run.log_model  # type: ignore
 )
 use_model = _preinit.PreInitCallable(
-    "wandb.use_model", wandb_sdk.wandb_run.Run.use_model  # type: ignore
+    "wandb.use_model", Run.use_model  # type: ignore
 )
 link_model = _preinit.PreInitCallable(
-    "wandb.link_model", wandb_sdk.wandb_run.Run.link_model  # type: ignore
+    "wandb.link_model", Run.link_model  # type: ignore
 )
 define_metric = _preinit.PreInitCallable(
-    "wandb.define_metric", wandb_sdk.wandb_run.Run.define_metric  # type: ignore
+    "wandb.define_metric", Run.define_metric  # type: ignore
 )
 
 mark_preempting = _preinit.PreInitCallable(
-    "wandb.mark_preempting", wandb_sdk.wandb_run.Run.mark_preempting  # type: ignore
+    "wandb.mark_preempting", Run.mark_preempting  # type: ignore
 )
 
-alert = _preinit.PreInitCallable("wandb.alert", wandb_sdk.wandb_run.Run.alert)  # type: ignore
+alert = _preinit.PreInitCallable("wandb.alert", Run.alert)  # type: ignore
 
 # record of patched libraries
 patched = {"tensorboard": [], "keras": [], "gym": []}  # type: ignore
@@ -176,10 +148,9 @@ def ensure_configured():
 
 
 def set_trace():
-    import pdb  # TODO: support other debuggers
+    import pdb
 
-    #  frame = sys._getframe().f_back
-    pdb.set_trace()  # TODO: pass the parent stack...
+    pdb.set_trace()
 
 
 def load_ipython_extension(ipython):
@@ -192,8 +163,6 @@ if wandb_sdk.lib.ipython.in_notebook():
     load_ipython_extension(get_ipython())
 
 
-from .analytics import Sentry as _Sentry
-
 if "dev" in __version__:
     import wandb.env
     import os
@@ -204,9 +173,6 @@ if "dev" in __version__:
         "false",
     )
 
-_sentry = _Sentry()
-_sentry.setup()
-
 
 __all__ = (
     "__version__",
@@ -243,4 +209,5 @@ __all__ = (
     "watch",
     "unwatch",
     "plot_table",
+    "Run",
 )