PyQt6 Qt6 Core Components

6.11.0 · active · verified Thu Apr 09

This package provides the core Qt6 shared libraries (DLLs/SOs) compiled for Python, which are a fundamental dependency for the PyQt6 bindings. It does not contain any Python API for direct use, but rather the underlying C++ runtime components. It is typically installed automatically as a dependency of the `PyQt6` package. The current version is 6.11.0, and it generally follows the release schedule of the main PyQt6 library and the underlying Qt framework.

Warnings

gotcha The `pyqt6-qt6` package provides the *runtime C++ libraries* of Qt6, not Python bindings or an API for direct import. Python applications should import modules directly from the `PyQt6` package (e.g., `from PyQt6.QtWidgets import QApplication`). Attempting to import from `pyqt6-qt6` will result in an `ImportError`.
Fix: Ensure all Python-level imports use `PyQt6.*`.
gotcha Version compatibility between `pyqt6-qt6` and `PyQt6` is crucial. Mismatched versions (e.g., `PyQt6==6.5` and `pyqt6-qt6==6.11`) can lead to runtime errors, crashes, or unexpected behavior. It is generally recommended to install `PyQt6`, which will automatically pull in a compatible `pyqt6-qt6` version.
Fix: Always install `PyQt6` directly via `pip install PyQt6` to ensure compatible dependencies, or explicitly match `pyqt6-qt6` version to your `PyQt6` installation if managing them separately.
gotcha When deploying applications, remember that `pyqt6-qt6` bundles platform-specific binaries. If packaging your application (e.g., with PyInstaller or cx_Freeze), ensure that the target environment has the correct `pyqt6-qt6` binaries or that your packaging tool correctly includes them for the intended operating system.
Fix: Test deployments on target OS environments. For cross-platform deployment, ensure separate builds for each OS, as the underlying Qt6 binaries are not universal.
gotcha Multiple Qt installations (e.g., a system-wide Qt installation and the one provided by `pyqt6-qt6`) can lead to conflicts in environment variables (like PATH) or during runtime, causing applications to load incorrect Qt libraries.
Fix: When troubleshooting, ensure that system PATH variables are not inadvertently pointing to other Qt installations. For isolated environments, consider using virtual environments or containerization.

Install

pip install pyqt6-qt6 Install only Qt6 core binaries
pip install PyQt6 Recommended: Install PyQt6 (will include pyqt6-qt6)

Quickstart

This quickstart demonstrates a basic PyQt6 application. The `pyqt6-qt6` package provides the necessary underlying Qt6 C++ runtime libraries that `PyQt6` (which handles the Python bindings) uses to function. You do not directly import or interact with `pyqt6-qt6` from your Python code; its presence as a dependency is sufficient for PyQt6 applications to run.

import sys
from PyQt6.QtWidgets import QApplication, QLabel, QWidget, QVBoxLayout

# Note: pyqt6-qt6 provides the underlying Qt6 C++ libraries for PyQt6 to use.
# You do not import directly from pyqt6-qt6 in your Python code.

if __name__ == '__main__':
    app = QApplication(sys.argv)

    window = QWidget()
    window.setWindowTitle('PyQt6 with pyqt6-qt6 runtime')

    layout = QVBoxLayout()
    label = QLabel('Hello from PyQt6!')
    layout.addWidget(label)

    window.setLayout(layout)
    window.show()

    sys.exit(app.exec())

view raw JSON →