Skip to main content

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.

Important

Start your workspace data export now. High export traffic near the deadline can significantly slow or break exports. Delaying increases the risk that your export will not finish in time.

After March 5, 2026, all remaining data will be permanently deleted and any running exports will stop - there will be no extensions and no recovery options.

If you encounter issues, contact us immediately at support@neptune.ai or via in-app chat.

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 the specified projects to your local storage, run:

uv run neptune-exporter export \
  -p "my-workspace/my-project-1" \
  -p "my-workspace/my-project-2" \
  --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.

Project selection: explicit or workspace discovery​

You can choose projects in two ways (do not mix both in one command):

  • Explicit mode: Pass one or more -p / --project-ids (or set NEPTUNE_PROJECT).
  • Discovery mode: Pass --workspace to export all projects in that workspace, optionally with --project-pattern (include regex on project names) and --project-exclude-pattern (exclude regex on project names). Patterns match the project name only (the part after workspace/).

Export all projects from a workspace:

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

Export only projects whose names match an include pattern:

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

Export with both include and exclude patterns:

uv run neptune-exporter export \
  --workspace "my-workspace" \
  --project-pattern ".*prod.*" \
  --project-exclude-pattern ".*archive.*" \
  --exporter neptune3 \
  --data-path ./exports/data \
  --files-path ./exports/files
note

To improve the export speed, you can:

  • Split the export by project or run across different processes
  • Export only a relevant subset of projects, runs, or attributes
  • Exclude files from the export

If you're exporting a large amount of data, we recommend exporting not just across different processes, but different machines altogether. This way, disk I/O is not a bottleneck.

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:

caution

We do not endorse any of these tools. They are listed for your convenience only.