{"id":21785,"library":"pyqt-builder","title":"PyQt-builder","description":"PyQt-builder is the official build system for PyQt, used to build PyQt packages from source. It provides a Qt-based build system using SIP and the Qt build tools. Current version is 1.19.1, released periodically.","status":"active","version":"1.19.1","language":"python","source_language":"en","source_url":"https://github.com/Python-PyQt/pyqt-builder","tags":["PyQt","build","sip","Qt"],"install":[{"cmd":"pip install pyqt-builder","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for PyQt build process","package":"sip","optional":false},{"reason":"Required SIP bindings for respective Qt version","package":"PyQt5-sip or PyQt6-sip","optional":true}],"imports":[{"note":"No common wrong import, but ensure pyqtbuild is used, not pyqt-builder.","wrong":"","symbol":"PyQtBuilder","correct":"from pyqtbuild import PyQtBuilder"},{"note":"SipBuilder or old sip module; sipbuild is the correct package.","wrong":"","symbol":"Sip","correct":"from sipbuild import Sip"}],"quickstart":{"code":"from pyqtbuild import PyQtBuilder\n\nbuilder = PyQtBuilder()\nbuilder.build('.')\n","lang":"python","description":"Basic usage to build a PyQt project."},"warnings":[{"fix":"Use 'from pyqtbuild import PyQtBuilder' instead of 'from pyqt_builder import PyQtBuilder'.","message":"The import and API changed completely from pyqt-builder v1.0 to v1.1+. The package 'pyqtbuild' replaces the old 'pyqt_builder' module. Old code using 'from pyqt_builder import ...' will break.","severity":"breaking","affected_versions":"<1.0 vs >=1.1"},{"fix":"Ensure Qt is installed and accessible via the system PATH or set QTDIR to the Qt root.","message":"PyQt-builder may not build automatically if the Qt installation is not found. Users often forget to set environment variables like QTDIR or PATH.","severity":"gotcha","affected_versions":"all"},{"fix":"Use builder.configure(...) followed by builder.make() instead of builder.build('.').","message":"The 'build()' method with a single argument (source directory) is deprecated in favor of explicit configuration via 'configure()' and 'make()'.","severity":"deprecated","affected_versions":">=1.15"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'pip install pyqt-builder'.","cause":"Trying to import 'pyqtbuild' without installing pyqt-builder.","error":"ModuleNotFoundError: No module named 'pyqtbuild'"},{"fix":"Change import to 'from pyqtbuild import PyQtBuilder'.","cause":"Old code using 'pyqt_builder' which is removed in newer versions.","error":"ImportError: cannot import name 'PyQtBuilder' from 'pyqt_builder'"},{"fix":"Install Qt (e.g., via 'apt install qtbase5-dev' on Ubuntu) or set QTDIR environment variable.","cause":"Qt is not installed or not in PATH.","error":"pyqtbuild.errors.QtNotFoundError: Qt qmake not found"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}