MacOS installation guide

Myokit needs GCC, Python, and the Sundials ODE solvers to run. Each step of the installation is discussed separately below.

Installing the dependencies

The following components are required to run Myokit:

The GCC compiler

First, if you haven't already, install Xcode and the Xcode Command Line Tools to obtain GCC. These can be obtained at (you may need to create an account).


Next, you need to install Sundials, either manually, or (much easier) via homebrew.

To use homebrew, first install it, then install Sundials by opening the terminal and typing

$ brew install sundials


$ brew install homebrew-science/sundials


Myokit requires Python (2.7, or 3.4+) to run, including the popular modules NumPy, SciPy, SymPy, lxml, Matplotlib and PyQT (either PyQt4, PyQt5, or PySide).

Most of these packages will automatically be installed when you install Myokit (see below), but the PyQt package may require some work.

One easy way to install it, is to use the Anaconda Python distribution, and install it with the default options.

Alternatively, Python 3 users can install PyQt5 using pip, see below.

If you're using Python 2.7, which is the standard version pre-installed on many Macs, you can install PyQt5 via homebrew:

$ brew install pyqt5

Installing Myokit

To install Myokit, run

$ pip install myokit

Or use the longer form of the same command:

$ python -m pip install myokit

To also install a GUI component, use either

$ pip install myokit[pyqt]


$ pip install myokit[pyside]

Note: If you get a "zsh: no matches found" error at this point, you may need to escape the brackets, e.g.

$ pip install myokit\[pyqt\]

Once installed, try running a simulation using

$ python -m myokit run example

To run Myokit's IDE, type:

$ python -m myokit ide

To upgrade an existing Myokit installation, use

$ pip install --upgrade myokit

Adding OpenCL support

If you want to use the OpenCL based libraries, look here for instructions.


To uninstall Myokit, use

pip uninstall myokit

Python, Sundials, etc. will need to be uninstalled separately.


Please note: GCC, Xcode, Sundials, Python etc. are not part of Myokit, and come with their own user licenses.

Further questions

If you have any questions, please email Michael Clerx ( or check out the issues page.