# Install aqtinstall with Homebrew, Nix, scoop, winget, chocolatey

Another unofficial Qt installer. Version 3.3.0 via Homebrew; verified 2026-06-20.

## Install

```sh
sudo av install brew:aqtinstall
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install aqtinstall
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#aqtinstall
```

  Evidence: nixpkgs package indexes: pkgs/by-name/aq/aqtinstall/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install main/aqtinstall
```

  Evidence: Scoop official bucket manifest trees: bucket/aqtinstall.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id miurahr.aqtinstall -e
```

  Evidence: Windows Package Manager source index: miurahr.aqtinstall from https://cdn.winget.microsoft.com/cache/source.msix

- Chocolatey (92%):

```sh
choco install aqt
```

  Evidence: Chocolatey community package catalog: aqt from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','ansicon'

## Package facts

- **Package key:** brew:aqtinstall
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/aqtinstall>
- **Version:** 3.3.0
- **Source summary:** Another unofficial Qt installer
- **Homepage:** <https://aqtinstall.readthedocs.io/en/latest/>
- **Repository:** <https://github.com/miurahr/aqtinstall>
- **Upstream docs:** <https://aqtinstall.readthedocs.io/en/latest>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/76/19/24a588de6c25d43169d172dab47e63a63cd0d8f90e98cf86487acbf00ac7/aqtinstall-3.3.0.tar.gz>
- **Last updated:** 2026-06-20T10:46:05Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- aqt (cli)
- aqt (alias)

## Dependencies

- certifi
- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 3.3.0
- Package-manager updated: 2026-06-20
- Local data: ok
- Upstream repository: https://aqtinstall.readthedocs.io/en/latest/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

aqtinstall is a Python command-line installer for Qt packages, branded in its own metadata as another unofficial Qt installer. Its `aqt` executable is used mostly in CI and scripted developer environments where the official graphical Qt installer is the wrong shape.

### Project history

The official GitHub repository was created in March 2019 and its documentation is published on Read the Docs. The docs describe a configuration file, command-line options, examples, and a separate official-Qt-installer mode.

The project evolved from downloading public Qt archives into a broader Qt installer wrapper: current docs cover mirror handling, checksum behavior, archive retention, official-installer authentication, and direct pass-through override mode for Qt's own installer CLI.

### Adoption history

The input package metadata shows aqtinstall packaged for Homebrew, Chocolatey, Nix, Scoop, and winget. The official GitHub API metadata also shows a four-digit star count, which is strong adoption for a niche packaging utility.

Its adoption pattern is practical rather than social: developers use it when builds need a reproducible Qt install on Linux, macOS, or Windows without clicking through the Maintenance Tool.

### How it is used

Common use is `aqt install-qt` or the newer `aqt install-qt-official` family to install a target, architecture, Qt version, and optional modules into a chosen output directory.

The configuration docs state that defaults live in `aqt/settings.ini`, with `$AQT_CONFIG` or `--config` available for override. Official-installer mode looks for `qtaccount.ini` in the per-OS Qt data directory or accepts `QT_INSTALLER_JWT_TOKEN`.

### Why package nerds care

aqtinstall is package-manager glue for an upstream ecosystem whose official installer is large, stateful, and account-aware. It is interesting because it turns Qt distribution metadata into a scriptable package acquisition layer while still exposing enough knobs for mirrors, checksums, and CI authentication.

### Timeline

- 2019: The official GitHub repository was created.
- 2020: The project had reached a tagged 1.0 release series.
- 2026: The repository and documentation remain active in the 3.x series.

### Related projects

- Related projects and systems include Qt, Qt Maintenance Tool, Qt online repositories, Python packaging, 7-Zip, py7zr, and CI package caches.

### Sources

- <https://api.github.com/repos/miurahr/aqtinstall>
- <https://aqtinstall.readthedocs.io/en/latest>
- <https://aqtinstall.readthedocs.io/en/latest/configuration.html>
- <https://aqtinstall.readthedocs.io/en/latest/official.html>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for aqtinstall. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: aqt/settings.ini, $AQT_CONFIG

## Credential files

- Linux: ~/.local/share/Qt/qtaccount.ini
- macOS: ~/Library/Application Support/Qt/qtaccount.ini
- Windows: %APPDATA%\Qt\qtaccount.ini
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** aqtinstall
- **Version Scheme:** 0
- **Revision:** 9
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - aqtinstall: normalized package name match | nixpkgs package indexes: pkgs/by-name/aq/aqtinstall/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Scoop - main/aqtinstall: normalized package name match | Scoop official bucket manifest trees: bucket/aqtinstall.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - miurahr.aqtinstall: normalized package name match | Windows Package Manager source index: miurahr.aqtinstall from https://cdn.winget.microsoft.com/cache/source.msix
- Chocolatey - aqt: installed executable or alias match | Chocolatey community package catalog: aqt from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','ansicon'


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [clazy](https://www.automicvault.com/pkg/brew/clazy/) - Shares av.db curated category or tags: cli, developer-tools, qt.
- [gammaray](https://www.automicvault.com/pkg/brew/gammaray/) - Shares av.db curated category or tags: cli, developer-tools, qt.
- [ghcup](https://www.automicvault.com/pkg/brew/ghcup/) - Shares av.db curated category or tags: cli, developer-tools, installer.
- [juliaup](https://www.automicvault.com/pkg/brew/juliaup/) - Shares av.db curated category or tags: cli, developer-tools, installer.
- [kubekey](https://www.automicvault.com/pkg/brew/kubekey/) - Shares av.db curated category or tags: cli, developer-tools, installer.
- [makensis](https://www.automicvault.com/pkg/brew/makensis/) - Shares av.db curated category or tags: cli, developer-tools, installer.
- [makeself](https://www.automicvault.com/pkg/brew/makeself/) - Shares av.db curated category or tags: cli, developer-tools, installer.
- [neovim-qt](https://www.automicvault.com/pkg/brew/neovim-qt/) - Shares av.db curated category or tags: cli, developer-tools, qt.
- [pyqt-builder](https://www.automicvault.com/pkg/brew/pyqt-builder/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, python, python-3-14.
- [abi3audit](https://www.automicvault.com/pkg/brew/abi3audit/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, developer, developer-tools, python.
- [bpython](https://www.automicvault.com/pkg/brew/bpython/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, developer, developer-tools, python.

## Combined YAML source

View the package source record on GitHub. [combined/aqtinstall.yml](https://github.com/automic-vault/db/blob/main/combined/aqtinstall.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
