Skip to main content

Another unofficial Qt installer

Project description Documentation Status
OS Status
MacOS macos
Ubuntu ubuntu3
Windows windows

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 on Linux, OS X and Windows.


Dependencies: python, 7z

It is required p7zip for windows, 7zip for mac or p7zip-full for Ubuntu.


Same as usual, it can be installed with pip

$ pip install aqtinstall


General usage looks like this:

aqt [-h][--help] install <qt-version> <host> <target> [<arch>]
python -m aqt [-h][--help] 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

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:\> cd Qt
C:\Qt\> aqt install 5.11.3 windows desktop win64_msvc2017_64

Example: Installing Qt 5.12.0 for Linux:

pip install aqtinstall
cd /opt
sudo aqt install 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.


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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aqtinstall, version 0.4.0
Filename, size File type Python version Upload date Hashes
Filename, size aqtinstall-0.4.0-py2.py3-none-any.whl (13.5 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size aqtinstall-0.4.0.tar.gz (9.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page