gitwtfhub

wtf is esdmax-r9700-fp8?

mininmaxim/esdmax-r9700-fp8 — explained in plain English

Analysis updated 2026-05-18

0HIPAudience · ops devopsComplexity · 5/5Setup · hard

TL;DR

Custom, hand-tuned GPU math routines that speed up running large AI language models on a specific AMD graphics card, plugging into the vLLM inference engine.

Mindmap

mindmap
  root((esdmax r9700 fp8))
    What it does
      Speeds up AI inference
      FP8 matrix math
      Plugs into vLLM
    Tech stack
      HIP
      AMD ROCm
      Python
      PyTorch
    Use cases
      GPU kernel tuning
      LLM decode speedup
      Benchmarking hardware
    Audience
      GPU engineers
      ML infra teams
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Speed up token generation when serving a large language model on an AMD Radeon AI PRO R9700 card.

REASON 2

Benchmark and compare different GPU kernel tuning strategies for FP8 matrix multiplication.

REASON 3

Plug faster fused quantization and matrix multiply kernels into a vLLM deployment.

REASON 4

Study a documented case of step by step GPU performance debugging on real model shapes.

What's in the stack?

HIPPyTorchPythonROCmvLLM

How do you spin it up?

Difficulty · hard Time to first run · 1day+

Requires a specific AMD R9700 GPU, a ROCm/HIP toolchain, and a paired vLLM fork to build and test against.

No license information is given in the README.

Wtf does this do

esdmax-r9700-fp8 is a low level performance add-on for a specific AMD graphics card, the Radeon AI PRO R9700. It provides custom math routines, written for AMD's HIP programming language, that speed up a particular kind of matrix multiplication used inside large AI language models. These routines plug into vLLM, a popular tool for running AI models efficiently, through a small environment variable switch and a paired fork of the vLLM project. The project targets the numeric format called FP8, an eight bit way of storing model weights that saves memory and can run faster than the more common sixteen bit format, as long as the hardware and software are tuned well for it. This repository is entirely about that tuning: getting a graphics card's memory bandwidth used as fully as possible while running an AI model. Most of the README documents a sequence of performance fixes and the reasoning behind them, benchmarked on a real large language model. Each fix targeted a specific inefficiency, such as work being done one thread at a time instead of spread across many, too few parallel work units to keep the card busy, repeated setup work inside a loop that should only happen once, or too many memory read streams competing with each other. Together these changes roughly tripled the speed of decoding text with the model, measured in tokens produced per second, moving performance closer to the theoretical maximum the memory hardware allows. There is also a caution in the README about how to benchmark this kind of code correctly, since the graphics card has a large on chip cache that can make a test look faster than it would be with real, varied data. This project is aimed at engineers who work on the low level performance of AI inference on AMD hardware, not general application developers. It includes build, test, and benchmark commands, but assumes familiarity with GPU programming concepts. No license information is given in the README.

Yoink these prompts

Prompt 1
Explain how FP8 quantization trades accuracy for speed when running a large language model.
Prompt 2
Help me understand why splitting a GEMM computation across more workgroups can speed it up on a GPU.
Prompt 3
Walk me through how to set the VLLM_ROCM_USE_ESDMAX_FP8_GEMM environment variable to use this kernel.
Prompt 4
Show me how to write a benchmark script that avoids GPU cache effects distorting memory bandwidth results.

Frequently asked questions

wtf is esdmax-r9700-fp8?

Custom, hand-tuned GPU math routines that speed up running large AI language models on a specific AMD graphics card, plugging into the vLLM inference engine.

What language is esdmax-r9700-fp8 written in?

Mainly HIP. The stack also includes HIP, PyTorch, Python.

What license does esdmax-r9700-fp8 use?

No license information is given in the README.

How hard is esdmax-r9700-fp8 to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is esdmax-r9700-fp8 for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.