Installing OR-Tools Python from Source on Linux

Introduction

This guide explains how to install OR-Tools from source, with support for Python, on Linux. Unless you plan to modify the source code or use a third-party solver with OR-Tools, we recommend the binary installation.

Although these instructions might also work on other Linux variants, we have only tested them on machines meeting the following requirements:

Ubuntu 19.04/18.04/16.04 64-bit (x86_64)
Debian 9.4 (stretch) 64-bit (x86_64)
Centos 7 64-bit (x86_64)

Prerequisites

The following sections describe the prerequisites for installing OR-Tools from source.

C++ tools

To install C++ tools, open a terminal window and enter:

Centos 7

yum groupinstall 'Development Tools'
yum -y install pkgconfig

Debian 9

sudo apt-get -y install git wget pkg-config build-essential cmake autoconf libtool zlib1g-dev lsb-release

Ubuntu 19.04

sudo apt-get -y install git wget pkg-config build-essential cmake autoconf libtool zlib1g-dev lsb-release

Ubuntu 18.04

sudo apt-get -y install git wget pkg-config build-essential cmake autoconf libtool zlib1g-dev lsb-release

Ubuntu 16.04

sudo apt-get -y install git wget pkg-config build-essential cmake autoconf libtool zlib1g-dev lsb-release

SWIG

To install SWIG, open a terminal window and enter:

Centos 7

wget "https://downloads.sourceforge.net/project/swig/swig/swig-3.0.12/swig-3.0.12.tar.gz"
tar xvf swig-3.0.12.tar.gz && rm swig-3.0.12.tar.gz
cd swig-3.0.12 && ./configure --prefix=/usr && make -j 4
make install
cd .. && rm -rf swig-3.0.12

Debian 9

sudo apt-get -y install swig

Ubuntu 19.04

sudo apt-get -y install swig

Ubuntu 18.04

sudo apt-get -y install swig

Ubuntu 16.04

sudo apt-get -y install swig

Python

You must have either Python 2.7 or Python 3.5+ installed. We recommend Python 3.

Python 3

To install Python 3.5+, open a terminal window and enter:

Centos 7

yum -y install centos-release-scl
yum -y install rh-python36 rh-python36-python-wheel rh-python36-python-six
scl enable rh-python36 bash

Debian 9

sudo apt-get -y install python3-dev python3-wheel python3-setuptools python3-six

Ubuntu 19.04

sudo apt-get -y install python3-dev python3-wheel python3-setuptools python3-six

Ubuntu 18.04

sudo apt-get -y install python3-dev python3-wheel python3-setuptools python3-six

Ubuntu 16.04

sudo apt-get -y install python3-dev python3-wheel python3-setuptools python3-six

You can check your Python 3 installation using:

python3 --version
python3 -c "import platform; print(platform.architecture()[0])"
python3 -m pip --version

Python 2

To install Python 2.7, open a terminal window and enter:

Centos 7

yum -y install centos-release-scl
yum -y install python27 python27-python-six
scl enable python27 bash

Debian 9

sudo apt-get -y install python-dev python-wheel python-setuptools python-six

Ubuntu 19.04

sudo apt-get -y install python-dev python-wheel python-setuptools python-six

Ubuntu 18.04

sudo apt-get -y install python-dev python-wheel python-setuptools python-six

Ubuntu 16.04

sudo apt-get -y install python-dev python-wheel python-setuptools python-six

You can check your Python 2 installation using:

python2 --version
python2 -c "import platform; print(platform.architecture()[0])"
python2 -m pip --version

If necessary, for the following commands, replace python by:

python3 which points to Python 3.x (if installed)
python2 which points to Python 2.7.x (if installed)

Note:python may point to Python 2.7.x or Python 3.x.

Download the source code

There are two distinct branches of the OR-Tools source code on GitHub: stable and master. The stable branch has been thoroughly tested and should work flawlessly on all supported platforms. The master branch is where the latest updates and improvements have been applied; it's more current, but less stable.

Download the stable source code

To get the stable source code for OR-Tools, clone the stable branch from GitHub or download the latest release in a compressed file. You can do so by clicking the Clone or download button in GitHub.

Download the master source code

To retrieve the source code from the master branch, enter

git clone -b master https://github.com/google/or-tools

Download previous releases

You can get the source code for previous releases in either of the following ways:

Download a previous release from the GitHub release page.
Assuming you have already created a local repository (by git clone), you can check out a specific release using a Git tag. For example, to work with the v7.3 release instead of the master branch, enter the following commands in your local repo:
```
git fetch --all --tags --prune>
```
```
git checkout tags/v7.2 -b v7.2>
```

Build the source code

To build the source code:

Open a terminal and navigate to the directory where you extracted the files. Then enter the following command:
```
make third_party
```
To use a third party solver, open Makefile.local in the main or-tools directory, and add the path to the directory where you installed the solver. For example, for SCIP you would add this:
```
UNIX_SCIP_DIR=scip/install/dir
```
Compile OR-Tools by entering
```
make python
```
You can check that everything is running correctly by entering
```
make test_python
```

This runs a selection of examples for OR-Tools. If all the examples run successfully, you are ready to get started with OR-Tools.

Using a third-party solver

You can use OR-Tools with any of the following third-party solvers:

If you have already installed OR-Tools and want to configure it to use one of these solvers, do the following steps:

Open a terminal and navigate to the or-tools directory. Then enter the following command:
```
make third_party
```
Open Makefile.local and add the path to the directory where you installed the solver. For example, for SCIP you would add this:
```
UNIX_SCIP_DIR=scip/install/dir
```
Compile OR-Tools by entering
```
make clean
```
```
make all
```

Install the SCIP Optimization Suite

To install the SCIP Optimization Suite on Linux, do the following steps:

Download the SCIP archive and unpack it.

Navigate to the top level of the unpacked archive and enter the following commands:

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=scip/install/dir -DGMP=false -DZIMPL=false -DTPI=tny -DPARASCIP=true ..
make
make install

After the installation is complete, follow the instructions in Using a third-party solver.

Cleaning the build files

If you need to re-install OR-Tools, the command:

make clean_third_party

will remove all compiled dependencies and Makefile.local. This can be useful for resetting to a clean state.

Then re-enter the commands

make third_party

make python

Installing OR-Tools on your operating system

You can install OR-Tools for Python on your operating system by entering

make install_python