{"id":1659,"library":"pyqt6-qt6","title":"PyQt6 Qt6 Core Components","description":"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.","status":"active","version":"6.11.0","language":"python","source_language":"en","source_url":"https://www.riverbankcomputing.com/software/pyqt/intro","tags":["GUI","Qt","PyQt","desktop","runtime","bindings","framework"],"install":[{"cmd":"pip install pyqt6-qt6","lang":"bash","label":"Install only Qt6 core binaries"},{"cmd":"pip install PyQt6","lang":"bash","label":"Recommended: Install PyQt6 (will include pyqt6-qt6)"}],"dependencies":[],"imports":[],"quickstart":{"code":"import sys\nfrom PyQt6.QtWidgets import QApplication, QLabel, QWidget, QVBoxLayout\n\n# Note: pyqt6-qt6 provides the underlying Qt6 C++ libraries for PyQt6 to use.\n# You do not import directly from pyqt6-qt6 in your Python code.\n\nif __name__ == '__main__':\n    app = QApplication(sys.argv)\n\n    window = QWidget()\n    window.setWindowTitle('PyQt6 with pyqt6-qt6 runtime')\n\n    layout = QVBoxLayout()\n    label = QLabel('Hello from PyQt6!')\n    layout.addWidget(label)\n\n    window.setLayout(layout)\n    window.show()\n\n    sys.exit(app.exec())","lang":"python","description":"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."},"warnings":[{"fix":"Ensure all Python-level imports use `PyQt6.*`.","message":"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`.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"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.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"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.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"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.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"search_vec":"'6.11.0':59 'api':32 'automat':47 'bind':25,82 'c':40 'compil':14 'compon':4,42 'contain':29 'core':3,9 'current':56 'depend':21,50 'desktop':80 'direct':34 'dlls/sos':13 'follow':63 'framework':76,83 'fundament':20 'general':62 'gui':77 'instal':46 'librari':12,71 'main':69 'packag':6,54 'provid':7 'pyqt':79 'pyqt6':1,24,53,70 'python':16,31 'qt':75,78 'qt6':2,10 'rather':37 'releas':65 'runtim':41,81 'schedul':66 'share':11 'typic':45 'under':39,74 'use':35 'version':57","created_at":"2026-04-09T03:57:38.133211+00:00","updated_at":"2026-04-16T19:42:36.149936+00:00","problems":[{"fix":"Ensure PyQt6 (and its dependency pyqt6-qt6) is correctly installed in your environment. If deploying an application, ensure the Qt platform plugins (e.g., qwindows.dll, libqxcb.so) are correctly bundled alongside the necessary pyqt6-qt6 components. In development, 'pip install --force-reinstall PyQt6' often resolves it.","cause":"The underlying Qt runtime libraries, provided by pyqt6-qt6, are either missing, corrupted, or cannot be found by the PyQt6 application, often due to an incomplete installation or deployment issue.","error":"This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem."},{"fix":"Install or reinstall PyQt6 using 'pip install PyQt6'. Ensure the installation completes without errors and that your Python environment (e.g., virtual environment) is correctly activated.","cause":"The PyQt6 package, which depends on pyqt6-qt6, was not successfully installed or is not accessible in the current Python environment, potentially due to an underlying failure of the pyqt6-qt6 dependency.","error":"ModuleNotFoundError: No module named 'PyQt6'"},{"fix":"pyqt6-qt6 is an internal dependency. Do not attempt to import it directly. Instead, import modules from the PyQt6 library, such as 'PyQt6.QtWidgets' or 'PyQt6.QtCore'.","cause":"Users mistakenly attempt to directly import 'pyqt6-qt6', expecting it to expose Python APIs. However, pyqt6-qt6 provides only the underlying C++ shared libraries and does not have any Python modules for direct import.","error":"ModuleNotFoundError: No module named 'pyqt6-qt6'"},{"fix":"Update pip to the latest version ('pip install --upgrade pip'). Verify your Python version and OS are supported by the PyQt6 and pyqt6-qt6 releases. Try installing in a fresh virtual environment, and check for any network or proxy issues.","cause":"pip failed to find a compatible distribution (wheel) for pyqt6-qt6 that matches your current Python version, operating system, or architecture, typically occurring during 'pip install PyQt6'.","error":"ERROR: Could not find a version that satisfies the requirement pyqt6-qt6"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":"https://www.riverbankcomputing.com/software/pyqt/","github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/pyqt6-qt6/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["web-framework","database","auth-security"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-04-09","next_check":"2026-07-08","install_tag":null}}