Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Python bindings for the Qt cross-platform application and UI framework

Project description



PySide2 is the official Python module from the Qt for Python project, which provides access to the complete Qt 5.12+ framework.

The Qt for Python project is developed in the open, with all facilities you'd expect from any modern OSS project such as all code in a git repository and an open design process. We welcome any contribution conforming to the Qt Contribution Agreement.


Since the release of the Technical Preview it is possible to install via pip, both from Qt's servers and PyPi:

pip install PySide2


PySide2 versions following 5.12 use a C++ parser based on Clang. The Clang library (C-bindings), version 6.0 or higher is required for building. Prebuilt versions of it can be downloaded from

After unpacking the archive, set the environment variable LLVM_INSTALL_DIR to point to the folder containing the include and lib directories of Clang:

7z x .../libclang-release_60-linux-Rhel7.2-gcc5.3-x86_64-clazy.7z
export LLVM_INSTALL_DIR=$PWD/libclang

On Windows:

7z x .../libclang-release_60-windows-vs2015_64-clazy.7z

Building from source

For building PySide2 from scratch, please read about getting started. This process will include getting the code:

git clone
cd pyside-setup
git branch --track 5.12 origin/5.12
git checkout 5.12

then install the dependencies, and following the instructions per platform. A common build command will look like:

python install --qmake=<path/to/qmake/> --parallel=8 --build-tests

You can obtain more information about the options to build PySide and Shiboken in our wiki.

Documentation and Bugs

You can find more information about the PySide2 module API in the official Qt for Python documentation.

If you come across any issue, please file a bug report at our JIRA tracker following our guidelines.


Check #qt-pyside, our official IRC channel on FreeNode, or contact us via our mailing list.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
PySide2-5.12.3-5.12.3-cp27-cp27m-macosx_10_12_intel.whl (109.0 MB) Copy SHA256 hash SHA256 Wheel cp27
PySide2-5.12.3-5.12.3-cp27-cp27mu-manylinux1_x86_64.whl (143.4 MB) Copy SHA256 hash SHA256 Wheel cp27
PySide2-5.12.3-5.12.3-cp35.cp36.cp37-abi3-macosx_10_12_intel.whl (109.3 MB) Copy SHA256 hash SHA256 Wheel cp35.cp36.cp37
PySide2-5.12.3-5.12.3-cp35.cp36.cp37-abi3-manylinux1_x86_64.whl (143.9 MB) Copy SHA256 hash SHA256 Wheel cp35.cp36.cp37
PySide2-5.12.3-5.12.3-cp35.cp36.cp37-none-win32.whl (93.4 MB) Copy SHA256 hash SHA256 Wheel cp35.cp36.cp37
PySide2-5.12.3-5.12.3-cp35.cp36.cp37-none-win_amd64.whl (111.6 MB) Copy SHA256 hash SHA256 Wheel cp35.cp36.cp37

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page