OS/X 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 developer.apple.com (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, MatplotLib and PyQT (either PyQt4, PyQt5, or PySide).

The easiest way to obtain these is to install the Python distribution Anaconda with the default options.

Some packages may also be installed via homebrew, for example:

$ brew install pyqt5

Installing Myokit

To install Myokit, run

$ pip install myokit

Then, try a simulation using

$ python -m myokit run example

To run Myokit's IDE, type:

$ python -m myokit ide

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 (michael@myokit.org) or check out the Myokit mailing list.