skillfed

bidsschematools

Python tools for working with the BIDS schema.

bidsschematools v1.2.7 172.4K downloads/30d#10,338 on PyPI366
Permissive license MIT Active released

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 bidsschematools

uv

uv add bidsschematools

poetry

poetry add bidsschematools

Installing 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

Development Status :: 4 - BetaIntended Audience :: Science/ResearchLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Scientific/Engineering :: Information Analysis

Tags

BIDS schema parsingneuroimaging data structure toolsbrain imaging schema validationBIDS CLI exportschema reference implementationneuroimaging metadata tools
neuroimagingbids-standardschema-tools

More Information Analysis packages