superqt
Missing widgets and components for PyQt/PySide
What it is and what it does
superqt extends PyQt and PySide with a collection of community-built widgets and utilities that fill gaps in the standard Qt library. It provides specialized UI components like multi-handle range sliders and enhanced comboboxes, alongside practical tools for threading in Qt applications and icon generation from font files (supporting Material Design Icons and Font Awesome). The package is designed to work across macOS, Windows, and Linux with modern Python versions (3.10 and above) and multiple Qt bindings.
Developers use superqt when they need UI elements beyond what the native QtWidgets module offers, or when they want ready-made solutions for common Qt patterns like font-based icons and thread management. It's actively maintained and tested against multiple Qt versions, making it suitable for projects that need reliable, cross-platform custom widgets without building them from scratch.
Use it for:
- Build a data-range selector UI with a multi-handle slider instead of separate min/max inputs.
- Generate application icons dynamically from Material Design Icons or Font Awesome font files.
- Implement thread-safe Qt operations using superqt's threading decorators and utilities.
- Extend a PyQt/PySide application with specialized combobox variants not in the standard library.
- Create cross-platform desktop tools that need consistent custom widgets on macOS, Windows, and Linux.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides additional Qt widgets and UI components (like range sliders and custom comboboxes) not included in the standard PyQt/PySide libraries, plus utilities for threading and icon generation from font files.
Yes. superqt is actively maintained, has low install friction, carries a permissive BSD license, and fills a genuine gap in PyQt/PySide by providing well-tested custom widgets and utilities. No known vulnerabilities. Install it if you need range sliders, font-based icons, or threading helpers in a Qt application.
Install
superqt on PyPI
pip
pip install superqtuv
uv add superqtpoetry
poetry add superqtInstalling superqt
Before you install
Low install friction with only three runtime dependencies (pygments, qtpy, typing-extensions). Actively maintained with recent commits and a stable release cadence; last update was 88 days ago.
License in practice
BSD 3-Clause License (permissive) allows commercial and private use with minimal restrictions—include a copy of the license and retain copyright notices.
Quickstart
pip install superqt
from superqt.widgets import QRangeSlider
slider = QRangeSlider()
Requires Python 3.10 or above and either PyQt5 (5.11+), PyQt6, or PySide6 to be installed separately.
Verify before relying
- Whether all documented widgets are production-ready or if some remain experimental despite Beta status.
- Performance characteristics when rendering many custom widgets in a single application.
- Compatibility matrix details for specific PyQt5/PyQt6/PySide6 version combinations.
Package facts
| License | BSD 3-Clause License (permissive) |
| Python support | supports the current Python release (>=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 3 — pygments, qtpy, typing-extensions |
| Maintenance | actively maintained — 88 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 385,645/month — #7,060 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: superqt-0.8.2-py3-none-any.whl
Keywords: components, gui, pyqt, pyside, qt, range slider, widgets
Tags
More User Interfaces packages
Wraps any iterable to display a real-time…
copyleft · top 100 on PyPI
humanfriendlyFormats and parses numbers, file sizes,…
permissive · top 1,000 on PyPI
coloredlogsAdds colored output to Python's standard…
permissive · top 1,000 on PyPI
rich-argparseFormats argparse and optparse help output with…
permissive · top 1,000 on PyPI
progressbar2progressbar2 renders text-based progress bars…
permissive · top 5,000 on PyPI
inquirerpyInquirerPy provides interactive command-line…
permissive · top 5,000 on PyPI
magicguiMagicgui builds graphical user interfaces…
permissive · top 15,000 on PyPI
QtAwesomeQtAwesome provides iconic fonts—Font Awesome,…
permissive · top 15,000 on PyPI
qasyncqasync integrates asyncio coroutines into…
permissive · top 15,000 on PyPI
qt-materialApplies a Material Design stylesheet to PySide6…
permissive · top 15,000 on PyPI
pyqt5-toolsProvides Qt Designer, QML Scene, and QML Test…
copyleft · top 15,000 on PyPI
QDarkStyleQDarkStyle provides pre-built dark and light…
permissive · top 15,000 on PyPI
PySide6-EssentialsPySide6 Essentials provides Python bindings to…
copyleft · top 5,000 on PyPI
QtPyQtPy provides a unified API for writing Qt…
permissive · top 5,000 on PyPI
PySide6-AddonsPySide6-Addons extends PySide6 with additional…
copyleft · top 5,000 on PyPI
aqtaqt is the Qt-based desktop GUI for Anki, the…
agpl · top 15,000 on PyPI