Getting started

The first section show the easy way, with pre-compiled packages. If that doesn’t work, or you need to compile from source, see the second section.

Installing pre-compiled packages (easy)

PyPI (Linux, Windows)

You can install the latest version from PyPI.

PyTango has binary wheels for common platforms, so no compilation or dependencies required. However, pip needs to be at least version 19.3 in order for it to find the binary wheels:

$ python -m pip install --upgrade pip

Install PyTango with pip:

$ python -m pip install pytango

If this step downloads a .tar.gz file instead of a .whl file, then we don’t have a binary package for your platform. Try Conda.

If you are going to utilize the gevent green mode of PyTango it is recommended to have a recent version of gevent. You can force gevent installation with the “gevent” keyword:

$ python -m pip install pytango[gevent]

Conda (Linux, Windows, MacOS)

You can install the latest version from Conda-forge.

Conda-forge provides binary wheels for different platforms, compared to PyPI. MacOS binaries are available since version 9.4.0.

If you don’t already have conda, try the Miniforge3 installer (an alternative installer to Miniconda).

To install PyTango in a new conda environment (you can choose a different version of Python):

$ conda create --channel conda-forge --name pytango-env python=3.11 pytango
$ conda activate pytango-env

Other useful packages on conda-forge include: tango-test, jive and tango-database.


PyTango is available on linux as an official debian/ubuntu package (however, this may not be the latest release):

For Python 3:

$ sudo apt-get install python3-tango

RPM packages are also available for RHEL & CentOS:


First, make sure Python is installed. Then follow the same instructions as for PyPI above. There are binary wheels for some Windows platforms available.

Building and installing from source (hard)

This is the more complicated option, as you need to have all the correct dependencies and build tools installed. It is possible to build in Conda environments on Linux, macOS and Windows. It is also possible to build natively on those operating system. Conda is the recommended option for simplicity. For details see the file in the root of the source repository.

Basic installation check

To test the installation, import tango and check tango.Release.version:

$ cd  # move to a folder that doesn't contain the source code, if you built it
$ python -c "import tango; print(tango.Release.version)"

Next steps: Check out the Quick tour.