1. Install Anaconda

    Our recommended approach is to use Anaconda, which is a distribution of Python containing most of the numeric and scientific software needed to get started. If you are a Mac or Linux user, have used Python before and are comfortable using pip to install software, you may want to skip this step and use your existing Python installation.

    Anaconda has a simple graphical installer which can be downloaded from - select your operating system and download the Python 3.7 version. The default installer options are usually appropriate.

  2. Open a terminal

    We will install most packages with conda:

    $ conda create -n magine_env python=3.7
    $ source activate magine_env
    $ conda config --add channels conda-forge
    $ conda install jinja2 statsmodels networkx graphviz
    $ conda install -c marufr python-igraph
    Windows users: Please download and install igraph and pycairo using

    the wheel files provided by Christoph Gohlke, found at . Assuming 64 bit windows, download python_igraph‑0.7.1.post6‑cp37‑cp37m‑win_amd64.whl from and pycairo‑1.18.0‑cp37‑cp37m‑win_amd64.whl from

    $ pip install pycairo‑1.18.0‑cp37‑cp37m‑win_amd64.whl
    $ pip install python_igraph‑0.7.1.post6‑cp37‑cp37m‑win_amd64.whl
  3. Install MAGINE

    The installation is very straightforward with pip - type the following in a terminal:

    $ git clone
    $ cd magine
    $ pip install -r requirements.txt
    $ export PYTHONPATH=`pwd`:$PYTHONPATH
  4. Start Python and MAGINE

    If you installed Python using Anaconda on Windows, search for and select jupyter notebook from your Start Menu (Windows). Otherwise, open a terminal and type jupyter notebook.

    You will then be at the Python prompt. Type import magine to try loading magine. If no error messages appear and the next Python prompt appears, you have succeeded in installing magine!


The manual is available online at