whatisgithub

What is vllm-moet?

kacper-daftcode/vllm-moet — explained in plain English

Analysis updated 2026-05-18

433SassAudience · developerComplexity · 5/5Setup · hard

In one sentence

A vLLM patch that shrinks huge AI models so they can run on consumer graphics cards, while recovering most of the lost accuracy.

Mindmap

mindmap
  root((vLLM-Moet))
    What it does
      Compresses model experts
      Recovers precision
      Caches to disk and RAM
    Tech stack
      vLLM
      CUDA
      SASS kernels
    Use cases
      Run huge LLMs locally
      Serve models on consumer GPUs
      Reduce VRAM requirements
    Audience
      ML engineers
      GPU hobbyists
      AI infra researchers

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

Run massive open-weight AI models like GLM 5.2 on consumer graphics cards instead of data center hardware.

USE CASE 2

Serve a large language model with a much smaller memory footprint by compressing its expert layers.

USE CASE 3

Fall back to system RAM or NVMe storage when a model still doesn't fit in graphics card memory.

USE CASE 4

Benchmark decode speed and context window size across different GPU configurations.

What is it built with?

vLLMCUDASASSPython

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires high-end Nvidia Blackwell GPUs, large model checkpoints, and hand-tuned low-level kernels for the specific hardware.

The README does not state a license.

So what is it?

This project is a large patch for vLLM, a popular tool for running AI language models, that makes it possible to run some of the biggest and most capable open AI models on consumer or workstation graphics cards instead of expensive data center hardware. The models it targets, GLM 5.2, DeepSeek V4 Flash, and Kimi K2.7 Code, are normally far too large to fit in the memory of a single gaming or workstation GPU. The way it manages this is by shrinking the size of certain parts of these models, called experts, down to a much smaller two bit format instead of the usual higher precision the model was trained with. Shrinking things this aggressively normally breaks a model's output quality, so the project also includes a system that keeps a smaller set of these experts at a higher precision level and swaps them in when needed, recovering most of the lost quality. When even that is not enough to fit in the graphics card's memory, the project can also store parts of the model in regular computer memory or on a fast storage drive, treating the graphics card like a cache that fetches pieces of the model only as they are needed. On top of this compression system, the project fixes bugs in a specific version of vLLM so it actually works correctly on newer Nvidia graphics card chips, and it adds support for faster response generation and a more efficient way of storing conversation history in memory. The README includes detailed performance numbers for running these massive models across different combinations of graphics cards, showing how many words per second each setup can generate and how much context, meaning how much text, the model can consider at once. This is a specialized project for people who already work with running large AI models and have access to high end but still consumer grade graphics hardware. It includes hand written low level code for the specific graphics chips it supports, so it is not a general purpose tool, it is built for a narrow but technically demanding use case.

Copy-paste prompts

Prompt 1
Explain how the two-bit expert compression in vLLM-Moet works at a high level.
Prompt 2
Walk me through setting up vLLM-Moet to serve DeepSeek-V4-Flash on a single RTX 5090.
Prompt 3
Compare the tiered expert residency options in this project and when I'd use each one.
Prompt 4
Summarize the performance benchmarks for GLM-5.2 across the hardware configurations listed.

Frequently asked questions

What is vllm-moet?

A vLLM patch that shrinks huge AI models so they can run on consumer graphics cards, while recovering most of the lost accuracy.

What language is vllm-moet written in?

Mainly Sass. The stack also includes vLLM, CUDA, SASS.

What license does vllm-moet use?

The README does not state a license.

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 developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.