METADATA 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237
  1. Metadata-Version: 2.4
  2. Name: wandb
  3. Version: 0.26.0
  4. Summary: A CLI and library for interacting with the Weights & Biases API.
  5. Project-URL: Source, https://github.com/wandb/wandb
  6. Project-URL: Bug Reports, https://github.com/wandb/wandb/issues
  7. Project-URL: Documentation, https://docs.wandb.ai
  8. Author-email: Weights & Biases <support@wandb.com>
  9. License: MIT License
  10. Copyright (c) 2021 Weights and Biases, Inc.
  11. Permission is hereby granted, free of charge, to any person obtaining a copy
  12. of this software and associated documentation files (the "Software"), to deal
  13. in the Software without restriction, including without limitation the rights
  14. to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  15. copies of the Software, and to permit persons to whom the Software is
  16. furnished to do so, subject to the following conditions:
  17. The above copyright notice and this permission notice shall be included in all
  18. copies or substantial portions of the Software.
  19. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  22. AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  23. LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  24. OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  25. SOFTWARE.
  26. License-File: LICENSE
  27. Classifier: Development Status :: 5 - Production/Stable
  28. Classifier: Intended Audience :: Developers
  29. Classifier: Intended Audience :: Science/Research
  30. Classifier: License :: OSI Approved :: MIT License
  31. Classifier: Natural Language :: English
  32. Classifier: Programming Language :: Go
  33. Classifier: Programming Language :: Python :: 3
  34. Classifier: Programming Language :: Python :: 3 :: Only
  35. Classifier: Programming Language :: Python :: 3.9
  36. Classifier: Programming Language :: Python :: 3.10
  37. Classifier: Programming Language :: Python :: 3.11
  38. Classifier: Programming Language :: Python :: 3.12
  39. Classifier: Programming Language :: Python :: 3.13
  40. Classifier: Programming Language :: Python :: 3.14
  41. Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
  42. Classifier: Topic :: Software Development :: Libraries :: Python Modules
  43. Classifier: Topic :: System :: Logging
  44. Classifier: Topic :: System :: Monitoring
  45. Requires-Python: >=3.9
  46. Requires-Dist: click>=8.0.1
  47. Requires-Dist: eval-type-backport; python_version < '3.10'
  48. Requires-Dist: gitpython!=3.1.29,>=1.0.0
  49. Requires-Dist: packaging
  50. Requires-Dist: platformdirs
  51. Requires-Dist: protobuf!=5.28.0,!=5.29.0,<8,>4.21.0
  52. Requires-Dist: pydantic<3
  53. Requires-Dist: pyyaml
  54. Requires-Dist: requests<3,>=2.0.0
  55. Requires-Dist: sentry-sdk>=2.0.0
  56. Requires-Dist: typing-extensions<5,>=4.8
  57. Provides-Extra: aws
  58. Requires-Dist: boto3; extra == 'aws'
  59. Requires-Dist: botocore>=1.5.76; extra == 'aws'
  60. Provides-Extra: azure
  61. Requires-Dist: azure-identity; extra == 'azure'
  62. Requires-Dist: azure-storage-blob; extra == 'azure'
  63. Provides-Extra: gcp
  64. Requires-Dist: google-cloud-storage; extra == 'gcp'
  65. Provides-Extra: importers
  66. Requires-Dist: filelock; extra == 'importers'
  67. Requires-Dist: mlflow; extra == 'importers'
  68. Requires-Dist: polars<=1.2.1; extra == 'importers'
  69. Requires-Dist: rich; extra == 'importers'
  70. Requires-Dist: tenacity; extra == 'importers'
  71. Provides-Extra: kubeflow
  72. Requires-Dist: google-cloud-storage; extra == 'kubeflow'
  73. Requires-Dist: kubernetes; extra == 'kubeflow'
  74. Requires-Dist: minio; extra == 'kubeflow'
  75. Requires-Dist: sh; extra == 'kubeflow'
  76. Provides-Extra: launch
  77. Requires-Dist: awscli; extra == 'launch'
  78. Requires-Dist: azure-containerregistry; extra == 'launch'
  79. Requires-Dist: azure-identity; extra == 'launch'
  80. Requires-Dist: azure-storage-blob; extra == 'launch'
  81. Requires-Dist: boto3; extra == 'launch'
  82. Requires-Dist: botocore>=1.5.76; extra == 'launch'
  83. Requires-Dist: chardet; extra == 'launch'
  84. Requires-Dist: google-auth; extra == 'launch'
  85. Requires-Dist: google-cloud-aiplatform; extra == 'launch'
  86. Requires-Dist: google-cloud-artifact-registry; extra == 'launch'
  87. Requires-Dist: google-cloud-compute; extra == 'launch'
  88. Requires-Dist: google-cloud-storage; extra == 'launch'
  89. Requires-Dist: iso8601; extra == 'launch'
  90. Requires-Dist: jsonschema; extra == 'launch'
  91. Requires-Dist: kubernetes; extra == 'launch'
  92. Requires-Dist: kubernetes-asyncio; extra == 'launch'
  93. Requires-Dist: nbconvert; extra == 'launch'
  94. Requires-Dist: nbformat; extra == 'launch'
  95. Requires-Dist: optuna; extra == 'launch'
  96. Requires-Dist: pydantic; extra == 'launch'
  97. Requires-Dist: pyyaml>=6.0.0; extra == 'launch'
  98. Requires-Dist: tomli; extra == 'launch'
  99. Requires-Dist: tornado>=6.5.0; (python_version >= '3.9') and extra == 'launch'
  100. Requires-Dist: typing-extensions; extra == 'launch'
  101. Provides-Extra: media
  102. Requires-Dist: bokeh; extra == 'media'
  103. Requires-Dist: imageio>=2.28.1; extra == 'media'
  104. Requires-Dist: moviepy>=1.0.0; extra == 'media'
  105. Requires-Dist: numpy; extra == 'media'
  106. Requires-Dist: pillow; extra == 'media'
  107. Requires-Dist: plotly>=5.18.0; extra == 'media'
  108. Requires-Dist: rdkit; extra == 'media'
  109. Requires-Dist: soundfile; extra == 'media'
  110. Provides-Extra: models
  111. Requires-Dist: cloudpickle; extra == 'models'
  112. Provides-Extra: sweeps
  113. Requires-Dist: sweeps>=0.2.0; extra == 'sweeps'
  114. Provides-Extra: workspaces
  115. Requires-Dist: wandb-workspaces; extra == 'workspaces'
  116. Description-Content-Type: text/markdown
  117. <div align="center">
  118. <img src="https://i.imgur.com/dQLeGCc.png" width="600" /><br><br>
  119. </div>
  120. <p align="center">
  121. <a href="https://pypi.python.org/pypi/wandb"><img src="https://img.shields.io/pypi/v/wandb" /></a>
  122. <a href="https://anaconda.org/conda-forge/wandb"><img src="https://img.shields.io/conda/vn/conda-forge/wandb" /></a>
  123. <a href="https://pypi.python.org/pypi/wandb"><img src="https://img.shields.io/pypi/pyversions/wandb" /></a>
  124. <a href="https://circleci.com/gh/wandb/wandb"><img src="https://img.shields.io/circleci/build/github/wandb/wandb/main" /></a>
  125. <a href="https://codecov.io/gh/wandb/wandb"><img src="https://img.shields.io/codecov/c/gh/wandb/wandb" /></a>
  126. </p>
  127. <p align='center'>
  128. <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>
  129. </p>
  130. 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)!
  131. <br>
  132. 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.
  133. &nbsp;
  134. # Documentation
  135. 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.
  136. &nbsp;
  137. # Quickstart
  138. Install W&B to track, visualize, and manage machine learning experiments of any size.
  139. ## Install the wandb library
  140. ```shell
  141. pip install wandb
  142. ```
  143. ## Sign up and create an API key
  144. 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.
  145. ## Create a machine learning training experiment
  146. In your Python script or notebook, initialize a W&B run with `wandb.init()`.
  147. Specify hyperparameters and log metrics and other information to W&B.
  148. ```python
  149. import wandb
  150. # Project that the run is recorded to
  151. project = "my-awesome-project"
  152. # Dictionary with hyperparameters
  153. config = {"epochs" : 1337, "lr" : 3e-4}
  154. # The `with` syntax marks the run as finished upon exiting the `with` block,
  155. # and it marks the run "failed" if there's an exception.
  156. #
  157. # In a notebook, it may be more convenient to write `run = wandb.init()`
  158. # and manually call `run.finish()` instead of using a `with` block.
  159. with wandb.init(project=project, config=config) as run:
  160. # Training code here
  161. # Log values to W&B with run.log()
  162. run.log({"accuracy": 0.9, "loss": 0.1})
  163. ```
  164. 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.
  165. &nbsp;
  166. # Integrations
  167. 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.
  168. 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).
  169. &nbsp;
  170. # W&B Hosting Options
  171. 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:
  172. 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.
  173. 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.
  174. 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.
  175. See the [Hosting documentation](https://docs.wandb.ai/platform/hosting?utm_source=github&utm_medium=code&utm_campaign=wandb&utm_content=hosting) in the W&B Developer Guide for more information.
  176. &nbsp;
  177. # Python Version Support
  178. 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/).
  179. When we discontinue support for a Python version, we will increment the library’s minor version number to reflect this change.
  180. &nbsp;
  181. # Contribution guidelines
  182. 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.
  183. &nbsp;
  184. # W&B Community
  185. Be a part of the growing W&B Community and interact with the W&B team in our [Discord](https://wandb.me/discord). Stay connected with the latest ML updates and tutorials with [W&B Fully Connected](https://wandb.ai/fully-connected).
  186. &nbsp;
  187. # License
  188. [MIT License](https://github.com/wandb/wandb/blob/main/LICENSE)