A CLI and library for interacting with the Weights and Biases API.
Project description
Weights and Biases
![pypi](https://pypi-camo.freetls.fastly.net/8c7140ad245f81118928f9488c7c9ccb099b0e99/68747470733a2f2f696d672e736869656c64732e696f2f707970692f762f77616e64622e737667)
Use W&B to organize and analyze machine learning experiments. It's framework-agnostic and lighter than TensorBoard. Each time you run a script instrumented with wandb
, we save your hyperparameters and output metrics. Visualize models over the course of training, and compare versions of your models easily. We also automatically track the state of your code, system metrics, and configuration parameters.
Features
- Store hyper-parameters used in a training run
- Search, compare, and visualize training runs
- Analyze system usage metrics alongside runs
- Collaborate with team members
- Replicate historic results
- Run parameter sweeps
- Keep records of experiments available forever
Quickstart
pip install wandb
In your training script:
import wandb
# Your custom arguments defined here
args = ...
wandb.init(config=args, project="my-project")
wandb.config["more"] = "custom"
def training_loop():
while True:
# Do some machine learning
epoch, loss, val_loss = ...
# Framework agnostic / custom metrics
wandb.log({"epoch": epoch, "loss": loss, "val_loss": val_loss})
If you're already using Tensorboard or TensorboardX, you can integrate with one line:
wandb.init(sync_tensorboard=True)
Running your script
Run wandb login
from your terminal to signup or authenticate your machine (we store your api key in ~/.netrc). You can also set the WANDB_API_KEY
environment variable with a key from your settings.
Run your script with python my_script.py
and all metadata will be synced to the cloud. 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. If you want to test your script without syncing to the cloud you can set the environment variable WANDB_MODE=dryrun
.
If you are using docker to run your code, we provide a wrapper command wandb docker
that mounts your current directory, sets environment variables, and ensures the wandb library is installed. Training your models in docker gives you the ability to restore the exact code and environment with the wandb restore
command.
Web Interface
Sign up for a free account →
Introduction video →
Detailed Usage
Framework specific and detailed usage can be found in our documentation.
Testing
To run the tests we use pytest tests
. If you want a simple mock of the wandb backend and cloud storage you can use the mock_server fixture, see tests/test_cli.py for examples.
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
Built Distribution
Hashes for wandb-0.8.10-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 938f758ffd3c7d7df86dbc48caf1ead588ca5729ae322b1a1f321feb573f4615 |
|
MD5 | 49cb274185cccf22f04679506e98cf36 |
|
BLAKE2b-256 | 1b32f6c330acfc6e823598fb3b4ebc34bbaf3962157f11c08c0b2501c735bdb7 |