Skip to main content

Migration overview

Use Neptune Exporter to export your data from Neptune and optionally load it into other experiment tracking tools.

Migration steps:

  1. Check your Neptune version and choose the corresponding export guide.
  2. Use the Neptune Exporter CLI to get your data from Neptune.
  3. (Optional) Load the data into another tool.
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.

Neptune Exporter​

Neptune Exporter is a command-line tool for downloading your data from Neptune and migrating it into other platforms. It supports the following actions:

  • Download runs from Neptune to your local storage as Parquet files.
  • Select projects by explicit project IDs or by workspace discovery (export all projects in a workspace, with optional include/exclude regex filters on project names).
  • (Neptune 2.x only) Optionally export model registry data (models and model versions) to separate Parquet and files directories; project selection supports the same explicit and workspace-discovery modes.
  • Load the Parquet files into MLflow, Weights & Biases, Comet, ZenML, Lightning AI, Minfx.ai, or GoodSeed. The run structure – including forks, steps, and attributes – is preserved as closely as possible.
  • Validate your exports with a human-readable summary of the data layout (runs and, if exported, model registry).

You can use Neptune Exporter with both Neptune 2.x and Neptune 3.x. The exported files are in the same Parquet format, regardless of the Neptune version.

The README file contains detailed prerequisites and complete usage instructions.

Check your Neptune version​

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

  1. Log in to your Neptune workspace.
  2. In the left sidebar, go to the help menu → About Neptune.

Neptune app version 3.x

More ways to check your Neptune version

  • Docs URL:

  • Python packages/imports:

    • If you use neptune-scale and/or neptune-query (from neptune_scale import ...), you're on 3.x.
    • If you use the neptune package (import neptune), you're likely on 2.x.

Not sure? Email us a snippet of your requirements.txt/pyproject.toml (or pip show) at support@neptune.ai and we'll confirm.

Best practices​

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 system metrics and files from the export

For examples, see the Neptune 2.x or Neptune 3.x export guides.

note

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.