Installation#

MNE-BIDS is included in the official MNE-Python installers.

If you want to install MNE-BIDS manually instead, please continue reading.

Dependencies#

Required:

  • mne (>=1.6)

  • numpy (>=1.21.2)

  • scipy (>=1.7.0)

Optional:

  • nibabel (>=3.2.1, for processing MRI data)

  • pybv (>=0.7.5, for writing BrainVision data)

  • eeglabio (>=0.0.2, for writing EEGLAB data)

  • pymatreader (>=0.0.30, for other operations with EEGLAB data)

  • matplotlib (>=3.5.0, for using the interactive data inspector)

  • pandas (>=1.3.2, for generating event statistics)

  • EDFlib-Python (>=1.0.6, for writing EDF data with mne versions <1.7)

  • edfio (>=0.2.1, for writing EDF data)

  • defusedxml (for writing reading EGI MFF data and BrainVision montages)

We recommend installing mne-bids into an isolated Python environment, for example created via conda (may be obtained through miniconda). We require that you use Python 3.10 or higher. You may choose to install mne-bids into your isolated Python environment via pip or via conda.

Installation via pip#

To install MNE-BIDS including all dependencies required to use all features, simply run:

pip install --upgrade mne-bids[full]

This pip command will also work if you want to upgrade if a newer version of MNE-BIDS is available.

If you don’t require advanced features like interactive visual data inspection, you may also install a basic version of MNE-BIDS via

pip install --upgrade mne-bids

If you want to install a snapshot of the current development version, run:

pip install --upgrade https://github.com/mne-tools/mne-bids/archive/refs/heads/main.zip

To check if everything worked fine, the following command should print a version number and not give any error messages:

python -c 'import mne_bids; print(mne_bids.__version__)'

MNE-BIDS works best with the latest stable release of MNE-Python (the mne package). To ensure MNE-Python is up-to-date, follow the MNE-Python installation instructions.

Installation via conda#

If you have followed the MNE-Python installation instructions, all that’s left to do is to install MNE-BIDS without its dependencies, as they’ve already been installed during the MNE-Python installation process.

Activate the correct conda environment and install mne-bids:

conda activate mne
conda install --channel conda-forge --no-deps mne-bids

This approach ensures that the installation of MNE-BIDS doesn’t alter any other packages in your existing conda environment.

Alternatively, you may wish to take advantage of the fact that the mne-bids package on conda-forge in fact depends on mne, meaning that a “full” installation of mne-bids (i.e., including its dependencies) will provide you with a working copy of of both mne and mne-bids at once:

conda create --name mne --channel conda-forge mne-bids

After activating the environment, you should be ready to use MNE-BIDS:

conda activate mne
python -c 'import mne_bids; print(mne_bids.__version__)'