## Introduction

This guide explains how to install OR-Tools for Python on Linux.

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


- Alpine Edge 64-bit (x86_64)
- Centos 7 LTS 64-bit (x86_64)
- Debian SID 64-bit (x86_64)
- Debian 11 (bullseye) 64-bit (x86_64)
- Fedora 38 64-bit (x86_64)
- Fedora 37 64-bit (x86_64)
- OpenSuse Leap 64-bit (x86_64)
- Ubuntu 24.10 64-bit (x86_64)
- Ubuntu 22.04 LTS 64-bit (x86_64)
- Ubuntu 20.04 LTS 64-bit (x86_64)

<br />

> [!NOTE]
> **Note:** OR-Tools only provides archives for the **x86_64** (also known as **amd64**) architecture.

## Prerequisites

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

### Python

You must have Python 3.8+ installed.

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

### Alpine

    apk add python3-dev py3-pip py3-wheel

### Centos

    sudo yum install -y python3 python3-devel python3-pip numpy

### Debian

    sudo apt install -y python3-dev python3-pip python3-venv

### Fedora

    sudo dnf install -y python3-devel python3-pip python3-venv

### Fedora

    sudo dnf install -y python3-devel python3-pip python3-venv

### OpenSUSE

    sudo zypper install -y python3-devel python3-pip python3-wheel

### Ubuntu

    sudo apt install -y python3-dev python3-pip python3-venv

### Ubuntu

    sudo apt install -y python3-dev python3-pip python3-venv

### Ubuntu

    sudo apt install -y python3-dev python3-pip python3-venv

<br />

You can check your Python 3 installation using:

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

## Installing OR-Tools

Assuming the prerequisite software is installed on your Linux, take the
following steps:

    python3 -m pip install ortools

> [!TIP]
> **Tip:** You should install `ortools` in a [virtual environment](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#)

### Uninstalling OR-Tools

To uninstall OR-Tools, issue the following commands:

    python3 -m pip uninstall ortools

## Validate your installation

To test your Python installations, open a terminal window. Then enter the
following command:


    python3 -c "import ortools; print(ortools.__version__)"

<br />

If it runs successfully, you are ready to
[get started with OR-Tools](https://developers.google.com/optimization/introduction/python).