bidsschematools
Python tools for working with the BIDS schema.
What it is and what it does
bidsschematools is a Python library for working with the Brain Imaging Data Structure (BIDS) schema, a standardized format for organizing neuroimaging datasets. It provides lightweight schema parsing, validation, and export functionality, serving as the reference implementation used for testing the BIDS schema itself. The library is designed for neuroimaging researchers and developers who need to programmatically interact with BIDS metadata structures.
The package includes both a Python API for direct schema manipulation and simple command-line bindings (such as `bst export`) for common tasks. It depends on three runtime libraries: acres, click for CLI support, and pyyaml for schema file handling. The project is actively maintained by the BIDS community and supports modern Python versions.
Use it for:
- Validate neuroimaging datasets against the BIDS schema specification during data collection or preprocessing pipelines.
- Export BIDS schema definitions in different formats for documentation or integration with other neuroimaging tools.
- Programmatically parse and inspect BIDS schema structure in research workflows or data management systems.
- Test BIDS schema compliance in custom neuroimaging data processing scripts.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Parse, validate, and export the Brain Imaging Data Structure (BIDS) schema using a lightweight Python library with command-line tools.
Yes, if you work with BIDS datasets or neuroimaging data structures. The package has low install friction, active maintenance, permissive licensing, and no known vulnerabilities. It is marked Beta but serves as the reference implementation for BIDS schema testing, suggesting stability for its intended use. Install it if you need to validate, parse, or export BIDS schema metadata.
Install
bidsschematools on PyPI
pip
pip install bidsschematoolsuv
uv add bidsschematoolspoetry
poetry add bidsschematoolsInstalling bidsschematools
Before you install
Low install friction with three lightweight runtime dependencies (acres, click, pyyaml). Active maintenance with a recent release 25 days ago and ongoing commits; the repository is not archived and has 366 stars.
License in practice
MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.
Quickstart
pip install bidsschematools
import bidsschematools
# Use the library to parse and work with BIDS schema objects
Requires Python 3.10 or later.
Verify before relying
- Whether the package is suitable for production use despite Beta status, or primarily for schema testing and development.
- What specific schema validation capabilities are available beyond reference parsing.
Package facts
| License | MIT (permissive) |
| Python support | supports the current Python release (>=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 3 — acres, click, pyyaml |
| Maintenance | actively maintained — 25 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 172,396/month — #10,338 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: bidsschematools-1.2.7-py3-none-any.whl
Tags
More Information Analysis packages
A drop-in replacement for Python's standard…
permissive · top 100 on PyPI
pyarrowpyarrow provides Python bindings to Apache…
permissive · top 100 on PyPI
networkxNetworkX provides data structures and…
permissive · top 1,000 on PyPI
snowflake-connector-pythonConnects Python applications to Snowflake data…
permissive · top 1,000 on PyPI
contourpyContourPy calculates contours of 2D…
permissive · top 1,000 on PyPI
snowflake-snowpark-pythonSnowpark Python provides APIs to query and…
permissive · top 1,000 on PyPI
pybidsPyBIDS provides a Python interface to query,…
permissive · top 15,000 on PyPI
bids-validatorValidates that brain imaging datasets conform…
permissive · top 15,000 on PyPI
mne-bidsMNE-BIDS reads and writes neuroimaging datasets…
permissive · top 15,000 on PyPI
pyxnatpyxnat provides Python bindings to interact…
permissive · top 15,000 on PyPI
nibabelNiBabel reads and writes neuroimaging file…
permissive · top 5,000 on PyPI
nilearnNilearn provides statistical and…
permissive · top 15,000 on PyPI
dipyDIPY is a Python library for analyzing…
permissive · top 15,000 on PyPI
nipypeNipype provides a uniform Python interface to…
permissive · top 15,000 on PyPI
dicom2niftiConverts DICOM medical imaging files to NIfTI…
permissive · top 15,000 on PyPI
trx-pythonReads, writes, and manipulates TRX tractography…
permissive · top 15,000 on PyPI