tonyd2wild GitHub avatar

DeepSeek-v4-Flash-DSpark-1M-NVFP4-KV-2x-DGX-Spark

tonyd2wild

This repository provides a validated Docker-based deployment recipe for serving a DeepSeek V4 Flash variant on two DGX Spark nodes using vLLM with tensor parallelism, NVFP4 KV cache, and DSpark speculative decoding, achieving up to 1.5M context and ~50-60 tok/s throughput.

Stars

158

7-day growth

No data

Forks

12

Open issues

4

License

MIT

Last updated

2026-07-16

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It delivers one of the first validated multi-node deployments of a 1M+ context model on consumer-grade Blackwell hardware, with comprehensive benchmarks, a patch history that resolves concurrent-serving garbling issues, and detailed tuning knobs for balancing context length and concurrency.

Who it is for

  • Deployment engineers operating two-node DGX Spark clusters
  • Researchers and developers needing long-context LLM serving for agent-based systems
  • System integrators seeking a proven vLLM + DeepSeek recipe with speculative decoding

Use cases

  • Serving a 1M-context model for agent/supervisor fleets
  • Testing and benchmarking speculative decoding performance under varying concurrency
  • Deploying a clean, garble-free chat endpoint for production agent harnesses

Strengths

  • Validated benchmarks showing up to 315 tok/s at high concurrency and 50-60 tok/s single-stream
  • Detailed documentation of both the garble root cause and the five-part fix, proven live under concurrency
  • Transparent explanation of KV cache mechanics enabling safe concurrent use of long contexts
  • Multiple curated config profiles (1M-context, 200K-concurrency, full 1M + moderate concurrency) with clear trade-offs

Considerations

  • The NVFP4 KV cache can collapse into gibberish under heavy agentic context; a fallback to FP8 is recommended when clean output is critical
  • Full 1M context + high concurrency cannot be simultaneously achieved due to KV pool limits
  • The recipe requires specific hardware (two DGX Sparks, RoCE/InfiniBand fabric) and is not trivially portable

README quick start

Quick start

Description

DeepSeek V4 Flash DSpark 1M NVFP4 KV recipe for 2x DGX Spark

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482