What’s new

0.4.6

Released on 2026-04-02 - GitHub - PyPI

What’s Changed

This release adds a new "BIND_PATHS" argument to container configurations which improves support for Docker. Other improvements include making nipoppy reorg able to handle pre-reorg data with identical filenames and improving the default config files created by nipoppy pipeline create.

Features

Bug Fixes

Documentation

Maintenance

New Contributors

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.4.5…0.4.6

0.4.5

Released on 2025-11-27 - GitHub - PyPI

What’s Changed

This release fixes a recent bug in 0.4.2 and 0.4.3 with nipoppy pipeline search due to changes in the Zenodo API.

Features

Bug Fixes

Maintenance

New Contributors

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.4.3…0.4.5

0.4.3

Released on 2025-11-25 - GitHub - PyPI

What’s Changed

Features

Bug Fixes

Deprecations

Documentation

Maintenance

Misc

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.4.2…0.4.3

0.4.2

Released on 2025-10-17 - GitHub - PyPI

TLDR

  • ✨Docker support✨

  • Speedup tracking via job lib

  • 👀 Nipoppy tutorial videos added to docs

  • Enhance pipeline search and installation

What’s Changed

Features

Bug Fixes

Documentation

Maintenance

Misc

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.4.1…0.4.2

0.4.1

Released on 2025-08-14 - GitHub - PyPI

What’s Changed

This release introduces some enhancements and minor bug fixes. Notable changes include:

  • A new --force flag to allow nipoppy init in a non-empty directory

  • A new nipoppy-gui command (need extra dependency, e.g. pip install nipoppy[gui]) for an in-Terminal “graphical” user interface

  • Usage of the "container-image" field in Boutiques descriptors (if specified) to launch containers. This means descriptors do not need to have Nipoppy-specific elements anymore (e.g. [[NIPOPPY_CONTAINER_COMMAND]] [[NIPOPPY_FPATH_CONTAINER]] in the "command-line" field). Usage of containers can be disabled by setting CONTAINER_CONFIG.COMMAND to null in the global config file.

    • This is a non-breaking change: existing descriptors do not have to be updated, but pipeline developers wishing to have descriptors usable outside of Nipoppy can make the following changes:

      • Remove [[NIPOPPY_CONTAINER_COMMAND]] [[NIPOPPY_FPATH_CONTAINER]] from the "command-line" field

      • Add executable name to the "command-line" field if not already present

      • Add "container-image" field

    • See here for an example

Features

Bug Fixes

Documentation

Maintenance

Misc

New Contributors

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.4.0…0.4.1

0.4.0

Released on 2025-05-22 - GitHub - PyPI

What’s Changed

🔴 BREAKING CHANGES 🔴

  • The doughnut.tsv file has been renamed to curation_status.tsv, and the bagel.tsv file has been renamed to processing_status.tsv

  • The global_config.json file schema and the internal organization of the <DATASET_ROOT>/pipelines directory has been changed

    • These changes were necessary for the move to the Zenodo catalog

    • The main change is that the pipeline configuration is no longer in the global_config.json file but rather in <DATASET_ROOT>/pipelines/<PIPELINE_NAME>-<PIPELINE_VERSION>/config.json

    • We provide a script to help migrate from 0.3.X to 0.4.0. Issues with the script can be reported on GitHub or Discord

Major new features

This release introduces two major new features:

  • nipoppy pipeline subcommands, which allow for installing/uploading pipeline configuration directories from a “pipeline catalog” on Zenodo

    • Related: nipoppy init will no longer include any default pipeline configurations in the new Nipoppy dataset

  • Support for launching jobs on high-performance computing systems using Slurm or SGE, using the --hpc option in nipoppy bidsify, nipoppy process, and nipoppy extract

Deprecation notices

Some of the existing subcommands have been renamed:

  • nipoppy doughnut –> nipoppy track-curation

  • nipoppy run –> nipoppy process

  • nipoppy track –> nipoppy track-processing The old command names still work for now (with a warning) but will cause an error in a future version.

Changelog

Features
Bug Fixes
Documentation
Maintenance
Misc

New Contributors

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.3.4…0.4.0

0.3.4

Released on 2025-03-27 - GitHub - PyPI

What’s Changed

This is release introduces some enhancements and minor bug fixes. CLI updates include removing the large log dump with the Boutiques invocation/descriptor file contents, which should make the logs easier to navigate. Pipeline config updates include fixes for dcm2bids and fs_stats.

The next release should be 0.4.0, which will introduce a restructuring of the global config file as well a decoupling of sample pipeline config files from the Nipoppy Python package code base. Sample pipeline config files will be stored on Zenodo and the Nipoppy CLI will be able to download/upload them.

Features

Bug Fixes

Documentation

Maintenance

New Contributors

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.3.3…0.3.4

0.3.3

Released on 2025-01-31 - GitHub - PyPI

What’s Changed

This release includes a refactor of the CLI to use click instead of argparse, which changes the look of the CLI.

The nipoppy run command also has a new --tar argument which enables tarring of a participant-session directory upon successful completion of a processing pipeline (path configured in tracker config files). Tracking will take into account the tarball contents too.

We have also added a --write-list flag to nipoppy bidsify, nipoppy run, and nipoppy extract, which will write to a CSV file the list of participant and session IDs to run (may be helpful for parallel processing and HPC job submission).

Features

Bug Fixes

Documentation

Maintenance

Misc

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.3.2…0.3.3

0.3.2

Released on 2024-12-12 - GitHub - PyPI

What’s Changed

This release introduces two new commands:

  • nipoppy status: get summary information about the dataset, including how many participants/sessions are in the manifest, have been BIDSified, or have been processed

  • nipoppy extract: run extraction pipelines that depend on certain processing pipelines (configured in the global config file)

Features

Documentation

Maintenance

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.3.1…0.3.2

0.3.1

Released on 2024-11-12 - GitHub - PyPI

What’s Changed

Features

Maintenance

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.3.0…0.3.1

0.3.0

Released on 2024-10-31 - GitHub - PyPI

What’s Changed

Breaking changes

Documentation

Misc

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.2.3…0.3.0

0.2.3

Released on 2024-10-10 - GitHub - PyPI

What’s Changed

Features

Bug Fixes

Maintenance

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.2.2…0.2.3

0.2.2

Released on 2024-09-27 - GitHub - PyPI

What’s Changed

Features

Bug Fixes

Documentation

Maintenance

Misc

New Contributors

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.2.1…0.2.2

0.2.1

Released on 2024-09-12 - GitHub - PyPI

What’s Changed

Breaking Changes

Features

Bug Fixes

Documentation

Maintenance

Misc

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.2.0…0.2.1

0.2.0

Released on 2024-08-15 - GitHub - PyPI

What’s Changed

New Contributors

Full Changelog: https://github.com/nipoppy/nipoppy/compare/0.1.0…0.2.0

0.1.0

Released on 2023-06-27 - GitHub - PyPI

What’s Changed

New Contributors

Full Changelog: https://github.com/neurodatascience/mr_proc/commits/0.1.0