git404hub

what is llm-dequant fr?

vcruz305/llm-dequant — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A command line tool that converts compressed NVFP4 AI model checkpoints back into standard dense files, using constant memory even for huge models.

vibe map

mindmap
  root((llm-dequant))
    What it does
      Decompresses NVFP4 models
      Streams to constant memory
      Verifies exact output
    Tech stack
      Python
      PyTorch
      Safetensors
    Use cases
      Convert model to GGUF
      Fine-tune a compressed release
      Verify checkpoint math
    Audience
      ML engineers
      Model 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 make with this?

VIBE 1

Convert an NVFP4-only model release into a standard checkpoint you can fine-tune.

VIBE 2

Prepare a compressed model for conversion into GGUF format for llama.cpp.

VIBE 3

Verify a checkpoint's math round-trips exactly before committing to a large conversion.

VIBE 4

Do weight surgery, like merging or pruning, on a model that was only released compressed.

what's the stack?

PythonPyTorchSafetensorsNumPy

how it stacks up fr

vcruz305/llm-dequant0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires torch, safetensors, and numpy, large models need substantial disk space for the converted output.

Use freely, including for commercial purposes, as long as you keep the copyright and license notices.

in plain english

llm-dequant is a command line tool that converts AI language model files from a heavily compressed format called NVFP4 back into a standard, dense file format that most other tools can read. Some newly released models are only published in this compressed NVFP4 form, which locks them out of much of the surrounding ecosystem: tools that convert models to other formats cannot read it, fine-tuning frameworks expect uncompressed weights, and any kind of manual editing of a model's internal numbers needs those uncompressed weights too. The usual way to undo this compression loads the entire model into memory at once, which does not work for very large models with hundreds of billions of parameters. llm-dequant solves this by processing the model piece by piece rather than all at once, so memory use stays low and roughly constant no matter how large the model is. The tool converts to a bit-for-bit exact reproduction of what the reference decompression method would produce, and its output looks like a normal, standard model checkpoint, with the compression specific metadata removed and the tokenizer files copied over unchanged. It depends on only a small number of libraries and has no dependency on the specific compression library that created the file in the first place. The tool includes a verification command that samples parts of the actual checkpoint you plan to convert, runs the math forward and backward, and checks that the result matches byte for byte before you commit to a conversion that could take a long time and use a lot of disk space on a very large model. It also has a test suite that checks its work against hand computed examples and the original reference implementation, and it deliberately refuses to run rather than silently produce a wrong result if it encounters an unexpected file format, suspicious file paths, or invalid numeric values. Installation is a normal Python package install, and the typical flow is to inspect a checkpoint, verify that the math checks out, then run the conversion, after which the output can be fed into other standard tools such as scripts that build GGUF files for use with llama.cpp. The project only supports one specific compression variant, the one currently produced by the llm-compressor project, and it explicitly does not attempt to support other compressed formats. It is released under the Apache 2.0 license.

prompts (copy fr)

prompt 1
Help me install llm-dequant and run it on my NVFP4 model checkpoint.
prompt 2
Walk me through using llm-dequant's verify command before converting a large model checkpoint.
prompt 3
Explain what llm-dequant's inspect command tells me about a compressed checkpoint.
prompt 4
Show me how to feed llm-dequant's converted output into llama.cpp's GGUF conversion script.

Frequently asked questions

what is llm-dequant fr?

A command line tool that converts compressed NVFP4 AI model checkpoints back into standard dense files, using constant memory even for huge models.

What language is llm-dequant written in?

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

What license does llm-dequant use?

Use freely, including for commercial purposes, as long as you keep the copyright and license notices.

How hard is llm-dequant to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is llm-dequant for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.