Awesome

Triton-Viz: A Visualization Toolkit for programming with Triton

<br /> <div align="center"> <img src="Logo.jpg" alt="Logo" width="320" height="320"> </div> <br/>

Welcome to Triton-Viz, a visualization and profiling toolkit designed for deep learning applications. Built with the intention of making GPU programming on Triton more intuitive.

<details> <summary>Table of Contents</summary> <ol> <li> <a href="#About">About</a> <li> <a href="#Getting-Started">Getting Started</a> <ul> <li><a href="#Prerequisites">Prerequisites</a></li> <li><a href="#Installation-of-Triton_Viz">Installation of Triton_Viz</a></li> </ul> <li> <a href="#Working-with-Examples">Working with examples</a> <ul> <li><a href="#More-Puzzles">More puzzles</a></li> </ul> </li> <li><a href="#License">License</a></li> </ol> </details>

About

Triton-Viz is a visualization and analysis toolkit specifically designed to complement the development and optimization of applications written in OpenAI's Triton, an open-source programming language aimed at simplifying the task of coding for accelerators such as GPUs. Triton-Viz offers a suite of features to enhance the debugging, performance analysis, and understanding of Triton code.

Given that Triton allows developers to program at a higher level while still targeting low-level accelerator devices, managing and optimizing resources like memory becomes a crucial aspect of development. Triton-Viz addresses these challenges by providing real-time visualization of tensor operations and their memory usage. The best part about this tool is that while it does focus on visualizing GPU operations, users are not required to have GPU resources to run examples on their system.

Getting Started

Prerequisites

Python installed (preferably the latest available version).
Triton installed. Follow the installation instructions in the linked repository.

Upon successfully installing Triton, install Torch using the following command:

pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu121

Upon successful installation of Torch make sure to uninstall pytorch-triton using the following command:

pip uninstall pytorch-triton

Installation of Triton-Viz

Clone the repository to your local machine:

git clone https://github.com/Deep-Learning-Profiling-Tools/triton-viz.git
cd triton-viz
pip install -e .

You're all set!

Working with Examples

cd examples
python <file_name>.py

More Puzzles

If you're interested in fun puzzles to work with in Triton, do check out: Triton Puzzles

License

Triton-Viz is licensed under the MIT License. See the LICENSE for details.

Publication

If you find this repo useful for your research, please cite our paper:

@inproceedings{ramesh2025tritonviz,
  author={Ramesh, Tejas and Rush, Alexander and Liu, Xu and Yin, Binqian and Zhou, Keren and Jiao, Shuyin},
  title={Triton-Viz: Visualizing GPU Programming in AI Courses},
  booktitle = {Proceedings of the 56th ACM Technical Symposium on Computer Science Education (SIGCSE TS '25)},
  numpages = {7},
  location = {Pittsburgh, Pennsylvania, United States},
  series = {SIGCSE TS '25}
}