Skip to main content

Access a multitude of neuroimaging data formats

Project description

NiBabel logo


PyPI - Python Version code style: blue imports: isort pre-commit


stable tests codecov badge


PyPI version PyPI - Downloads


Conda package Debian Unstable package Arch (AUR) Gentoo (::science) nixpkgs unstable

License & DOI

License Zenodo DOI

Read and write access to common neuroimaging file formats, including: ANALYZE (plain, SPM99, SPM2 and later), GIFTI, NIfTI1, NIfTI2, CIFTI-2, MINC1, MINC2, AFNI BRIK/HEAD, ECAT and Philips PAR/REC. In addition, NiBabel also supports FreeSurfer’s MGH, geometry, annotation and morphometry files, and provides some limited support for DICOM.

NiBabel’s API gives full or selective access to header information (metadata), and image data is made available via NumPy arrays. For more information, see NiBabel’s documentation site and API reference.


To install NiBabel’s current release with pip, run:

pip install nibabel

To install the latest development version, run:

pip install git+

When working on NiBabel itself, it may be useful to install in “editable” mode:

git clone
pip install -e ./nibabel

For more information on previous releases, see the release archive or development changelog.


During development, we recommend using tox to run nibabel tests:

git clone
cd nibabel

To test an installed version of nibabel, install the test dependencies and run pytest:

pip install nibabel[test]
pytest --pyargs nibabel

For more information, consult the developer guidelines.

Mailing List

Please send any questions or suggestions to the neuroimaging mailing list.


NiBabel is licensed under the terms of the MIT license. Some code included with NiBabel is licensed under the BSD license. For more information, please see the COPYING file.


NiBabel releases have a Zenodo Digital Object Identifier (DOI) badge at the top of the release notes. Click on the badge for more information.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nibabel-5.2.1.tar.gz (4.5 MB view hashes)

Uploaded Source

Built Distribution

nibabel-5.2.1-py3-none-any.whl (3.3 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page