{"id":10125,"library":"pyqt6-qt","title":"PyQt6-Qt Core Components","description":"The `pyqt6-qt` package is a crucial runtime dependency for `PyQt6`, providing the necessary compiled Qt binaries and libraries. It is not intended for direct import or use by application developers but is automatically installed and utilized by the `PyQt6` package to enable GUI functionality. The current version is 6.0.1, reflecting its close tie to the PyQt6 release cycle.","status":"active","version":"6.0.1","language":"python","source_language":"en","source_url":"https://www.riverbankcomputing.com/software/pyqt/intro","tags":["GUI","Qt","toolkit","dependency","frontend"],"install":[{"cmd":"pip install pyqt6-qt","lang":"bash","label":"Install pyqt6-qt (runtime backend)"},{"cmd":"pip install PyQt6","lang":"bash","label":"Install PyQt6 (frontend, pulls pyqt6-qt)"}],"dependencies":[],"imports":[{"wrong":"from PyQt6.QtWidgets import QApplication","symbol":"QApplication","correct":"from PyQt6.QtWidgets import QApplication"}],"quickstart":{"code":"import sys\nfrom PyQt6.QtWidgets import QApplication, QLabel, QWidget\n\n# Note: pyqt6-qt provides the underlying Qt libraries,\n# enabling the functionality imported from PyQt6.\n\ndef main():\n    app = QApplication(sys.argv)\n    \n    window = QWidget()\n    window.setWindowTitle('PyQt6-Qt Enabled App')\n    window.setGeometry(100, 100, 280, 80)\n    \n    hello_label = QLabel('Hello, PyQt6!', parent=window)\n    hello_label.move(60, 15)\n    \n    window.show()\n    sys.exit(app.exec())\n\nif __name__ == '__main__':\n    main()","lang":"python","description":"This quickstart demonstrates a basic PyQt6 application. While `pyqt6-qt` is not directly imported, it is a mandatory runtime dependency that provides the underlying Qt shared libraries, making the `PyQt6` imports and functionality possible. You typically install `PyQt6` which then pulls in `pyqt6-qt`."},"warnings":[{"fix":"Always import from `PyQt6` (e.g., `PyQt6.QtWidgets`, `PyQt6.QtCore`) in your application code. `pyqt6-qt` is a backend dependency, not an API layer.","message":"Confusion between 'pyqt6-qt' and 'PyQt6'. Users often mistake `pyqt6-qt` for the main Python-facing library and attempt to import directly from it.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Refer to the documentation of your chosen bundling tool (e.g., PyInstaller's `datas` option, or specific PySide/PyQt hooks). Ensure all necessary Qt plugins (platform, image formats, etc.) are included. This often requires running the bundling tool on the target OS or ensuring cross-platform compatibility.","message":"Deployment challenges with bundled applications. When creating standalone executables (e.g., with PyInstaller), the Qt shared libraries provided by `pyqt6-qt` must be correctly bundled for the application to run on other machines.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure the `platforms` directory containing the `qwindows.dll` (or `libqxcb.so` on Linux) is discoverable. For standard installations, this is handled, but in custom environments or deployments, you might need to manually set `QT_QPA_PLATFORM_PLUGIN_PATH` to the correct directory (e.g., `path/to/venv/Lib/site-packages/PyQt6/Qt6/plugins`).","message":"Environment variable QT_QPA_PLATFORM_PLUGIN_PATH not set or pointing to incorrect location, leading to 'Could not find the Qt platform plugin' errors.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"search_vec":"'6.0.1':56 'applic':36 'automat':40 'binari':23 'close':59 'compil':21 'compon':5 'core':4 'crucial':13 'current':53 'cycl':65 'depend':15,69 'develop':37 'direct':31 'enabl':49 'frontend':70 'function':51 'gui':50,66 'import':32 'instal':41 'intend':29 'librari':25 'necessari':20 'packag':10,47 'provid':18 'pyqt6':2,8,17,46,63 'pyqt6-qt':1,7 'qt':3,9,22,67 'reflect':57 'releas':64 'runtim':14 'tie':60 'toolkit':68 'use':34 'util':43 'version':54","created_at":"2026-04-17T01:22:30.473919+00:00","updated_at":"2026-04-17T01:22:30.473919+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nModuleNotFoundError: No module named 'PyQt6.QtWidgets'"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"6.0.1","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-qt/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":[],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}