Load data into GoodSeed

This guide shows how to load exported data into GoodSeed, a local experiment tracker.

info

You can learn more about GoodSeed at their website and docs. Try the live demo or the Neptune demo to see the UI—no install required.

The below image shows an example of Experiment data visualized in the GoodSeed web interface.

Before you start

• Export your data from Neptune using the Neptune Exporter tool. Start from the migration overview.
• Install the GoodSeed extra for Neptune Exporter: uv sync --extra goodseed.
• (Optional) Set GoodSeed home with the environment variable GOODSEED_HOME or in the command line with --goodseed-home (default: ~/.goodseed).
• (Optional) Set GoodSeed project with the environment variable GOODSEED_PROJECT or with --goodseed-project to override the project name for all imported runs; if unset, the Neptune project ID is used.

Validate your export

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

The following command loads the data into GoodSeed, using the default data and file paths:

uv run neptune-exporter load \
    --loader goodseed \
    --data-path ./exports/data \
    --files-path ./exports/files

With a custom GoodSeed home and project:

uv run neptune-exporter load \
    --loader goodseed \
    --goodseed-home /path/to/.goodseed \
    --goodseed-project my-project \
    --data-path ./exports/data \
    --files-path ./exports/files

After importing, run goodseed serve to start a local server and view your runs.

info

What gets imported: Parameters (float, int, string, bool, datetime, string set), float series, and string series. Files and histograms are not supported by GoodSeed and are skipped (the loader logs a warning for them).

info

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