FlashAttention that just works. No compilation. Any GPU. AMD ROCm, NVIDIA CUDA, Intel, Apple via Vulkan.
Project description
aule-attention
FlashAttention that just works. No compilation. Any GPU.
Version: 0.3.7
What's New in 0.3.7
- Windows DLL included - Cross-compiled Windows support with PagedAttention
What's New in 0.3.6
- PagedAttention (vLLM-style): Block-based KV cache for 90% memory savings
- 7-13x Faster Vulkan: New fast shader with 32x32 blocks and vec4 loads
- Sliding Window Attention: Efficient local attention with
window_sizeparameter - Native FP16/BF16 Compute: Triton kernels now use native precision (no FP32 conversion overhead)
- Multiple Shader Variants: Choose baseline, fast, fp16, or fp16_amd for your hardware
- Long Context Support: Validated up to 4K+ tokens
Performance Highlights
| Feature | Improvement |
|---|---|
| PagedAttention | 90% memory savings, 7.9K tokens/sec batched |
| Fast Shader | 7-13x speedup over baseline |
| Sliding Window (S=1024, W=128) | 7.6x faster (544ms → 71ms) |
| Triton FP16/BF16 | ~20-30% faster (native compute) |
New Shader Variants API
from aule.vulkan import Aule
with Aule() as aule:
# Check available variants
print(aule.available_shader_variants) # [0, 1, 2, 3]
print(aule.shader_variant_name) # "fast" (default)
# Switch variants
aule.set_shader_variant(Aule.SHADER_BASELINE) # 0: Original 16x16
aule.set_shader_variant(Aule.SHADER_FAST) # 1: Optimized 32x32 (default)
aule.set_shader_variant(Aule.SHADER_FP16) # 2: FP16 with FP32 accumulation
aule.set_shader_variant(Aule.SHADER_FP16_AMD) # 3: FP16 for AMD 64-wide wavefronts
Sliding Window Attention
# Mistral-style sliding window (only attend to nearby tokens)
output = aule.attention_gravity(q, k, v, indices, window_size=256)
# Massive speedup for long sequences
# S=4096, window=512 → ~8x faster than full attention
What's New in 0.3.3
- Windows Vulkan Support: Added Windows DLL - Vulkan backend now works on Windows!
- Windows AMD Fix: Automatic fallback to Vulkan on Windows + AMD (Triton AMD doesn't support Windows)
What's New in 0.3.0
- GQA/MQA Support: Full Grouped Query Attention and Multi-Query Attention for Vulkan backend
- Cross-Attention: Different sequence lengths for Q and K/V tensors
- ComfyUI Compatible: Works with Stable Diffusion, SDXL, Flux, SD3 (use
causal=False) - 20% Faster: Phase 1 performance optimizations
- Bug Fixes: Tensor cache fix for GQA, blocky noise fix for diffusion models
Installation
pip install aule-attention
Quick Start
from aule import flash_attention
import torch
q = torch.randn(1, 8, 512, 64, device='cuda')
k = torch.randn(1, 8, 512, 64, device='cuda')
v = torch.randn(1, 8, 512, 64, device='cuda')
output = flash_attention(q, k, v, causal=True)
ComfyUI / Diffusion Models
import aule
aule.install() # Patches PyTorch SDPA globally
# Now all models using F.scaled_dot_product_attention use aule
# For diffusion models, causal=False is used automatically
GQA (Grouped Query Attention)
# 32 query heads, 8 key/value heads (4:1 ratio)
q = torch.randn(1, 32, 512, 64)
k = torch.randn(1, 8, 512, 64)
v = torch.randn(1, 8, 512, 64)
output = flash_attention(q, k, v, causal=True)
Features
- No compilation at install time
- Works on AMD, NVIDIA, Intel, and Apple GPUs
- Training support with backward pass (Triton backend)
- Grouped Query Attention (GQA) and Multi-Query Attention (MQA) support
- Cross-attention with different Q/KV sequence lengths
- Sliding window attention for efficient long sequences
- O(N) memory complexity via FlashAttention-2 algorithm
Backends
| Backend | Hardware | Features |
|---|---|---|
| Triton | AMD ROCm (Linux), NVIDIA CUDA | Training + Inference, head_dim up to 128 |
| Vulkan | Any Vulkan 1.2+ GPU (including Windows AMD) | Inference, head_dim up to 64, GQA/MQA, Sliding Window |
| CPU | NumPy | Fallback, any head_dim |
Windows + AMD: Automatically uses Vulkan backend (Triton AMD only supports Linux).
API
from aule import flash_attention, get_available_backends, install
# Compute attention
output = flash_attention(query, key, value, causal=True, scale=None)
# Check available backends
backends = get_available_backends() # ['vulkan', 'cpu'] or ['triton', 'vulkan', 'cpu']
# Install as PyTorch SDPA replacement (for ComfyUI, Transformers, etc.)
install() # Auto-select best backend
install(backend='vulkan', verbose=True) # Force backend + logging
Supported Hardware
Triton Backend (Training + Inference)
- AMD Instinct: MI300X, MI300A, MI250X, MI250, MI210, MI100
- NVIDIA Datacenter: H100, A100, A10, L40S
- NVIDIA Consumer: RTX 4090, 4080, 3090, 3080
Vulkan Backend (Inference)
- AMD RDNA3: RX 7900 XTX, 7900 XT, 7800 XT
- AMD RDNA2: RX 6900 XT, 6800 XT, 6700 XT
- Intel Arc: A770, A750, A580
- Intel Integrated: 12th/13th/14th Gen
- Apple Silicon: M1, M2, M3 (via MoltenVK)
License
MIT License - Aule Technologies
Links
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aule_attention-0.3.7-py3-none-any.whl.
File metadata
- Download URL: aule_attention-0.3.7-py3-none-any.whl
- Upload date:
- Size: 897.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b476477c7f3ca1eb285deb2a3a7818ca4054491b0752ebff50ba6dc328b9bea0
|
|
| MD5 |
f558a6c3eb219541fb935b0a7c3bad66
|
|
| BLAKE2b-256 |
e2be41ad7044c6ebdb04f334fb9bf2438fb6e46def7f6d3cdbe5c9d3f94915e8
|