Skip to main content

Load data into Weights & Biases

This guide shows how to load exported data into Weights & Biases.

tip

To get in touch with the Weights & Biases team, you can email: neptunemigration@wandb.com

Customers evaluating Weights & Biases as an alternative can find additional information provided by the Weights & Biases team in this PDF.

Before you start​

  • Export your data from Neptune using the Neptune Exporter tool. Start from the migration overview.
  • Get your Weights & Biases credentials:
    • W&B entity. You can set it with the environment variable WANDB_ENTITY or in the command line with --wandb-entity.
    • API key. You can set it with the environment variable WANDB_API_KEY or in the command line with --wandb-api-key.
note

To load data into a W&B Dedicated Cloud instance (single-tenant), set the WANDB_BASE_URL environment variable to your instance URL (for example, https://<your-instance>.wandb.io) before running the load command.
The W&B loader will then create projects and runs directly in that Dedicated instance instead of multi-tenant SaaS (wandb.ai).

Validate your export​

Before loading the data into Weights & Biases, inspect what was exported:

uv run neptune-exporter summary --data-path ./exports/data

This command returns the number of exported projects or runs, attribute types, and the basic step statistics.

Load the data into W&B​

The following command loads the data into Weights & Biases, using the default data and file paths:

uv run neptune-exporter load \
  --loader wandb \
  --wandb-entity my-org \
  --wandb-api-key "$WANDB_API_KEY" \
  --data-path ./exports/data \
  --files-path ./exports/files
info

For detailed instructions, see the Neptune Exporter README file on GitHub.