PyBIDS
PyBIDS is a Python library to centralize interactions with datasets conforming BIDS (Brain Imaging Data Structure) format. For more information about BIDS visit https://bids.neuroimaging.io.
PyBIDS currently supports Python 3 on POSIX operating systems (including Mac OS). Windows is not officially supported, though most PyBIDS functionality will probably work fine.
Installation
PyBIDS is most easily installed from pip. To install the latest official release:
pip install pybids
Or, alternatively via conda:
conda install -c conda-forge pybids
If you want to live on the bleeding edge, you can install from main:
pip install git+https://github.com/bids-standard/pybids.git
Dependencies
PyBIDS has a number of dependencies. The core querying functionality requires only the BIDS-Validator package. However, most other modules require the core Python neuroimaging stack: numpy, scipy, pandas, and nibabel. The reports module additionally requires num2words. By default, all dependencies will be installed with pybids (if they aren't already available).
Usage
Get started by checking out the documentation!
Or you can start at our tutorial! You can run it interactively without installing anything via binder. Click on the link and then navigate to doc/examples/pybids_tutorial.md to explore.
Development and testing
PyBIDS uses tox to manage testing environments and ensure that the same commands can easily be run locally and in CI.
Install tox with:
pip install tox
To run tests with standard, minimal, or pre-release dependencies, use:
tox run -e [full|min|pre]
To run with a specific version, also specify py3X:
tox run -e py311-full
See tox documentation for more detail.
How to cite
To credit PyBIDS in your work, please cite both the JOSS paper and the Zenodo archive. The former provides a high level description of the package, and the latter points to a permanent record of all PyBIDS versions (we encourage you to cite the specific version you used). Example citations (for PyBIDS 0.9.3):
Yarkoni et al., (2019). PyBIDS: Python tools for BIDS datasets. Journal of Open Source Software, 4(40), 1294, https://doi.org/10.21105/joss.01294
Yarkoni, Tal, Markiewicz, Christopher J., de la Vega, Alejandro, Gorgolewski, Krzysztof J., Halchenko, Yaroslav O., Salo, Taylor, … Blair, Ross. (2019, August 8). bids-standard/pybids: 0.9.3 (Version 0.9.3). Zenodo. https://doi.org/10.5281/zenodo.3363985
Community guidelines
Bug reports, feedback, and other contributions to PyBIDS are welcome. To report a bug, request a feature, or raise a technical (non-usage-related) question for discussion, please open an issue on GitHub. Requests for support and questions about usage (where no bug is suspected) should be posted on the NeuroStars forum. For questions about the BIDS specification or BIDS-Validator, please see the corresponding repositories. For general BIDS-related discussion, see the bids-discussion mailing list.
Pull requests are always welcome. If you have any doubts about the suitability of a PR, or want to discuss implementation-related issues, feel free to open an issue for discussion.
Metadata
Release files for pybids 0.22.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pybids-0.22.0.tar.gz | 13.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pybids-0.22.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.3 MB
Release files / pybids-0.22.0.tar.gz
| Download URL | pybids-0.22.0.tar.gz |
|---|---|
| Size | 13.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
98e7957e47c08d3c131de6f6cef629d009abce888849102b33820ca6a9930152
|
|
BLAKE2b-256 checksum How to use checksums |
ba6148e48fef36afbab3635bc4f7341641c4ed4f83bcdc3dfb484cc90a63b750
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 12, 2026.
Transparency logRelease files / pybids-0.22.0-py3-none-any.whl
| Download URL | pybids-0.22.0-py3-none-any.whl |
|---|---|
| Size | 229.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
342e560a546881be0ab42da338e38f4995d3a9063f13ec19bd14aee17a74852f
|
|
BLAKE2b-256 checksum How to use checksums |
768f5901cde1985f92a993c39a15475b259f46590ecc33c4cdf8103b188b440b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 12, 2026.
Transparency log
