How to Install PySide6 in Python
Python bindings for the Qt cross-platform application and UI framework
pip install PySide6
What is PySide6?
Python bindings for the Qt cross-platform application and UI framework
Important: for Qt5 compatibility, check PySide2
PySide6 is the official Python module from the Qt for Python project, which provides access to the complete Qt 6.0+ 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.
Quick Start
Minimal example to get started with PySide6:
import PySide6
print(PySide6.__version__)Installation
pip (standard)
pip install PySide6Virtual environment (recommended)
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install PySide6pip3
pip3 install PySide6conda
conda install -c conda-forge PySide6Poetry
poetry add PySide6Dependencies
Installing PySide6 will also install these packages:
Verify the Installation
After installing, confirm the package is available:
python -c "import PySide6; print(PySide6.__version__)"If this prints a version number, installation succeeded. If you see a ModuleNotFoundError, see the errors section below.
Installation Errors
Common errors when installing PySide6 with pip.
ModuleNotFoundError: No module named 'PySide6'
Cause: The package is not installed in the current Python environment.
Fix: Run pip install PySide6. If using a virtual environment, ensure it is activated first.
ModuleNotFoundError: No module named 'PySide6' (installed but still failing)
Cause: pip installed the package into a different Python than the one running your script.
Fix: Use python -m pip install PySide6 to install into the interpreter you are running.
ImportError: cannot import name 'X' from 'PySide6'
Cause: The function or class does not exist in the installed version.
Fix: Check the version with pip show PySide6 and upgrade with pip install --upgrade PySide6.
pip: command not found
Cause: pip is not in PATH or Python was not added to PATH during installation.
Fix: Try python -m pip install PySide6. On macOS/Linux try pip3.
PermissionError: [Errno 13] Permission denied
Cause: No write access to the system Python package directory.
Fix: Use a virtual environment, or add --user: pip install --user PySide6
SSL: CERTIFICATE_VERIFY_FAILED
Cause: pip cannot verify PyPI's SSL certificate — common behind corporate proxies.
Fix: Try: pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org PySide6
Recent Releases
| Version | Released |
|---|---|
6.10.3 |
2026-04-02 |
6.11.0 latest |
2026-03-23 |
6.10.2 |
2026-02-02 |
6.10.1 |
2025-11-20 |
6.10.0 |
2025-10-08 |
Manage PySide6
Upgrade to latest version
pip install --upgrade PySide6Install a specific version
pip install PySide6==6.11.0Uninstall
pip uninstall PySide6Check what is installed
pip show PySide6