Switch branches/tags
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
102 lines (57 sloc) 2.82 KB


Let's get Eskapade up and running! In order to make this as easy as possible, we provide both a Docker image and a virtual machine where everything you need is installed and working properly. Alternatively, you can download the repository and run it on your own machine.

This manual is written for Linux systems, but Eskapade also runs fine on macOS systems.

Eskapade on your own machine

Eskapade can be installed as any other Python package with easy_install or pip. To get started, simply do:

$ pip install Eskapade

We have verified that this works on Linux 16.04 and MacOS based machines.

Or check out the code from out github repository:

$ git clone
$ pip install -e Eskapade/

where the code is installed in editable mode (option -e).

You can now use Eskapade in Python with:

import eskapade

Congratulations, you are now ready to use Eskapade!

See the other parts of the documentation for specific usage.

Eskapade with Docker

Eskapade on a virtual machine


Eskapade requires Python 3 and some libraries, which can be found in at the root of the repository.

Eskapade can be installed as any other Python package with easy_install or pip:

$ pip install /path/to/eskapade

Alternatively, consider installing KaveToolbox version 3.6 or higher. To install the released version:

$ yum -y install wget curl tar zip unzip gzip python
$ wget
$ sudo bash [--quiet]

(--quiet is for a quieter install, remove the brackets!)

If anaconda is already installed in your machine, consider creating a conda virtual environment with Python 3.6 to install all the requirements and Eskapade itself to avoid collisions:

$ conda create -n eskapade_env36 python=3.6 anaconda

Then you can activate it as follows:

$ source activate eskapade_env36

More information about conda virtual environments can be found here

Installing Eskapade on macOS

To install eskapade on macOS, see our macOS appendix.