A Python package that exposes system-installed PySide6 packages into a virtual environment.
PySide6 publishes multiple packages to PyPI. Howevever, these packages include a full copy of Qt. As a result, a Python app that uses a virtual environment and specifies PySide6 as a dependency will not use the system version of Qt - and as a result, will not adopt the system theme. This leads to an app that doesn't look native, as it doesn't conform to the system look and feel.
This package provides a customization of the Python import system that allows system-installed Python packages
NOTE: This is not an official Qt package!! The BeeWare project has provided this package to provide a way to write Python applications that use a virtual environment (or other forms of environment isolation) without the need to duplicate Qt libraries in the virtual environment.
To use system-pyside6, install the system packages for PySide6:
-
Ubuntu / Debian -
sudo apt-get install python3-pyside6.qtwidgets(Only available from Ubuntu 25.10+ / Debian 14+) -
Fedora -
sudo dnf install python3-pyside6 -
Arch/ Manjaro -
sudo pacman -Syu pyside6 -
OpenSUSE Tumbleweed -
sudo zypper install python3-pyside6
Then, create a virtual environment, and install system-pyside into that environment. You should then be able to write a Python app using PySide6 without adding PySide6 as a dependency of your app.
Briefcase is part of the BeeWare suite. You can talk to the community through:
We foster a welcoming and respectful community as described in our BeeWare Community Code of Conduct.
If you experience problems with system-pyside6, log them on GitHub.
If you'd like to contribute to the development if system-pyside6, submit a pull request.