Skip to main content

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.


PySide2 is available under both Open Source (LGPLv3/GPLv2) and commercial license. Using PyPi is the recommended installation source, because the content of the wheels is valid for both cases. For more information, refer to the Qt Licensing page.

Download files

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

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distributions

PySide2- (137.4 MB view hashes)

Uploaded cp35 cp36 cp37 cp38 cp39 cp310

PySide2- (116.9 MB view hashes)

Uploaded cp35 cp36 cp37 cp38 cp39 cp310

PySide2- (164.3 MB view hashes)

Uploaded cp35 cp36 cp37 cp38 cp39 cp310

PySide2- (148.5 MB view hashes)

Uploaded cp35 cp36 cp37 cp38 cp39 cp310

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page