explaingit

tonyd2wild/hy3-295b-nvfp4-mtp-2x-dgx-spark

Analysis updated 2026-05-18

18ShellAudience · ops devops

TLDR

A documented recipe and benchmark for running Tencent's 295B-parameter Hunyuan 3 AI model efficiently across two NVIDIA DGX Spark machines.

Mindmap

mindmap
  root((repo))
    What it does
      Serves large AI model
      Two GPU machines
      Speed tuning
    Tech stack
      Shell scripts
      vLLM
      Ray
    Use cases
      Multi node serving
      Benchmark recipe
      Bug fixes documented
    Audience
      GPU infra engineers
    Findings
      Eager mode wins
      Spec 1 beats spec 2
      KV memory math

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

What do people build with it?

USE CASE 1

Serve the Hunyuan 3 large language model across two DGX Spark machines with tuned performance settings.

USE CASE 2

Reproduce a benchmarked configuration for speculative decoding on GB10-class GPUs.

USE CASE 3

Avoid known setup bugs when deploying large quantized models across multiple GPU nodes.

USE CASE 4

Use the included scripts as a template for launching similar multi-node model serving setups.

What is it built with?

ShellvLLMRayNCCLDocker

How does it compare?

tonyd2wild/hy3-295b-nvfp4-mtp-2x-dgx-sparkaithink001/codex-dream-skin-themesbaiyuetribe/codes
Stars181818
LanguageShellShellShell
Last pushed2020-02-21
MaintenanceDormant
Setup difficultyeasyeasy
Complexity2/51/5
Audienceops devopsgeneralops devops

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

In plain English

This repository is a detailed recipe for running a very large AI language model, Tencent's Hunyuan 3, on a specific pair of NVIDIA computers called DGX Spark. The model has 295 billion parameters but only activates a smaller portion of them at once, and it has been compressed down in size so it can fit and run efficiently on this particular hardware, using two machines working together over a fast network connection. The README explains that the author got the model running with a speed-boosting technique built into the model itself, which predicts extra words ahead of time to make generation faster. Their key finding is that some of the official recommended settings for this technique actually hurt performance on this specific hardware, while different settings they measured directly worked better, reaching about 21.8 words per second for a single conversation and nearly 60 words per second when six conversations run at once. The repository includes shell scripts to download and place the model weights on both machines, launch the serving software, and verify it is working correctly, along with configuration files for tuning settings like memory usage and context length, meaning how much text the model can consider at once. It also documents, in detail, several specific technical problems the author ran into while setting this up and how each one was solved, so that someone repeating the setup does not have to rediscover the same fixes. This project is aimed squarely at people who already work with serving large AI models on specialized hardware. It assumes familiarity with concepts like GPU memory, model quantization, and distributed serving, and is best understood as a documented, benchmarked configuration rather than a general-purpose application.

Copy-paste prompts

Prompt 1
Walk me through using this repo's launch scripts to serve Hy3-295B on two DGX Spark nodes.
Prompt 2
Explain why this repo recommends num_speculative_tokens set to 1 instead of the official default.
Prompt 3
Help me troubleshoot a distributed vLLM serving error using this repo's documented bring-up bugs.
Prompt 4
Summarize the hardware and memory requirements this repo lists for running Hy3-295B.

Frequently asked questions

What is hy3-295b-nvfp4-mtp-2x-dgx-spark?

A documented recipe and benchmark for running Tencent's 295B-parameter Hunyuan 3 AI model efficiently across two NVIDIA DGX Spark machines.

What language is hy3-295b-nvfp4-mtp-2x-dgx-spark written in?

Mainly Shell. The stack also includes Shell, vLLM, Ray.

Who is hy3-295b-nvfp4-mtp-2x-dgx-spark for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.