Mushu is a free and open-source Brain Computer Interface (BCI) signal acquisition software written in Python.

Mushu is available on the Python Package Index (PyPI) and can be easily installed via:

$ pip install mushu

The required packages to run Mushu can be found in the file requirements.txt. To install all required packages at once one can use pip:

$ pip install -r requirements.txt

or simply install all packages line by line using the package manager of your operating system.

To install Mushu manually on your system, download the latest version of Mushu and run:

$ python ./setup.py install --user

• g.USBamp by g.tec (native)
• EPOC by emotiv (native)
• any lab streaming layer device publishing EEG data
• Virtual Amplifier: ReplayAmp, an amplifier that replays EEG data in realtime or timelapse

Online documentation is available here.

• Platform Independent
• Amplifier Independent
  • Single interface regardless of the underlying Amplifier type used
• Free Software
• Next step towards a whole BCI system based on Python (as opposed to C++ or Matlab)

• Directly as Python library
• As Network server

• Numpy arrays
• TOBI Interface A

If you use Mushu for anything that results in a publication, We humbly ask you to cite us:

@INPROCEEDINGS{venthur2012,
    author={Venthur, Bastian and Blankertz, Benjamin},
    booktitle={Engineering in Medicine and Biology Society (EMBC), 2012 Annual International Conference of the IEEE},
    title={Mushu, a free- and open source BCI signal acquisition, written in Python},
    year={2012},
    month={Aug},
    pages={1786-1788},
    organization={IEEE},
    doi={10.1109/EMBC.2012.6346296},
    ISSN={1557-170X},
}

For a complete BCI system written in Python use Mushu together with Wyrm and Pyff. Wyrm is a Brain Computer Interface (BCI) toolbox written in Python and is suitable for running on-line BCI experiments as well as off-line analysis of EEG data. Pyff a BCI feedback and -stimulus framework.

• Bastian Venthur