⚡ qifa – Quick Installer for Flash Attention
One command to detect, select, and install the correct flash-attn wheel for your environment.
✨ Features
- Auto-Detection – Identifies Python version, PyTorch version, CUDA version, and C++11 ABI
- Smart Matching – Finds the correct prebuilt wheel from official GitHub Releases
- Zero Config – Just run
qifa installand you're done - Dry Run Mode – Preview what will be installed before committing
Note: Currently optimized for Linux x86_64 official wheels. Windows/ROCm users will receive guidance but may need manual installation.
📦 Installation
pip install qifa
🚀 Quick Start
# Check your environment and see which wheel will be installed
qifa plan
# Install the matching flash-attn wheel
qifa install
📖 Commands
| Command | Description |
|---|---|
qifa plan |
Show detected environment and the wheel that will be installed |
qifa install |
Download and install the matching wheel |
qifa uninstall |
Remove existing flash-attn installation |
qifa doctor |
Run compatibility checks and get guidance |
Options
# Install a specific version
qifa install --version 2.5.8
# Force a specific C++11 ABI setting
qifa install --abi FALSE
# Preview without installing
qifa install --dry-run
🔍 Example Output
$ qifa plan
{
"python_tag": "cp310",
"torch_mm": "2.1",
"torch_cuda": "cu121",
"chosen_cu_tag": "cu121",
"abi_FALSE": true,
"platform": "linux_x86_64",
"version": "2.5.8",
"found_asset": "flash_attn-2.5.8+cu121torch2.1cxx11abiFALSE-cp310-cp310-linux_x86_64.whl",
"download_url": "https://github.com/Dao-AILab/flash-attention/releases/download/..."
}
🛠️ Troubleshooting
| Issue | Solution |
|---|---|
| No matching wheel found | Try --version to specify a different version, or --abi TRUE |
| PyTorch not detected | Install CUDA-enabled PyTorch first: pip install torch --index-url https://download.pytorch.org/whl/cu121 |
| Platform not supported | Official wheels are for Linux x86_64; other platforms require building from source |
Run qifa doctor for detailed guidance on your specific environment.
📄 License
BSD-3-Clause © Voidful
Metadata
Release files for qifa 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| qifa-0.1.1.tar.gz | 5.6 kB | Without provenance | Details for qifa-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| qifa-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for qifa-0.1.1-py3-none-any.whl |
Total release size: 11.6 kB
Release files / qifa-0.1.1.tar.gz
| Download URL | qifa-0.1.1.tar.gz |
|---|---|
| Size | 5.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b813aa0d080e9f4bc4835de92edf571103aaa0316bb9574b1364a85427e9df55
|
|
BLAKE2b-256 checksum How to use checksums |
c67aacf9dc4ff60b5709c192fa447b108a761bd370c478406070282da8a86cd3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.9
|
Release files / qifa-0.1.1-py3-none-any.whl
| Download URL | qifa-0.1.1-py3-none-any.whl |
|---|---|
| Size | 6.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
17c0f843e27e6e024cd41f2170052e18614ab0f343530efe03fa979da9014f5e
|
|
BLAKE2b-256 checksum How to use checksums |
ba5217e11d665196e3f8c121752b90564d4a5e7ce726be883f617086656df0d8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.9
|
Security for qifa 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.