wandb.init() is called from your training script an API call is made to create a run object on our servers. A new process is started to stream and collect metrics, thereby keeping all threads and logic out of your primary process. Your script runs normally and writes to local files, while the separate process streams them to our servers along with system metrics. You can always turn off streaming by running
wandb off from your training directory, or setting the WANDB_MODE environment variable to "dryrun".
It is extremely important to us that we never interfere with your training runs. We run wandb in a separate process to make sure that if wandb somehow crashes, your training will continue to run. If the internet goes out, wandb will continue to retry sending data to wandb.com.
Wandb should have negligible effect on your training performance if you use it normally. Normal use of wandb means logging less than once a second and logging less than a few megabytes of data at each step. Wandb runs in a separate process and the function calls don't block, so if the network goes down briefly or there are intermittent read write issues on disk it should not affect your performance. It is possible to log a huge amount of data quickly, and if you do that you might create disk I/O issues. If you have any questions, please don't hesitate to contact us.
If you're training on an offline machine and want to upload your results to our servers afterwards, we have a feature for you!
Set the environment variable
WANDB_MODE=dryrun to save the metrics locally, no internet required.
When you're ready, run
wandb init in your directory to set the project name.
wandb sync YOUR_RUN_DIRECTORY to push the metrics to our cloud service and see your results in our hosted web app.
You can pass a SHA or other unique identifier to
wandb.config.update(...) to associate a dataset with a training run. W&B does not store any data unless
wandb.save is called with the local file name.
By default metrics are collected every 2 seconds and averaged over a 30 second period. If you need higher resolution metrics, email us a email@example.com.
Currently the library only works with Python 2.7+ & 3.6+ projects. The architecture mentioned above should enable us to integrate with other languages easily. If you have a need for monitoring other languages, send us a note at firstname.lastname@example.org.
By default, we don't log any of your dataset examples. You can explicitly turn this feature on to see example predictions in our web interface.
There's two ways to turn off code logging:
Set WANDB_DISABLE_CODE to true to turn off all code tracking. We won't pick up the git SHA or the diff patch.
Set WANDB_IGNORE_GLOBS to *.patch to turn off syncing the diff patch to our servers. You'll still have it locally and be able to apply it with the wandb restore command.
Calling wandb.log writes a line to a local file; it does not block on any network calls. When you call wandb.init we launch a new process on the same machine that listens for filesystem changes and talks to our web service asynchronously from your training process.
We use the same exponential moving average formula as TensorBoard. You can find an explanation here: https://stackoverflow.com/questions/42281844/what-is-the-mathematics-behind-the-smoothing-parameter-in-tensorboards-scalar.
First of all, we use and love TensorBoard and you can easily integrate wandb with TensorBoard (see TensorBoard).
W&B is designed to be a central repository of every training run you or your organization does. Some of the difference that come from that are:
We scale up to saving and comparing thousands or millions of runs.
We also make it easy to log things at any point in your code with wandb.log()
We have visualizations like scatter plots and parallel coordinates charts designed to compare many ML runs at once
We make it easy to build and share reports with colleagues
At the top of your training script when you call wandb.init, pass in an experiment name, like this:
wandb.init(name="my awesome run")
We don't have an anaconda package but you should be able to install wandb using:
conda activate myenvpip install wandb
If you run into issues with this install, please let us know. The anaconda managing package resource at https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-pkgs.html may be helpful.
Set the environmental variable WANDB_SILENT.
In a notebook:
%env WANDB_SILENT true
In a python script:
os.environ["WANDB_SILENT"] = "true"
Press ctrl+D on your keyboard to stop a script that is instrumented with wandb.
If you're seeing SSL or network errors:
wandb: Network error (ConnectionError), entering retry loop. you can try a couple of different approaches to solving this issue:
Upgrade your SSL certificate. If you're running the script on an Ubuntu server, run
update-ca-certificates We can't sync training logs without a valid SSL certificate because it's a security vulnerability.
If your network is flakey, run training in offline mode and sync the files to us from a machine that has Internet access.
Try running W&B Local, which operates on your machine and doesn't sync files to our cloud servers.