gitwtfhub

wtf is dspark-vllm-gx10?

anemll/dspark-vllm-gx10 — explained in plain English

Analysis updated 2026-05-18

14PythonAudience · ops devopsComplexity · 5/5LicenseSetup · hard

TL;DR

A technical adaptation that lets the large DeepSeek V4 Flash AI model run split across two connected DGX Spark or ASUS GX10 machines, with faster performance and a live monitoring dashboard.

Mindmap

mindmap
  root((dspark-vllm-gx10))
    What it does
      Runs DeepSeek V4 Flash
      Splits across two nodes
      Shrinks memory with NVFP4
    Tech stack
      Python
      vLLM
      CUDA
      FlashInfer
    Use cases
      Multi node model serving
      Live performance dashboard
      Benchmark comparisons
    Audience
      ML infra engineers
      GPU cluster operators
    Setup
      Two GX10 machines
      Fast node fabric
      Licensed model weights

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

Deploy the DeepSeek V4 Flash AI model across two DGX Spark or ASUS GX10 machines when it is too large to fit on one.

REASON 2

Monitor a running two-node AI deployment in real time using the built in dashboard.

REASON 3

Reproduce and compare benchmark results between different vLLM versions on this specific hardware.

What's in the stack?

PythonvLLMPyTorchCUDAFlashInferDocker

How it stacks up

anemll/dspark-vllm-gx100c33/agentic-aiadennng/stock_strategy_lab
Stars141414
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity5/54/54/5
Audienceops devopsdeveloperresearcher

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

How do you spin it up?

Difficulty · hard Time to first run · 1day+

Requires two DGX Spark or ASUS GX10 machines connected by a dedicated high speed link, plus separately licensed model weights.

The project's own code, such as the dashboard, deployment scripts, and docs, is MIT licensed and free to use and modify. Files adapted from vLLM remain under the Apache 2.0 license, which is also permissive but requires keeping attribution notices.

Wtf does this do

This project is a technical adaptation that lets a large AI language model called DeepSeek V4 Flash run across two connected NVIDIA DGX Spark, or ASUS GX10, machines at once. These are specialized computers built for running big AI models, and this repository modifies a popular AI serving framework called vLLM so the model can split its work across both machines using a fast direct connection between them. The model itself is very large, more than 150 gigabytes of data, and the README explains it will not fit or run on a single one of these machines because of memory limits. By splitting the work in two, using a compressed numeric format called NVFP4 to shrink memory use, and adding custom code to handle how the model processes attention and routes requests between its many internal expert components, this project makes it possible to actually run the model and serve responses to users. The repository comes with setup scripts to install and start the two machines in the correct order, since one machine must be ready before the other connects to it. It also includes a live dashboard, a small tool with no extra dependencies, that shows real time statistics like how fast the model is generating text, memory and power use, temperature, and the status of each machine while it runs. The README documents specific benchmark results comparing this version against an earlier one, showing double digit percentage speed gains in most tests. It notes the exact software versions and hardware configuration used so results can be reproduced, and includes scripts to rerun the same benchmarks. This is not a beginner tool. It assumes access to expensive specialized hardware and existing familiarity with running large AI models, and the model weights themselves are not included, only licensed separately. Repository code is released under the MIT license, while some files adapted from the underlying vLLM project remain under the Apache 2.0 license.

Yoink these prompts

Prompt 1
Walk me through running install.sh with the worker and head roles from this repo on two DGX Spark nodes.
Prompt 2
Explain what the nvfp4_ds_mla KV cache format in this repo does and why it is needed for DeepSeek V4 Flash.
Prompt 3
Help me set up and read the live dashboard described in docs/dashboard.md in this project.
Prompt 4
Show me how to run benchmark_prefill.py and compare_prefill.py from this repo to test prefill performance.

Frequently asked questions

wtf is dspark-vllm-gx10?

A technical adaptation that lets the large DeepSeek V4 Flash AI model run split across two connected DGX Spark or ASUS GX10 machines, with faster performance and a live monitoring dashboard.

What language is dspark-vllm-gx10 written in?

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

What license does dspark-vllm-gx10 use?

The project's own code, such as the dashboard, deployment scripts, and docs, is MIT licensed and free to use and modify. Files adapted from vLLM remain under the Apache 2.0 license, which is also permissive but requires keeping attribution notices.

How hard is dspark-vllm-gx10 to set up?

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

Who is dspark-vllm-gx10 for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

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