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
.
Linux
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:
Windows
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 BUILD.md 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)"
9.4.0
Next steps: Check out the Quick tour.