# Introducing Triton: Open-Source GPU Programming for Neural Networks

We’re releasing Triton 1.0, an open-source Python-like programming language which enables researchers with no CUDA experience to write highly efficient GPU code—most of the time on par with what an expert would be able to produce. Triton makes it possible to reach peak hardware performance with relatively little efforts; for example, it can be used to write FP16 matrix multiplication kernels that match the performance of cuBLAS—something that many GPU programmers can’t do—in under 25 lines of code. Our researchers have already used it to produce kernels that are up to 2x more efficient than equivalent Torch implementations, and we’re excited to work with the community to make GPU programming more accessible to everyone.

Novel research ideas in the field of Deep Learning are generally implemented using a combination of native framework operators. While convenient, this approach often requires the creation (and/or movement) of many temporary tensors, which can hurt the performance of neural networks at scale. These issues can be mitigated by writing specialized GPU kernels, but doing so can be surprisingly difficult due to the many intricacies of GPU programming. And, although a variety of systems have recently emerged to make this process easier, we have found them to be either too verbose, lack flexibility or generate code noticeably slower than our hand-tuned baselines. This has led us to extend and improve Triton, a recent language and compiler whose original creator now works at OpenAI.

## The Challenges of GPU Programming

The architecture of modern GPUs can be roughly divided into three major components—DRAM, SRAM and ALUs—each of which must be considered when optimizing CUDA code:

Memory transfers from DRAM must be *coalesced* into large transactions to leverage the large bus width of modern memory interfaces.

Data must be manually stashed to SRAM prior to being re-used, and managed so as to minimize shared memory bank conflicts upon retrieval.

Computations must be partitioned and scheduled carefully, both across and within Streaming Multiprocessors (SMs), so as to promote instruction/thread-level parallelism and leverage special-purpose ALUs (e.g., tensor cores).

Reasoning about all these factors can be challenging, even for seasoned CUDA programmers with many years of experience. The purpose of Triton is to fully automate these optimizations, so that developers can better focus on the high-level logic of their parallel code. Triton aims to be broadly applicable, and therefore does not automatically schedule work across SMs — leaving some important algorithmic considerations (e.g. tiling, inter-SM synchronization) to the discretion of developers.

CUDA

Triton

Memory Coalescing

Manual

Automatic

Shared Memory Management

Manual

Automatic

Scheduling (Within SMs)

Manual

Automatic

Scheduling (Across SMs)

Manual

Manual

## Programming Model

Out of all the Domain Specific Languages and JIT-compilers available, Triton is perhaps most similar to Numba: kernels are defined as decorated Python functions, and launched concurrently with different program_id’s on a grid of so-called *instances*. However, as shown in the code snippet below, the resemblance stops there: Triton exposes intra-instance parallelism via operations on *blocks*—small arrays whose dimensions are powers of two—rather than a Single Instruction, Multiple Thread (SIMT) execution model. In doing so, Triton effectively abstracts away all the issues related to concurrency *within* CUDA thread blocks (e.g., memory coalescing, shared memory synchronization/conflicts, tensor core scheduling).

# This is a GPU kernel in Numba.

# Different instances of this

# function may run in parallel.

@jit

def add(X, Y, Z, N):

# In Numba/CUDA, each kernel

# instance itself uses an SIMT execution

# model, where instructions are executed in

# parallel for different values of threadIdx

tid = threadIdx.x

bid = blockIdx.x

# scalar index

idx = bid * BLOCK + tid

if id < N:

# There is no pointer in Numba.

# Z,X,Y are dense tensors

Z[idx] = X[idx] + Y[idx]

…

grid = (ceil_div(N, BLOCK),)

block = (BLOCK,)

add[grid, block](x, y, z, x.shape[0])

# This is a GPU kernel in Triton.

# Different instances of this

# function may run in parallel.

@jit

def add(X, Y, Z, N):

# In Triton, each kernel instance

# executes block operations on a

# single thread: there is no construct

# analogous to threadIdx

pid = program_id(0)

# block of indices

idx = pid * BLOCK + arange(BLOCK)

mask = idx < N

# Triton uses pointer arithmetics

# rather than indexing operators

x = load(X + idx, mask=mask)

y = load(Y + idx, mask=mask)

store(Z + idx, x + y, mask=mask)

…

grid = (ceil_div(N, BLOCK),)

# no thread-block

add[grid](x, y, z, x.shape[0])

While this may not be particularly helpful for embarrassingly parallel (i.e., element-wise) computations, it can greatly simplify the development of more complex GPU programs.

Consider for example the case of a fused softmax kernel (below) in which each instance normalizes a different row of the given input tensor $X in mathbb{R}^{M times N}$. Standard CUDA implementations of this parallelization strategy can be challenging to write, requiring explicit synchronization between threads as they concurrently reduce the same row of $X$. Most of this complexity goes away with Triton, where each kernel instance loads the row of interest and normalizes it sequentially using NumPy-like primitives.

import triton

import triton.language as tl

@triton.jit

def softmax(Y, stride_ym stride_yn, X, stride_xm, stride_xn, M, N):

# row index

m = tl.program_id(0)

# col indices

# this specific kernel only works for matrices that

# have less than BLOCK_SIZE columns

BLOCK_SIZE = 1024

n = tl.arange(0, BLOCK_SIZE)

# the memory address of all the elements

# that we want to load can be computed as follows

X = X + m * stride_xm + n * stride_xn

# load input data; pad out-of-bounds elements with 0

x = tl.load(X, mask=n < N, other=-float(‘inf’))

# compute numerically-stable softmax

z = x – tl.max(x, axis=0)

num = tl.exp(z)

denom = tl.sum(num, axis=0)

y = num / denom

# write back to Y

Y = Y + m * stride_ym + n * stride_yn

tl.store(Y, y, mask=n < N)

import torch

# Allocate input/output tensors

X = torch.normal(0, 1, size=(583, 931), device=’cuda’)

Y = torch.empty_like(X)

# SPMD launch grid

grid = (X.shape[0], )

# enqueue GPU kernel

softmax[grid](Y, Y.stride(0), Y.stride(1),

X, X.stride(0), X.stride(1),

X.shape[0] , X.shape[1])

Note that the Triton JIT treats X and Y as *pointers* rather than tensors; we felt like retaining low-level control of memory accesses was important to address more complex data structures (e.g., block-sparse tensors).

Importantly, this particular implementation of softmax keeps the rows of $X$ in SRAM throughout the entire normalization process, which maximizes data reuse when applicable (~<32K columns). This differs from PyTorch’s internal CUDA code, whose use of temporary memory makes it more general but significantly slower (below). The bottom line here is not that Triton is inherently better, but that it simplifies the development of specialized kernels that can be much faster than those found in general-purpose libraries.

The lower performance of the Torch (v1.9) JIT highlights the difficulty of automatic CUDA code generation from sequences of high-level tensor operations.

@torch.jit.script

def softmax(x):

x_max = x.max(dim=1)[0]

z = x – x_max[:, None]

numerator = torch.exp(x)

denominator = numerator.sum(dim=1)

return numerator / denominator[:, None]

## Matrix Multiplication

Being able to write fused kernels for element-wise operations and reductions is important, but not sufficient given the prominence of matrix multiplication tasks in neural networks. As it turns out, Triton also works very well for those, achieving peak performance with just ~25 lines of Python code. On the other hand, implementing something similar in CUDA would take a lot more effort and would even be likely to achieve lower performance.

@triton.jit

def matmul(A, B, C, M, N, K, stride_am, stride_ak,

stride_bk, stride_bn, stride_cm, stride_cn,

**META):

# extract metaparameters

BLOCK_M, GROUP_M = META[‘BLOCK_M’], META[‘GROUP_M’]

BLOCK_N = META[‘BLOCK_N’]

BLOCK_K = META[‘BLOCK_K’]

# programs are grouped together to improve L2 hit rate

_pid_m = tl.program_id(0)

_pid_n = tl.program_id(1)

pid_m = _pid_m // GROUP_M

pid_n = (_pid_n * GROUP_M) + (_pid_m % GROUP_M)

# rm (resp. rn) denotes a range of indices

# for rows (resp. col) of C

rm = pid_m * BLOCK_M + tl.arange(0, BLOCK_M)

rn = pid_n * BLOCK_N + tl.arange(0, BLOCK_N)

# rk denotes a range of indices for columns

# (resp. rows) of A (resp. B)

rk = tl.arange(0, BLOCK_K)

# the memory addresses of elements in the first block of

# A and B can be computed using numpy-style broadcasting

A = A + (rm[:, None] * stride_am + rk[None, :] * stride_ak)

B = B + (rk [:, None] * stride_bk + rn[None, :] * stride_bn)

# initialize and iteratively update accumulator

acc = tl.zeros((BLOCK_M, BLOCK_N), dtype=tl.float32)

for k in range(K, 0, -BLOCK_K):

a = tl.load(A)

b = tl.load(B)

# block level matrix multiplication

acc += tl.dot(a, b)

# increment pointers so that the next blocks of A and B

# are loaded during the next iteration

A += BLOCK_K * stride_ak

B += BLOCK_K * stride_bk

# fuse leaky ReLU if desired

# acc = tl.where(acc >= 0, acc, alpha * acc)

# write back result

C = C + (rm[:, None] * stride_cm + rn[None, :] * stride_cn)

mask = (rm[:, None] < M) & (rn[None, :] < N)

tl.store(C, acc, mask=mask)

One important advantage of handwritten matrix multiplication kernels is that they can be customized as desired to accommodate fused transformations of their inputs (e.g., slicing) and outputs (e.g., Leaky ReLU). Without a system like Triton, non-trivial modifications of matrix multiplication kernels would be out-of-reach for developers without exceptional GPU programming expertise.

## High-Level System Architecture

The good performance of Triton comes from a modular system architecture centered around Triton-IR, an LLVM-based intermediate representation in which multi-dimensional blocks of values are first-class citizens.

def add(X, Y, Z, N):

pid = program_id(0)

idx= pid * 512 + arange(512)

mask = idx < N

x = load(X + idx, mask=mask)

y = load(Y + idx, mask=mask)

store(Z + idx, x + y, mask=mask)

def void add(i32* X .aligned(16) , i32* Y .aligned(16) , i32* Z .aligned(16) , i32 N .multipleof(2) )

{

entry:

%0 = get_program_id[0] i32;

%1 = mul i32 %0, 512;

%3 = make_range[0 : 512] i32;

%4 = splat i32 %1;

%6 = add i32 %4, %3;

%9 = splat i32 N;

%11 = icmp_slt i1 %6, %9;

%14 = splat i32* X;

%16 = getelementptr i32* %14, %6;

%19 = broadcast i1 %11;

%21 = splat i32 undef;

%22 = masked_load i32 %16, %19, %21;

%26 = splat i32* Y;

%28 = getelementptr i32* %26, %6;

%31 = broadcast i1 %11;

%33 = splat i32 undef;

%34 = masked_load i32 %28, %31, %33;

%38 = splat i32* Z;

%40 = getelementptr i32* %38, %6;

%43 = add i32 %22, %34;

%46 = broadcast i32 %43;

%48 = broadcast i1 %11;

masked_store void %40, %46, %48;

ret void;

}

512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>

.visible .entry add(

.param .u64 add_param_0, .param .u64 add_param_1,

.param .u64 add_param_2, .param .u32 add_param_3

)

.maxntid 128, 1, 1

{

.reg .pred %p;

.reg .b32 %r;

.reg .b64 %rd;

ld.param.u64 %rd4, [add_param_0];

ld.param.u64 %rd5, [add_param_1];

mov.u32 %r13, %tid.x;

ld.param.u32 %r14, [add_param_3];

shl.b32 %r15, %r13, 2;

mov.u32 %r16, %ctaid.x;

mad.lo.s32 %r17, %r16, 512, %r15;

setp.ge.s32 %p3, %r17, %r14;

setp.lt.s32 %p1, %r17, %r14;

mul.wide.s32 %rd7, %r17, 4;

add.s64 %rd2, %rd4, %rd7;

@%p1 ld.global.cg.v4.b32 {%r5,%r6,%r7,%r8}, [ %rd2 + 0];

add.s64 %rd3, %rd5, %rd7;

@%p1 ld.global.cg.v4.b32 {%r9,%r10,%r11,%r12}, [ %rd3 + 0];

@%p3 bra LBB0_2;

ld.param.u64 %rd6, [add_param_2];

add.s64 %rd1, %rd6, %rd7;

add.s32 %r1, %r5, %r9;

add.s32 %r2, %r6, %r10;

add.s32 %r3, %r7, %r11;

add.s32 %r4, %r8, %r12;

st.global.v4.u32 [%rd1], {%r1, %r2, %r3, %r4};

LBB0_2:

ret;

}

8>18>4>

@jit

def add(X, Y, Z, N):

pid = program_id(0)

idx= pid * 512 + arange(512)

mask = idx < N

x = load(X + idx, mask=mask)

y = load(Y + idx, mask=mask)

store(Z + idx, x + y, mask=mask)

def void add(i32* X .aligned(16) , i32* Y .aligned(16) , i32* Z .aligned(16) , i32 N .multipleof(2) )

{

entry:

%0 = get_program_id[0] i32;

%1 = mul i32 %0, 512;

%3 = make_range[0 : 512] i32;

%4 = splat i32 %1;

%6 = add i32 %4, %3;

%9 = splat i32 N;

%11 = icmp_slt i1 %6, %9;

%14 = splat i32* X;

%16 = getelementptr i32* %14, %6;

%19 = broadcast i1 %11;

%21 = splat i32 undef;

%22 = masked_load i32 %16, %19, %21;

%26 = splat i32* Y;

%28 = getelementptr i32* %26, %6;

%31 = broadcast i1 %11;

%33 = splat i32 undef;

%34 = masked_load i32 %28, %31, %33;

%38 = splat i32* Z;

%40 = getelementptr i32* %38, %6;

%43 = add i32 %22, %34;

%46 = broadcast i32 %43;

%48 = broadcast i1 %11;

masked_store void %40, %46, %48;

ret void;

}

512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>512>

.visible .entry add(

.param .u64 add_param_0, .param .u64 add_param_1,

.param .u64 add_param_2, .param .u32 add_param_3

)

.maxntid 128, 1, 1

{

.reg .pred %p;

.reg .b32 %r;

.reg .b64 %rd;

ld.param.u64 %rd4, [add_param_0];

ld.param.u64 %rd5, [add_param_1];

mov.u32 %r13, %tid.x;

ld.param.u32 %r14, [add_param_3];

shl.b32 %r15, %r13, 2;

mov.u32 %r16, %ctaid.x;

mad.lo.s32 %r17, %r16, 512, %r15;

setp.ge.s32 %p3, %r17, %r14;

setp.lt.s32 %p1, %r17, %r14;

mul.wide.s32 %rd7, %r17, 4;

add.s64 %rd2, %rd4, %rd7;

@%p1 ld.global.cg.v4.b32 {%r5,%r6,%r7,%r8}, [ %rd2 + 0];

add.s64 %rd3, %rd5, %rd7;

@%p1 ld.global.cg.v4.b32 {%r9,%r10,%r11,%r12}, [ %rd3 + 0];

@%p3 bra LBB0_2;

ld.param.u64 %rd6, [add_param_2];

add.s64 %rd1, %rd6, %rd7;

add.s32 %r1, %r5, %r9;

add.s32 %r2, %r6, %r10;

add.s32 %r3, %r7, %r11;

add.s32 %r4, %r8, %r12;

st.global.v4.u32 [%rd1], {%r1, %r2, %r3, %r4};

LBB0_2:

ret;

}

8>18>4>

The @triton.jit decorator works by walking the Abstract Syntax Tree (AST) of the provided Python function so as to generate Triton-IR on-the-fly using a common SSA construction algorithm. The resulting IR code is then simplified, optimized and automatically parallelized by our compiler backend, before being converted into high-quality LLVM-IR—and eventually PTX—for execution on recent NVIDIA GPUs. CPUs and AMD GPUs are not supported at the moment, but we welcome community contributions aimed at addressing this limitation.

## Compiler Backend

We have found that the use of blocked program representations via Triton-IR allows our compiler to automatically perform a wide variety of important program optimizations. For example, data can be automatically stashed to shared memory by looking at the operands of computationally intensive block-level operations (e.g., tl.dot)—and allocated/synchronized using standard liveness analysis techniques.

On the other hand, Triton programs can be efficiently and automatically parallelized both (1) across SMs by executing different kernel instances concurrently, and (2) within SMs by analyzing the iteration space of each block-level operation and partitioning it adequately across different SIMD units, as shown below.

S2 float B[4,4] = …

S3 float C[4,4] = A + B

S2 half B[2,2] = …

S3 float C[4,2] = dot(A,B)

*P*composed of three statements S1, S2, S3

*P*onto the GPU

S2 float B[4,4] = …

S3 float C[4,4] = A + B

S2 half B[2,2] = …

S3 float C[4,2] = dot(A,B)

*P*composed of three statements S1, S2, S3

*P*onto the GPU

## Contributing

We intend for Triton to become a community-driven project. Feel free to fork our repository on GitHub!

*If you’re interested in joining our team and working on Triton & GPU kernels, we’re hiring!*

Da Yan (HKUST), DeepSpeed (Microsoft), Anthropic

Gray, S. (2017). SGEMM Walkthrough. *URL https://github.com/NervanaSystems/maxas/wiki/SGEMM*.

Kerr, A. (2020). Developing CUDA kernels to push Tensor Cores to the Absolute Limit on NVIDIA A100. *URL https://developer.nvidia.com/gtc/2020/video/s21745-vid*.

Yan, D., Wang, W., & Chu, X. (2020, May). Demystifying tensor cores to optimize half-precision matrix multiply. In *2020 IEEE International Parallel and Distributed Processing Symposium (IPDPS)*. IEEE.

Tillet, P., Kung, H. T., & Cox, D. (2019, June). Triton: an intermediate language and compiler for tiled neural network computations. In *Proceedings of the 3rd ACM SIGPLAN International Workshop on Machine Learning and Programming Languages* (pp. 10-19).

Lin, Y. & Grover, V. (2018). Using CUDA Warp-Level Primitives. *URL https://developer.nvidia.com/blog/using-cuda-warp-level-primitives/*.

Braun, M., Buchwald, S., Hack, S., Leißa, R., Mallon, C., & Zwinkau, A. (2013, March). Simple and efficient construction of static single assignment form. In *International Conference on Compiler Construction* (pp. 102-122). Springer, Berlin, Heidelberg.