November 18, 2020

265 words 2 mins read



Provides an uniform layer to support PyQt5, PySide2, PyQt4 and PySide with a single codebase

repo name spyder-ide/qtpy
repo link
language Python
size (curr.) 335 kB
stars (curr.) 457
created 2015-05-02
license MIT License

QtPy: Abstraction layer for PyQt5/PyQt4/PySide2/PySide

license pypi version conda version download count OpenCollective Backers Join the chat at PyPI status Build status CircleCI Coverage Status

Copyright © 2009–2019 The Spyder Development Team


QtPy is a small abstraction layer that lets you write applications using a single API call to either PyQt or PySide.

It provides support for PyQt5, PyQt4, PySide2 and PySide using the Qt5 layout (where the QtGui module has been split into QtGui and QtWidgets).

Basically, you can write your code as if you were using PySide2 but import Qt modules from qtpy instead of PySide2 (or PyQt5)

Attribution and acknowledgments

This project is based on the pyqode.qt project and the spyderlib.qt module from the Spyder project, and also includes contributions adapted from qt-helpers, developed as part of the glue project.

Unlike pyqode.qt this is not a namespace package, so it is not tied to a particular project or namespace.


This project is released under the MIT license.


You need PyQt5, PyQt4, PySide2 or PySide installed in your system to make use of QtPy. If several of these packages are found, PyQt5 is used by default unless you set the QT_API environment variable.

QT_API can take the following values:

  • pyqt5 (to use PyQt5).
  • pyqt or pyqt4 (to use PyQt4).
  • pyside2 (to use PySide2)
  • pyside (to use PySide).


pip install qtpy


conda install qtpy


Everyone is welcome to contribute!


Become a sponsor to get your logo on our README on Github.


comments powered by Disqus