Skip to main content

Load data into Minfx

This guide shows how to load exported data into Minfx.

The below image shows an example of run metrics visualized in the Minfx web interface.

The Minfx web interface

Before you start

info

The Minfx loader currently supports only Neptune 2.x (Legacy Neptune).

  • Export your data from Neptune using the Neptune Exporter tool. You must run the export command with the --exporter neptune2 flag. Start from the migration overview.
  • Have your Minfx (Neptune 2.x) project and API token ready. You can set them with:
    • the MINFX_PROJECT and MINFX_API_TOKEN environment variables, or
    • the --minfx-project and --minfx-api-token command-line flags

Validate your export

Before loading the data into Minfx, 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 Minfx

To use the Minfx loader, ensure minfx is installed:

uv pip install minfx

To load the data into Minfx, use the following command:

uv run neptune-exporter load \
--loader minfx \
--minfx-project "target-workspace/target-project" \
--minfx-api-token "$MINFX_API_TOKEN" \
--data-path ./exports/data \
--files-path ./exports/files
info

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