Another unofficial Qt installer
This is a utility alternative to the official graphical Qt installer, for using in CI environment where an interactive UI is not usable, or just on command line.
It can automatically download prebuilt Qt binaries, documents and sources for target specified, when the versions are on Qt download mirror sites.
License and copyright
This program is distributed under MIT license.
Qt SDK and its related files are under its licenses. When using aqtinstall, you are considered to agree upon Qt licenses. aqtinstall installs Qt SDK as of a (L)GPL Free Software.
- Minimum Python version:
- Recommended Python version:
3.9 (frequently tested on)
requests semantic_version patch py7zr texttable bs4 defusedxml
- Operating Systems:
Linux, macOS, MS Windows
There is precise documentation with many examples. You are recommended to read the Getting started section.
Getting started: https://aqtinstall.readthedocs.io/en/latest/getting_started.html
Stable (v3.0.x): https://aqtinstall.readthedocs.io/en/stable
Old (v2.2.3) : https://aqtinstall.readthedocs.io/en/v2.2.3/
Same as usual, it can be installed with pip:
pip install -U pip pip install aqtinstall
You are recommended to update pip before installing aqtinstall.
It may be difficult to set up some Windows systems with the correct version of Python and all of aqt’s dependencies. To get around this problem, aqtinstall offers aqt.exe, a Windows executable that contains Python and all required dependencies. You may access aqt.exe from the Releases section, under “assets”, or via the persistent link to the continuous build of aqt.exe.
When installing Qt SDK 6.2.0 for Windows.
Check the options that can be used with the list-qt subcommand, and query available architectures:
aqt list-qt windows desktop --arch 6.2.0
Then you may get candidates: win64_mingw81 win64_msvc2019_64 win64_msvc2019_arm64. You can also query the available modules:
aqt list-qt windows desktop --modules 6.2.0 win64_mingw81
When you decide to install Qt SDK version 6.2.0 for mingw v8.1:
aqt install-qt windows desktop 6.2.0 win64_mingw81 -m all
The optional -m all argument installs all the modules available for Qt 6.2.0; you can leave it off if you don’t want those modules.
To install Qt 6.2.0 with the modules ‘qtcharts’ and ‘qtnetworking’, you can use this command (note that the module names are lowercase):
aqt install-qt windows desktop 6.2.0 win64_mingw81 -m qtcharts qtnetworking
When you want to install Qt for android with required desktop toolsets
aqt install-qt linux android 5.13.2 android_armv7 --autodesktop
When aqtinstall downloads and installs packages, it updates package configurations such as prefix directory in bin/qt.conf, and bin/qconfig.pri to make it working well with installed directory.
Some projects utilize aqtinstall, and there are several articles and discussions
GitHub Actions: install_qt
Docker image: docker aqtinstall
Yet another comic reader: YACReader utilize on Azure-Pipelines
Contributor Nelson’s blog article: Fast and lightweight headless Qt Installer from Qt Mirrors - aqtinstall
Lostdomain.org blog: Using Azure DevOps Pipelines with Qt
Qt Forum: Qt silent, unattended install
Qt Study group presentation: Another Qt CLI installer
This program is originally shown in Kaidan project as a name qli-installer. The aqtinstall project extend and improve it.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for aqtinstall-3.1.11-py3-none-any.whl