aqtinstall is a Python library and command-line tool for installing specific versions of Qt, Qt tools, and add-ons directly from Qt's official servers. It provides an unofficial, robust, and programmatic way to manage Qt installations, particularly useful in CI/CD environments. The current version is 3.3.0, and it generally follows a monthly or bi-monthly release cadence for minor updates and bug fixes.
pip install aqtinstallVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to programmatically install a specific Qt version and optional modules using `aqtinstall.aqt.run_install`. It sets up an installation directory and handles potential errors. Remember to adjust `os_name` and `arch` to match your target system. For commercial Qt versions, you might need to provide username and password as environment variables or directly.
Upgrade your Python environment to 3.9 or higher. `aqtinstall` now requires `Python >= 3.9`.
Consult the official Qt download archives or `aqtinstall`'s `list-archives` command (via CLI) to verify available options for your desired Qt version and platform. Common architectures include `win64_msvc2019_64`, `linux_gcc_64`, `macos` (for macOS universal builds).
Ensure your environment has stable internet access. For CI/CD, consider caching strategies or pre-downloading if network is a concern.
Upgrade `aqtinstall` to version 3.2.0 or higher. When installing commercial Qt, provide your Qt account username and password via `username` and `password` parameters to `run_install` or `AqtInstaller`.
Ensure the target directory is writable. For system-wide installations, you might need `sudo` or administrator privileges, or choose a user-specific location like `~/.local/Qt`.