Skip to main content
App version: 3.20251124

Export data from Neptune 3.x

Use Neptune Exporter to migrate your data from Neptune 3.x to other platforms, such as MLflow or Weights & Biases.

Verify Neptune version​

To check which version of the Neptune app you are using:

  1. Log in to your Neptune workspace.
  2. Go to Help → About Neptune.

Neptune app version 3.x

The version number should be 3.2025XXXX.X.

Example workflows​

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

Export an entire project​

To export all runs from a project to your local storage, run:

uv run neptune-exporter export \
  -p "my-workspace/my-project" \
  --exporter neptune3 \
  --data-path ./exports/data \
  --files-path ./exports/files

This command saves the Parquet data to the ./exports/data directory and the files to ./exports/files.

Export specific runs​

To export only runs that match the specified pattern, use the -r flag:

uv run neptune-exporter export \
  -p "my-workspace/my-project" \
  --exporter neptune3 \
  -r "RUN-.*" \

where RUN-.* is a regular expression that matches all run IDs starting with RUN-.

The run ID refers to the user-specified or auto-generated string stored in the sys/custom_run_id attribute of a run.

Export specific attributes​

To export only attributes that match the specified patterns, use the -a flag:

uv run neptune-exporter export \
  -p "my-workspace/my-project" \
  --exporter neptune3 \
  -a "metrics/accuracy" -a "metrics/loss" -a "config/.*"

Validate your export​

See what was exported by running the following command:

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.

info

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

Migrate to another tool​

You can migrate your exported data to another tool. See the following guides: