Quick start

MNE-Python requires Python version 3.7 or higher. For users already familiar with Python:

  • If you only need 2D plotting capabilities with MNE-Python (i.e., most EEG/ERP or other sensor-level analyses), you can install MNE-Python using pip:

    $ pip install mne  # dependencies are numpy, scipy, matplotlib
    
  • If you need MNE-Python’s 3D plotting capabilities (e.g., plotting estimated source activity on a cortical surface) it is a good idea to install MNE-Python into its own virtual environment. To do this with conda (this will create a conda environment called mne):

    $ curl --remote-name https://raw.githubusercontent.com/mne-tools/mne-python/master/environment.yml
    $ conda env update --file environment.yml
    

    If you need to convert structural MRI scans into models of the scalp, inner/outer skull, and cortical surfaces you also need FreeSurfer.

The Installing MNE-Python page has more detailed instructions for different operating systems (including instructions for installing Python if you don’t already have it). The Advanced setup page has additional tips and tricks for special situations (servers, notebooks, CUDA, installing the development version, etc). The Contributing guide has additional installation instructions for (future) contributors to MNE-Python (extra dependencies, etc).