decoding_attention

KO | EN

gitlite — search

#javascript #go #golang #machine-learning #rust #linux #docker #macos #nodejs #windows #awesome-list #vue #pytorch #mcp

decoding_attention

(★ 48)

Decoding Attention is specially optimized for MHA, MQA, GQA and MLA using CUDA core for the decoding stage of LLM inference.

decoding_attention Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Decoding Attention
Decoding Attention is specially optimized for Multi-Head Attention (MHA), Multi-Query Attention (MQA), Grouped-Query Attention (GQA) and Multi-Head Latent Attention  (MLA) using CUDA core for the decoding stage of LLM inference. It mainly refers to OpenPPL and Flash Attention, which can solve the problem of low tensor core utilization of Flash Attention in the decoding stage of LLM inference and support more types of attention and kv cache quantization optimization. The calculation expression is as follows, where the precision of tensor Q, K, V and O is FP16 or BF16. In some LLM inference decoding scenarios, the performance of Decoding Attention is better than Flash Decoding (Flash Attention) and FlashInfer. In addition, Decoding Attention also supports variable length and ALiBi inference scenarios.
```
O = Softmax(Q * K^T) * V
```

![dmha](https://raw.githubusercontent.com/Bruce-Lee-LY/decoding_attention/master/media/images/dmha.png)

# Support
- Variable Length: Variable kv length inference
- ALiBi: Attention with linear biases inference

# Environment
- OS: Linux
- Cmake Version: >= 3.16
- GCC Version: >= 5.0
- CUDA Version: >= 11.4
- Others: gflags, ccache, pytest
```
sudo apt-get install libgflags-dev ccache
pip install pytest
```

# Clone
```
git clone https://github.com/Bruce-Lee-LY/decoding_attention.git
```

# CPP API
## Build
### NVIDIA A100
```
cd decoding_attention
./build_cpp.sh -a 80 -t Release -b OFF
./build_cpp.sh -a 80 -t Debug -b OFF
```

### RTX3080Ti / RTX3090 / RTX A6000
```
cd decoding_attention
./build_cpp.sh -a 86 -t Release -b OFF
./build_cpp.sh -a 86 -t Debug -b OFF
```

### L20 / L40S
```
cd decoding_attention
./build_cpp.sh -a 89 -t Release -b OFF
./build_cpp.sh -a 89 -t Debug -b OFF
```

### H20 / H800
```
cd decoding_attention
./build_cpp.sh -a 90 -t Release -b OFF
./build_cpp.sh -a 90 -t Debug -b OFF
```

## Test
```
./run_cpp.sh
```

## Benchmark
```
./run_cpp.sh
```

## Performance
Process the cpp result in the log and plot it as a line chart.

```
cd tools/performance/cpp
./performance.sh
```

# Python API
## Install
```
cd decoding_attention
./install_python.sh
```

## Test
```
./run_python.sh
```

## Benchmark
```
./run_python.sh
```

## Performance
Process the python result in the log and plot it as a line chart.

```
cd tools/performance/python
./performance.sh
```

### MHA Running on RTX3090
- CUDA Version: 12.1
- Head Num: 32
- Head Dim: 128
- Data Type: FP16

#### Seq Len
The performance of Decoding Attention is better when the sequence length is below 1536, while the performance of Flash Decoding (Flash Attention) and FlashInfer is better when the sequence length is above 1536.
- Batch Size: 1
- Seq Q: 1
- Seq K: Seq Len

![seq_throughput](https://raw.githubusercontent.com/Bruce-Lee-LY/decoding_attention/master/performance/RTX3090/seq_throughput.png)

#### Batch Size
Regardless of bacth size, Decoding Attention has better performance than Flash Decoding (Flash Attention) and FlashInfer.
- Batch Size: Batch Size
- Seq Q: 1
- Seq K: 128

![batch_throughput](https://raw.githubusercontent.com/Bruce-Lee-LY/decoding_attention/master/performance/RTX3090/batch_throughput.png)

### MLA Running on H20
- CUDA Version: 12.4
- Head Num: 128
- Head Num K: 1
- Head Dim: 576
- Head Dim V: 512
- Data Type: FP16

#### Seq Len
- Batch Size: 1
- Seq Q: 1
- Seq K: Seq Len

![seq_throughput](https://raw.githubusercontent.com/Bruce-Lee-LY/decoding_attention/master/performance/H20/seq_throughput.png)
![seq_bandwidth](https://raw.githubusercontent.com/Bruce-Lee-LY/decoding_attention/master/performance/H20/seq_bandwidth.png)

#### Batch Size
- Batch Size: Batch Size
- Seq Q: 1
- Seq K: 4096

![batch_throughput](https://raw.githubusercontent.com/Bruce-Lee-LY/decoding_attention/master/performance/H20/batch_throughput.png)
![batch_bandwidth](https://raw.githubusercontent.com/Bruce-Lee-LY/decoding_attention/master/performance/H20/batch_bandwidth.png)

# Reference
- [ppl.llm.kernel.cuda](https://github.com/OpenPPL/ppl.llm.kernel.cuda)
- [flash-attention](https://github.com/Dao-AILab/flash-attention): v2.6.3
- [flashinfer](https://github.com/Bruce-Lee-LY/flashinfer): v0.1.6
- [FlashMLA](https://github.com/deepseek-ai/FlashMLA)

# TODO
- Kernel Optimization
- KV Cache Quantization: FP8、Int8、Int4

decoding_attention

decoding_attention Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

decoding_attention

decoding_attention Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README