gitwtfhub

wtf is spark-nvfp4-lab?

hiceron/spark-nvfp4-lab — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · ops devopsLicense

TL;DR

A measured benchmark report on running large AI models on Nvidia's DGX Spark hardware, showing where a popular speedup trick helps and where it does not.

Mindmap

mindmap
  root((spark-nvfp4-lab))
    What it does
      Hardware benchmarks
      Speedup claim testing
      Failure catalog
    Tech stack
      Python
      vLLM
      DGX Spark GB10
    Use cases
      Deployment decisions
      Prefill time tradeoffs
      Reproducible testing
    Audience
      ML infra engineers
      Ops teams

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

Decide whether the b12x speedup mode is worth enabling for a model running on DGX Spark hardware.

REASON 2

Compare first-token response time across different prompt lengths before choosing a model.

REASON 3

Avoid the specific failure modes documented here when deploying vLLM on this hardware.

REASON 4

Reproduce the benchmark methodology to validate similar performance claims on other setups.

What's in the stack?

PythonvLLM

How it stacks up

hiceron/spark-nvfp4-lab0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderate
Complexity2/54/5
Audienceops devopsgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

Wtf does this do

This project is a set of real world speed test results for running large AI language models on a specific piece of hardware called the DGX Spark, a compact machine built around Nvidia's GB10 chip. The author spent four days trying to reproduce a claimed 1.79 times speed boost from a special low precision number format called NVFP4, and this repository is the write up of what actually happened when the settings were tested one at a time on one physical machine. The main finding is that a particular fast processing mode, meant to speed up how the model handles its internal expert routing, works fine when combined with a token prediction shortcut technique, once a specific hidden configuration option is set correctly. However, once running, that fast mode actually made responses about 11 percent slower on this hardware and cut the amount of conversation history the model could hold in memory to about a third of what it was before. The author explains this happens because on this chip, the slow part of generating each response is limited by how fast data can move in and out of memory, not by the expert routing step the fast mode was designed to speed up. A second finding is that the time it takes to get the very first word of a response back can grow drastically as the input prompt gets longer, something the author says most published benchmarks never show. A third finding compares a smaller specialized model against a larger general purpose model, showing the smaller one runs three to four times faster for only a tiny difference in a standard reasoning test score. The repository includes the exact deployment commands used, a full table of every measurement taken, a list of five real crashes encountered while testing, and notes on how the tests were run so others can repeat them. The scripts in the repository are released under the MIT License, while the author asks that anyone reusing the measurements themselves credit the source.

Yoink these prompts

Prompt 1
Explain why enabling b12x plus MTP slows down decoding on this specific hardware.
Prompt 2
Walk me through the deployment commands in DEPLOY.md for running these models.
Prompt 3
Summarize the five failure modes described in TROUBLESHOOTING.md and how to avoid them.
Prompt 4
Compare the prefill speed of the smaller model against the larger dense model at long context lengths.

Frequently asked questions

wtf is spark-nvfp4-lab?

A measured benchmark report on running large AI models on Nvidia's DGX Spark hardware, showing where a popular speedup trick helps and where it does not.

What language is spark-nvfp4-lab written in?

Mainly Python. The stack also includes Python, vLLM.

Who is spark-nvfp4-lab for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

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