superqt

library0.8.2pypypiunverified

SuperQT is a collection of missing widgets and components that extend the capabilities of PyQt and PySide for building rich graphical user interfaces. It provides a variety of useful classes, from advanced sliders and combo boxes to utility functions for array conversion and signal blocking. The current version is 0.8.1, with frequent minor releases to add features and fix bugs, typically on a monthly basis.

web-framework

pip install superqt PyQt6

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · SUPERQT

superqt

web-frameworkpythonv0.8.2

Install

6.5s avg

Import

—

Disk

674MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.8.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.960 runs

build_error

glibc

py 3.10–3.960 runs

installs and imports cleanly · install 6.5s · import 0.000s · 680MB

674MB installed

● package 674MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

QLabeledSlider

✓ from superqt.sliders import QLabeledSlider

✗ from superqt import QLabeledSlider

Most superqt widgets are in specific submodules, not directly under `superqt`.

QToggleSwitch

✓ from superqt.widgets import QToggleSwitch

✗ from superqt import QToggleSwitch

Widgets like QToggleSwitch are found in the `superqt.widgets` submodule.

QSearchableComboBox

✓ from superqt.combobox import QSearchableComboBox

✗ from superqt import QSearchableComboBox

ComboBoxes are located in the `superqt.combobox` submodule.

qt_signals_blocked

✓ from superqt.utils import qt_signals_blocked

This example demonstrates a basic `QLabeledSlider` from `superqt`, which provides a slider with an integrated label showing its current value. It requires a Qt application context.

import sys from superqt.sliders import QLabeledSlider from PyQt6.QtWidgets import QApplication, QWidget, QVBoxLayout if __name__ == '__main__': app = QApplication(sys.argv) w = QWidget() layout = QVBoxLayout() slider = QLabeledSlider() slider.setRange(0, 100) slider.setValue(50) layout.addWidget(slider) w.setLayout(layout) w.setWindowTitle("SuperQT Labeled Slider Example") w.show() sys.exit(app.exec())

Debug

Known issues

breakingSuperQT v0.8.0 dropped support for Python 3.9 and PySide2. Users on these versions must upgrade their Python environment or switch to a different Qt binding like PyQt5, PyQt6, or PySide6.

fix

Upgrade Python to 3.10+ and install a compatible Qt backend (e.g., `pip install PyQt6`).

affects: >=0.8.0

gotchaSuperQT does NOT install a Qt binding for you. You must explicitly install one (e.g., PyQt6, PySide6, PyQt5) for superqt to function.

fix

Install a Qt backend package alongside superqt: `pip install superqt PyQt6` (or PySide6/PyQt5).

affects: all

gotchaMany superqt components are organized into specific submodules (e.g., `superqt.sliders`, `superqt.widgets`, `superqt.combobox`). Importing directly from `superqt` will often result in an `AttributeError`.

fix

Always check the documentation or examples for the correct submodule path for the specific widget or utility you intend to use. For example, `from superqt.sliders import QLabeledSlider`.

affects: all

Upgrade

Version history

0.8.2latest on PyPI · released May 18, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

28 hits · last 30 days

node

Resources

githubhttps://github.com/pyapp-kit/superqt ↗

packagehttps://pypi.org/project/superqt/ ↗

docshttps://pyapp-kit.github.io/superqt/ ↗

changeloghttps://github.com/pyapp-kit/superqt/blob/main/CHANGELOG.md ↗