git404hub

what is vllm-moet fr?

sapid-labs/vllm-moet — explained in plain English

Analysis updated 2026-05-18

17PythonAudience · researcherComplexity · 5/5Setup · hard

tl;dr

A patched vLLM build that compresses a 159B-parameter AI model to run on NVIDIA Blackwell GPUs that normally could not fit it.

vibe map

mindmap
  root((vLLM-Moet))
    What it does
      Runs huge models on Blackwell GPUs
      Compresses model weights
      Fixes broken official vLLM support
      GPU as expert cache
    Tech stack
      Python
      vLLM
      CUDA kernels
      Docker
    Use cases
      Serve DeepSeek-V4-Flash locally
      Run GLM-5.2 across two GPUs
      Research model quantization
    Audience
      ML researchers
      GPU infrastructure engineers

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 make with this?

VIBE 1

Run the 159B-parameter DeepSeek-V4-Flash model locally on a single high-end consumer GPU.

VIBE 2

Serve the GLM-5.2 model across two GPUs using the same compression technique.

VIBE 3

Study how 2-bit weight compression with FP4 recovery preserves model quality.

VIBE 4

Build a Docker image with the patched vLLM to serve large models on Blackwell hardware.

what's the stack?

PythonvLLMCUDADocker

how it stacks up fr

sapid-labs/vllm-moet0petru/sentimoalingalingling/akasha-wechat
Stars171717
LanguagePythonPythonPython
Setup difficultyhardmoderatehard
Complexity5/53/54/5
Audienceresearcherdeveloperdeveloper

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

how do i run it?

Difficulty · hard time til it works · 1day+

Requires NVIDIA Blackwell GPUs, Docker, and large model checkpoint downloads to get running.

in plain english

This project is a patched version of vLLM, a popular tool for running large language models, aimed at making a very large AI model called DeepSeek-V4-Flash work on NVIDIA's newer Blackwell graphics cards. According to the README, the official vLLM release is broken for this model on this hardware, so the maintainers wrote a large patch, over 5,600 lines, to fix it and also to shrink the model so it fits on cards that would otherwise not have enough memory. DeepSeek-V4-Flash is a 159 billion parameter model, and the trick used here is compressing most of its internal building blocks down to 2 bits instead of the usual higher precision, while keeping accuracy close to a 4-bit version through a recovery technique. The README explains that a naive version of this compression breaks the model, producing repetitive nonsense, and traces the cause to an imbalance in how positive and negative values were represented. Fixing that imbalance restores quality while keeping the smaller size. The README reports specific performance numbers on different graphics card setups, including running the full 159 billion parameter model on a single high-end consumer card by treating the GPU's memory as a cache for the most frequently used parts of the model, while the bulk of the compressed model sits in regular system memory. It also describes applying the same technique to an even larger model, GLM-5.2, across two cards. The repository includes hand-written low-level GPU kernels, a Docker build for quick setup, and a runbook document referenced for a specific hardware variant, alongside detailed documentation of the underlying fixes to the base vLLM release. This is deeply technical, research-grade software intended for people already comfortable running large AI models on specialized hardware, rather than a beginner tool.

prompts (copy fr)

prompt 1
Explain how the sign-symmetric codebook fix in this repo prevents 2-bit compression from breaking the model.
prompt 2
Walk me through building and running the Dockerfile.sm120-v024 image to serve DeepSeek-V4-Flash.
prompt 3
Help me understand the confidence gate that re-runs low-confidence tokens at higher precision.
prompt 4
Show me how the GPU-as-expert-cache approach lets a 32GB card serve a model much larger than its memory.

Frequently asked questions

what is vllm-moet fr?

A patched vLLM build that compresses a 159B-parameter AI model to run on NVIDIA Blackwell GPUs that normally could not fit it.

What language is vllm-moet written in?

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

How hard is vllm-moet to set up?

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

Who is vllm-moet for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.