Skip to content
Another Qt (aqt) CLI Installer on Windows, Mac OSX and Linux
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin introduce Cli class Mar 24, 2019
ci Move ci script in ci folder Jun 2, 2019
tests Azure: Add ci script generator (#20) May 25, 2019
AUTHORS Update AUTHORS; thanks Nelson Jun 1, 2019
CHANGELOG.rst Use py7zr for extracting package 7z archive Jun 4, 2019
CONTRIBUTE.rst Add documents Mar 24, 2019
LICENSE Support for windows Mar 2, 2019


Another Qt installer(aqt)

Jobs Mac Linux Windows Mirror Release Status
Status macos ubuntu windows ext pypi pep8 docs

This is an utility replacing the official graphical Qt installer. It can automatically download prebuilt Qt binaries for any target (you're not bound to Linux binaries on Linux; you could also download iOS binaries). It's working with Python > 3.5 on Linux, OS X and Windows.


Same as usual, it can be installed with pip

$ pip install aqtinstall


General usage looks like this:

aqt [-h][--help][-O | --outputdir <directory>][-b | --base <mirror url>][-E | --external <7zip command>] \
    install <qt-version> <host> <target> [<arch>]
python -m aqt [-h][--help][-O | --outputdir <directory>][-b | --base <mirror url>] \
    install <qt-version> <host> <target> [<arch>]
  • The Qt version is formatted like this: 5.11.3
  • Host is one of: linux, mac, windows
  • Target is one of: desktop, android, ios (iOS only works with mac host)
  • For android and windows you also need to specify an arch: win64_msvc2017_64, win64_msvc2015_64, win32_msvc2015, win32_mingw53, win64_mingw73, android_x86, android_armv7
  • You can also use external 7zip command instead of internal extration function.

The Qt packages are installed under current directory as such Qt<ver>/<ver>/gcc_64/ If you want to install it in C:Qt as same as standard gui installer default, run such as follows:

C:\> mkdir Qt
C:\> aqt install -O c:\Qt 5.11.3 windows desktop win64_msvc2017_64

Example: Installing Qt 5.12.0 for Linux:

pip install aqtinstall
sudo aqt install --outputdir /opt 5.12.0 linux desktop

Example: Installing Android (armv7) Qt 5.10.2:

aqt install 5.10.2 linux android android_armv7

Example: Show help message

aqt help

Supported CI platform

There are no limitation for CI platform but currently it is tested on Azure Pipelines.

Known issues and limitations

Current version(v0.4.0) don't have a capability to install tools such as mingw and qtcreator. A utility install only Qt library staffs.

License and copyright

This program is distributed under MIT license.

Qt SDK and its related files are under its licenses. When using the utility, you are considered to agree upon Qt licenses. For details see Qt licensing and Licenses used in Qt5


This program is originally shown in Kaidan project as a name qli-installer. A project aqtinstall extend the original to run with standard python features with Linux, Mac and Windows, to be tested on CI platform, and to improve performance with a concurrent downloading.

You can’t perform that action at this time.