Registry / data / mne-bids

mne-bids

JSON →
library0.19.0pypypi✓ verified 84d ago

MNE-BIDS is a Python package for converting, organizing, and processing MEG, EEG, and iEEG data according to the Brain Imaging Data Structure (BIDS) specification. It integrates with MNE-Python for analysis. Current version: 0.18.0. Released approximately every 3-6 months.

data
pip install mne-bids
github ↗package ↗homepage ↗docs ↗
INSTALL
IMPORT
SIG · MNE-BIDS
M
mne-bids
datapythonv0.19.0
Install
13.7s avg
Import
7895ms
Disk
353MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v0.17.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 8.102s · 348.6MB
glibc
py 3.10–3.95 runs
installs and imports cleanly · install 13.7s · import 7.688s · 336MB
353MB installed
● package 353MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

read_raw_bids
✓ from mne_bids import read_raw_bids
✗ from mne.bids import read_raw_bids
mne-bids is a separate package, not part of mne
BIDSPath
✓ from mne_bids import BIDSPath

Minimal example: define a BIDS path and read raw data.

from mne_bids import BIDSPath, read_raw_bids bids_path = BIDSPath(subject='01', session='01', task='audiovisual', root='/path/to/bids') raw = read_raw_bids(bids_path=bids_path) print(raw) # prints info about the raw data
mne_bids --version
Debug
Known issues
breakingVersion 0.15.0 dropped support for Python 3.8. Upgrade Python to 3.9+.
fix
Use Python >=3.9
affects: >=0.15.0
breakingVersion 0.12.0 changed the default behavior of write_raw_bids to overwrite files. Previously it raised an error if a file existed.
fix
Set overwrite=False explicitly if you want the old behavior
affects: >=0.12.0
deprecatedUsing MNE-BIDS with MNE <1.0 is deprecated. MNE-BIDS 0.12+ requires MNE >=1.0.
fix
Upgrade MNE to >=1.0
affects: >=0.12.0, <1.0.0
gotchaBIDSPath does not automatically infer the root directory. If root is not set, write_raw_bids may default to current working directory.
fix
Always specify the root parameter explicitly.
affects: all
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'mne_bids'
Package not installed.
fix
Run pip install mne-bids
ValueError: The provided BIDS root directory does not exist
Root path specified does not exist or is incorrect.
fix
Ensure the root path is a valid directory. Use absolute paths.
TypeError: read_raw_bids() got an unexpected keyword argument 'bids_path'
Using too old version (prior to v0.11) where read_raw_bids accepted positional args.
fix
Update mne-bids to >=0.11.0 and use the keyword argument 'bids_path'.
Upgrade
Version history
0.19.0latest on PyPI · released May 26, 2026
Audit
Dependencies
mnerequiredCore dependency for data handling and analysis
numpyrequiredNumerical operations
scipyrequiredScientific computing
pybvrequiredWriting BrainVision data
formatspecrequiredBIDS specification validation
Agent activity
2 hits · last 30 days
node
2
Resources
githubhttps://github.com/mne-tools/mne-bids ↗
packagehttps://pypi.org/project/mne-bids/ ↗
homepagehttps://mne.tools/mne-bids ↗
docshttps://mne.tools/mne-bids ↗
mne-bids — pip install mne-bids · libregistry