Installation via DockerLast updated: 2020-01-23

The following section provides information about the installation process by using a Docker image.

A Docker image is available on the Docker hub and could be retrieved through the command.

docker pull javert899/pm4py:latest

It could be then run trough the following command.

docker run -it javert899/pm4py:latest bash

Classical InstallationLast updated: 2020-01-23

The following section provides information about the classical installation process.

Install C/C++ compiler

Most distributions default install include already the gcc and g++ compilers, respectively compiling C and C++ code. In order to check the presence of gcc and g++ on your current distribution, along with their version, one of following commands can be used.

gcc -v
g++ -v

If they are not installed, refer to your distribution support for instructions on how to install them.

Install GraphViz

The presence of GraphViz is required on the system. To check the presence of GraphViz, please give the following command.

dot -h

If GraphViz is not installed, you will get an error from the output of that program. If GraphViz is not installed, you will get an error from the output of that program. To install GraphViz, a command depending on the distribution should be given. We provide some commands for the most widely used distributions.

For Debian/Ubuntu, the following command can be used:

sudo apt install graphviz

For Fedora:

yum install graphviz

Install Tkinter

Tkinter is required by Python but could not be installed with pip. It is required to install it through the distribution package manager.

For Debian/Ubuntu, you can use the following command:

sudo apt install python3-tk

For Fedora:

yum install tkinter

Install other libraries

Some other libraries are required to be manually installed on some platforms (like ARM).

sudo apt install libblas-dev
sudo apt install liblapack-dev
sudo apt install libsuitesparse-dev

Install Anaconda/Miniconda

An installation of Anaconda 5.2.0 or Miniconda 4.5.x (containing Python 3.6.x) is suggested. We cannot state that previous versions of Python will work out. In this instruction, we are focussing on Miniconda 4.5.4.

Miniconda 4.5.4 (if not already installed; it is not necessary if Anaconda is installed) could be retrieved by clicking here.

The 64 bit installer (32 bit architecture has limited memory allocation for threads/processes) could be executed from the command line using the following instruction;

root@debian:~# bash


It is not required to be root; any user could suffice.

As the first step in the installation of Miniconda, it is required to read the license agreements. Press Enter key in order to read them, move with up and down arrow keys in order to read the points, and then click q in order to quit the license agreements and accept/deny (yes/no) that.

Then, a path for the installation of Miniconda is required. The proposed path, that is inside the user directory, is proposed and could be accepted as-is. Then, Miniconda asks if the user wants to add executables to the user path, it is convenient to say yes here.

Install the pm4py package

In order to install PM4Py and its dependencies, the following command could be provided:

pip install pm4py