Text Generation
GGUF
llama.cpp
deepseek
deepseek-v4
mixture-of-experts
imatrix
single-gpu
rtx-pro-6000
blackwell
96gb
speculative-decoding
tool-use
reasoning
conversational
Instructions to use prometheusAIR/DeepSeek-V4-Flash-0731-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use prometheusAIR/DeepSeek-V4-Flash-0731-GGUF with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K # Run inference directly in the terminal: llama cli -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K # Run inference directly in the terminal: llama cli -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K # Run inference directly in the terminal: ./llama-cli -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K # Run inference directly in the terminal: ./build/bin/llama-cli -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
Use Docker
docker model run hf.co/prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
- LM Studio
- Jan
- vLLM
How to use prometheusAIR/DeepSeek-V4-Flash-0731-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "prometheusAIR/DeepSeek-V4-Flash-0731-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "prometheusAIR/DeepSeek-V4-Flash-0731-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
- Ollama
How to use prometheusAIR/DeepSeek-V4-Flash-0731-GGUF with Ollama:
ollama run hf.co/prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
- Unsloth Studio
How to use prometheusAIR/DeepSeek-V4-Flash-0731-GGUF with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for prometheusAIR/DeepSeek-V4-Flash-0731-GGUF to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for prometheusAIR/DeepSeek-V4-Flash-0731-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for prometheusAIR/DeepSeek-V4-Flash-0731-GGUF to start chatting
- Pi
How to use prometheusAIR/DeepSeek-V4-Flash-0731-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use prometheusAIR/DeepSeek-V4-Flash-0731-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use prometheusAIR/DeepSeek-V4-Flash-0731-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
- Docker Model Runner
How to use prometheusAIR/DeepSeek-V4-Flash-0731-GGUF with Docker Model Runner:
docker model run hf.co/prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
- Lemonade
How to use prometheusAIR/DeepSeek-V4-Flash-0731-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull prometheusAIR/DeepSeek-V4-Flash-0731-GGUF:Q2_K
Run and chat with the model
lemonade run user.DeepSeek-V4-Flash-0731-GGUF-Q2_K
List all available models
lemonade list
Upload 6 files
Browse files
.gitattributes
CHANGED
|
@@ -37,3 +37,7 @@ DeepSeek-V4-Flash-0731-IQ2_XS-00001-of-00004.gguf filter=lfs diff=lfs merge=lfs
|
|
| 37 |
DeepSeek-V4-Flash-0731-IQ2_XS-00002-of-00004.gguf filter=lfs diff=lfs merge=lfs -text
|
| 38 |
DeepSeek-V4-Flash-0731-IQ2_XS-00003-of-00004.gguf filter=lfs diff=lfs merge=lfs -text
|
| 39 |
DeepSeek-V4-Flash-0731-IQ2_XS-00004-of-00004.gguf filter=lfs diff=lfs merge=lfs -text
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 37 |
DeepSeek-V4-Flash-0731-IQ2_XS-00002-of-00004.gguf filter=lfs diff=lfs merge=lfs -text
|
| 38 |
DeepSeek-V4-Flash-0731-IQ2_XS-00003-of-00004.gguf filter=lfs diff=lfs merge=lfs -text
|
| 39 |
DeepSeek-V4-Flash-0731-IQ2_XS-00004-of-00004.gguf filter=lfs diff=lfs merge=lfs -text
|
| 40 |
+
DeepSeek-V4-Flash-0731-IQ2_XXS-00001-of-00004.gguf filter=lfs diff=lfs merge=lfs -text
|
| 41 |
+
DeepSeek-V4-Flash-0731-IQ2_XXS-00002-of-00004.gguf filter=lfs diff=lfs merge=lfs -text
|
| 42 |
+
DeepSeek-V4-Flash-0731-IQ2_XXS-00003-of-00004.gguf filter=lfs diff=lfs merge=lfs -text
|
| 43 |
+
DeepSeek-V4-Flash-0731-IQ2_XXS-00004-of-00004.gguf filter=lfs diff=lfs merge=lfs -text
|
DeepSeek-V4-Flash-0731-IQ2_XXS-00001-of-00004.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:0b220f41ed3260c709adaab5bd6c9d60f65055d9dc2a5d9522abff081f68163f
|
| 3 |
+
size 27579534528
|
DeepSeek-V4-Flash-0731-IQ2_XXS-00002-of-00004.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:4bba1123d7eabeff65386efed047f8dff6c3c3a0ce223aae2fef4b3739070d2e
|
| 3 |
+
size 27833404672
|
DeepSeek-V4-Flash-0731-IQ2_XXS-00003-of-00004.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:fefe6269b82105de55d2b2f16c2988f1501912c9a2b2c7f64ff86360989e5884
|
| 3 |
+
size 27564969216
|
DeepSeek-V4-Flash-0731-IQ2_XXS-00004-of-00004.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:5b1d48df2dcc3944394424c89e531179375960bcdbbdea882711421e57df9ed0
|
| 3 |
+
size 6305127904
|
README.md
CHANGED
|
@@ -22,27 +22,30 @@ quantized_by: prometheusAIR
|
|
| 22 |
|
| 23 |
# DeepSeek-V4-Flash-0731 GGUF — fits one RTX PRO 6000 96GB
|
| 24 |
|
| 25 |
-
|
| 26 |
-
[deepseek-ai/DeepSeek-V4-Flash-0731](https://huggingface.co/deepseek-ai/DeepSeek-V4-Flash-0731)
|
| 27 |
-
sized so that **every tensor lives on a single NVIDIA RTX PRO 6000
|
| 28 |
-
96GB GPU** — no CPU expert offload, no second card, no layer spill.
|
| 29 |
|
| 30 |
-
**89.9 GiB
|
|
|
|
|
|
|
|
|
|
| 31 |
|
| 32 |
## At a glance
|
| 33 |
|
| 34 |
-
| | |
|
| 35 |
-
|---|---|
|
| 36 |
-
|
|
| 37 |
-
|
|
| 38 |
-
|
|
| 39 |
-
|
|
| 40 |
-
|
|
| 41 |
-
|
|
| 42 |
-
|
|
| 43 |
-
|
|
| 44 |
-
|
|
| 45 |
-
| License | MIT
|
| 46 |
|
| 47 |
## Will this run on my GPU?
|
| 48 |
|
|
@@ -51,10 +54,20 @@ sized so that **every tensor lives on a single NVIDIA RTX PRO 6000 Blackwell
|
|
| 51 |
| RTX PRO 6000 Blackwell 96GB (Workstation Edition) | Yes — this is the tested configuration |
|
| 52 |
| Two smaller cards totalling ≥ 96 GB | Should work with `--split-mode layer`. Untested here |
|
| 53 |
| One card under 96 GB | Needs `-ncmoe N` to push expert layers to CPU, which costs a lot of speed. Untested here |
|
| 54 |
-
| A 96 GB card of another architecture | Requires working `IQ2_XS` / `IQ3_XXS`
|
| 55 |
|
| 56 |
Leave roughly 2–3 GB of the card free for your display/compositor if the GPU
|
| 57 |
-
is also driving a monitor
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 58 |
|
| 59 |
## Quick start
|
| 60 |
|
|
@@ -88,6 +101,23 @@ CUDA_VISIBLE_DEVICES=0 llama-server \
|
|
| 88 |
|
| 89 |
Do not use ubatch 2,048 at 384K on a 96 GB card — see the table below.
|
| 90 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 91 |
## Measured VRAM
|
| 92 |
|
| 93 |
Measured on a card reporting 97,887 MiB total, CUDA device 0 only, one slot,
|
|
@@ -111,14 +141,32 @@ where the wall is; it is not a deployment recommendation. Driver version,
|
|
| 111 |
display usage, CUDA version and llama.cpp revision all shift these numbers, so
|
| 112 |
treat them as a starting point and verify on your own card.
|
| 113 |
|
| 114 |
-
These are allocation and generation checks
|
| 115 |
-
|
| 116 |
-
|
| 117 |
-
|
| 118 |
-
|
| 119 |
-
|
| 120 |
-
|
| 121 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 122 |
|
| 123 |
## Reasoning, tools, and the empty-response trap
|
| 124 |
|
|
@@ -171,35 +219,50 @@ agentic use. Tool calls and tool-result continuation were both validated here.
|
|
| 171 |
## Requirements
|
| 172 |
|
| 173 |
- A CUDA llama.cpp build with DeepSeek-V4 support and working SM 12.0 kernels
|
| 174 |
-
for `IQ2_XS`, `IQ3_XXS` and `Q8_0`. Validated on
|
|
|
|
| 175 |
- `--jinja`, so the embedded chat template is used.
|
| 176 |
|
| 177 |
Older builds may not know the architecture, its metadata, or the template.
|
| 178 |
|
| 179 |
## What's in the file
|
| 180 |
|
|
|
|
|
|
|
| 181 |
| Tensor group | Count | Type |
|
| 182 |
|---|---:|---|
|
| 183 |
| Routed expert gate/up | 86 | `IQ2_XS` |
|
| 184 |
| Routed expert down | 43 | `IQ3_XXS` |
|
| 185 |
| Dense matrices, embedding, output | 661 | `Q8_0` |
|
| 186 |
-
| Routers | 43 | `BF16`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 187 |
| Norms, biases, tables | 492 | `F32` |
|
| 188 |
| Routing/index tables | 3 | `I32` |
|
| 189 |
| **Total** | **1,328** | |
|
| 190 |
|
| 191 |
Routed experts dominate this checkpoint's storage, so quantizing only the dense
|
| 192 |
-
layers cannot reach 96 GB.
|
| 193 |
-
|
| 194 |
-
|
| 195 |
|
| 196 |
-
> **Note on the displayed quant type.**
|
| 197 |
-
> `general.file_type
|
| 198 |
-
> `
|
| 199 |
-
>
|
| 200 |
-
> therefore label this file "Q8_0". The table above is what is actually in it.
|
| 201 |
|
| 202 |
-
**No `IQ1_S`, `IQ2_S` or `IQ3_S` tensors are present.** Those three types have
|
| 203 |
broken CUDA kernels on SM 12.0, which silently poisons many otherwise-plausible
|
| 204 |
sub-4-bit quants on Blackwell. All 43 layers, the release compression-ratio
|
| 205 |
metadata, and the validated 0731 chat template are intact.
|
|
@@ -224,6 +287,14 @@ official 0731 encoding fixtures. Processed as 160 chunks × 2,048 tokens into 76
|
|
| 224 |
imatrix entries; lowest final sparse routed-expert coverage 99.61%. Corpus
|
| 225 |
SHA-256 `401ea959421622e148d062d4c9719d4c31027f4af1ee10ebff0525e4bb0a13ea`.
|
| 226 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 227 |
The embedded Jinja template was validated byte-for-byte against the official
|
| 228 |
0731 encoder fixtures, including tool calls and tool-result continuation.
|
| 229 |
|
|
@@ -237,11 +308,19 @@ Focused smoke tests, run against both this quant and the fidelity master:
|
|
| 237 |
- DSML tool call plus tool-result continuation
|
| 238 |
- a generated Python `merge_intervals`, passing 4/4 executable cases
|
| 239 |
|
| 240 |
-
Decode clustered at
|
| 241 |
-
was a 21-token generation where fixed
|
| 242 |
-
for the partially-offloaded fidelity
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 243 |
|
| 244 |
-
**
|
| 245 |
of quality parity with the released checkpoint.**
|
| 246 |
|
| 247 |
## Limitations
|
|
@@ -249,8 +328,13 @@ of quality parity with the released checkpoint.**
|
|
| 249 |
- Low-bit expert quantization can change reasoning, coding, factuality, routing
|
| 250 |
and tool behaviour in ways short smoke tests will not surface. Evaluate on
|
| 251 |
your own workload before relying on it.
|
| 252 |
-
-
|
| 253 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 254 |
- No DSpark speculative draft stages.
|
| 255 |
- No guarantees for other GPUs or other llama.cpp revisions.
|
| 256 |
|
|
@@ -260,6 +344,8 @@ appropriate to your application.
|
|
| 260 |
|
| 261 |
## Files
|
| 262 |
|
|
|
|
|
|
|
| 263 |
| File | Size | SHA-256 |
|
| 264 |
|---|---:|---|
|
| 265 |
| `DeepSeek-V4-Flash-0731-IQ2_XS-00001-of-00004.gguf` | 27.50 GiB | `b09025603eb0192bb5dae42084c096427813658f5be0b7ec19341a96b3ce7e20` |
|
|
@@ -267,6 +353,15 @@ appropriate to your application.
|
|
| 267 |
| `DeepSeek-V4-Flash-0731-IQ2_XS-00003-of-00004.gguf` | 27.48 GiB | `8c7dd99da2d54f39660659d8c401811149bf341c307fedb30a19f510299e2495` |
|
| 268 |
| `DeepSeek-V4-Flash-0731-IQ2_XS-00004-of-00004.gguf` | 7.27 GiB | `eb0cccbdf4b94ecf42d408b2d03b5a0bb3d706a6f0ca0f63ac0256f947a08f94` |
|
| 269 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 270 |
```bash
|
| 271 |
sha256sum -c SHA256SUMS
|
| 272 |
```
|
|
|
|
| 22 |
|
| 23 |
# DeepSeek-V4-Flash-0731 GGUF — fits one RTX PRO 6000 96GB
|
| 24 |
|
| 25 |
+
Two imatrix-guided GGUF variants of
|
| 26 |
+
[deepseek-ai/DeepSeek-V4-Flash-0731](https://huggingface.co/deepseek-ai/DeepSeek-V4-Flash-0731),
|
| 27 |
+
both sized so that **every tensor lives on a single NVIDIA RTX PRO 6000
|
| 28 |
+
Blackwell 96GB GPU** — no CPU expert offload, no second card, no layer spill.
|
| 29 |
|
| 30 |
+
- **IQ2_XS quality-first:** 89.9 GiB, approximately 75 tok/s short decode, up to
|
| 31 |
+
384K context with a practical margin.
|
| 32 |
+
- **IQ2_XXS full-context:** 83.15 GiB, the complete 1,048,576-token context,
|
| 33 |
+
validated with exact retrieval from a 989,987-token prompt.
|
| 34 |
|
| 35 |
## At a glance
|
| 36 |
|
| 37 |
+
| | IQ2_XS quality-first | IQ2_XXS full-context |
|
| 38 |
+
|---|---|---|
|
| 39 |
+
| Size | 96,556,502,624 bytes / 89.925 GiB | 89,283,036,320 bytes / 83.151 GiB |
|
| 40 |
+
| Expert gate/up | `IQ2_XS` | `IQ2_XXS` |
|
| 41 |
+
| Expert down | `IQ3_XXS` | `IQ3_XXS` |
|
| 42 |
+
| Dense path | `Q8_0` | `Q6_K` |
|
| 43 |
+
| Embedding/output | `Q8_0` | `Q8_0` |
|
| 44 |
+
| Calibration processed | 327,680 tokens at 2K context | 606,208 tokens at 8K context; 100% final expert-slice coverage |
|
| 45 |
+
| Recommended context | 64K default; 384K high-context | Full 1,048,576 tokens |
|
| 46 |
+
| CPU/second-GPU offload | none | none |
|
| 47 |
+
| DSpark/MTP draft stages | excluded | excluded |
|
| 48 |
+
| License | MIT | MIT |
|
| 49 |
|
| 50 |
## Will this run on my GPU?
|
| 51 |
|
|
|
|
| 54 |
| RTX PRO 6000 Blackwell 96GB (Workstation Edition) | Yes — this is the tested configuration |
|
| 55 |
| Two smaller cards totalling ≥ 96 GB | Should work with `--split-mode layer`. Untested here |
|
| 56 |
| One card under 96 GB | Needs `-ncmoe N` to push expert layers to CPU, which costs a lot of speed. Untested here |
|
| 57 |
+
| A 96 GB card of another architecture | Requires working `IQ2_XS` / `IQ2_XXS` / `IQ3_XXS` / `Q6_K` kernels as applicable. Untested here |
|
| 58 |
|
| 59 |
Leave roughly 2–3 GB of the card free for your display/compositor if the GPU
|
| 60 |
+
is also driving a monitor. The full-context variant left 1,752 MiB in the tested
|
| 61 |
+
headless configuration, so a display workload can make 1M impractical even on
|
| 62 |
+
the same card.
|
| 63 |
+
|
| 64 |
+
### Which variant should I use?
|
| 65 |
+
|
| 66 |
+
- Choose `IQ2_XS` for the stronger weight recipe, approximately 75 tok/s short
|
| 67 |
+
decode, and contexts through the recommended 384K profile.
|
| 68 |
+
- Choose `IQ2_XXS` only when you need more than the `IQ2_XS` artifact can
|
| 69 |
+
allocate. It reaches the full 1M context by lowering gate/up experts and dense
|
| 70 |
+
matrices, and long prompts become much slower to prefill.
|
| 71 |
|
| 72 |
## Quick start
|
| 73 |
|
|
|
|
| 101 |
|
| 102 |
Do not use ubatch 2,048 at 384K on a 96 GB card — see the table below.
|
| 103 |
|
| 104 |
+
### Full 1M profile
|
| 105 |
+
|
| 106 |
+
```bash
|
| 107 |
+
CUDA_VISIBLE_DEVICES=0 llama-server \
|
| 108 |
+
--model DeepSeek-V4-Flash-0731-IQ2_XXS-00001-of-00004.gguf \
|
| 109 |
+
--host 127.0.0.1 --port 8080 \
|
| 110 |
+
--device CUDA0 --split-mode none -ngl 999 --fit off \
|
| 111 |
+
--ctx-size 1048576 \
|
| 112 |
+
-b 2048 -ub 1024 \
|
| 113 |
+
-np 1 -fa on --jinja \
|
| 114 |
+
--reasoning-budget 4096 \
|
| 115 |
+
--reasoning-budget-message "I am out of thinking time. I will now stop deliberating and give my best final answer directly."
|
| 116 |
+
```
|
| 117 |
+
|
| 118 |
+
This profile uses the `IQ2_XXS` shards, not the larger `IQ2_XS` files. Keep
|
| 119 |
+
ubatch at 1,024 and one parallel slot unless you remeasure the entire allocation.
|
| 120 |
+
|
| 121 |
## Measured VRAM
|
| 122 |
|
| 123 |
Measured on a card reporting 97,887 MiB total, CUDA device 0 only, one slot,
|
|
|
|
| 141 |
display usage, CUDA version and llama.cpp revision all shift these numbers, so
|
| 142 |
treat them as a starting point and verify on your own card.
|
| 143 |
|
| 144 |
+
These are allocation and generation checks for the `IQ2_XS` variant. They do
|
| 145 |
+
**not** establish retrieval quality at every listed depth.
|
| 146 |
+
|
| 147 |
+
### IQ2_XXS full-context measurements
|
| 148 |
+
|
| 149 |
+
The full-context artifact loaded at `--ctx-size 1048576`, `-b 2048`,
|
| 150 |
+
`-ub 1024`, and `-np 1`, with every model tensor on CUDA0:
|
| 151 |
+
|
| 152 |
+
| Measurement | Result |
|
| 153 |
+
|---|---:|
|
| 154 |
+
| Total CUDA0 use after startup/warmup | 95,409 MiB |
|
| 155 |
+
| Highest CUDA0 use during tested prefills | 95,537 MiB |
|
| 156 |
+
| Minimum free CUDA0 VRAM | 1,752 MiB |
|
| 157 |
+
| CUDA1 model allocation | zero |
|
| 158 |
+
| 6,010-token retrieval | exact; 1,746 tok/s prefill |
|
| 159 |
+
| 130,999-token retrieval | exact; 1,101 tok/s prefill |
|
| 160 |
+
| 989,987-token retrieval | exact at 97% document depth; 308.56 tok/s average prefill |
|
| 161 |
+
| Near-1M decode | 25.44 tok/s |
|
| 162 |
+
| Near-1M prefill wall time | 3,208.36 seconds / 53.47 minutes |
|
| 163 |
+
|
| 164 |
+
The final test processed 989,987 prompt tokens and 990,079 total tokens, then
|
| 165 |
+
returned `OBSIDIAN-LANTERN-ONE-MILLION` exactly from record 40,000 of 41,248.
|
| 166 |
+
The context allocation did not grow beyond the measured 95,537 MiB peak. This
|
| 167 |
+
proves startup, warmup, meaningful prefill, generation, and retrieval near the
|
| 168 |
+
model's configured limit on the tested runtime; it is not a broad long-context
|
| 169 |
+
benchmark.
|
| 170 |
|
| 171 |
## Reasoning, tools, and the empty-response trap
|
| 172 |
|
|
|
|
| 219 |
## Requirements
|
| 220 |
|
| 221 |
- A CUDA llama.cpp build with DeepSeek-V4 support and working SM 12.0 kernels
|
| 222 |
+
for `IQ2_XS`, `IQ2_XXS`, `IQ3_XXS`, `Q6_K`, and `Q8_0`. Validated on
|
| 223 |
+
build `b10148` (`1476ef0e5`).
|
| 224 |
- `--jinja`, so the embedded chat template is used.
|
| 225 |
|
| 226 |
Older builds may not know the architecture, its metadata, or the template.
|
| 227 |
|
| 228 |
## What's in the file
|
| 229 |
|
| 230 |
+
### IQ2_XS quality-first tensor census
|
| 231 |
+
|
| 232 |
| Tensor group | Count | Type |
|
| 233 |
|---|---:|---|
|
| 234 |
| Routed expert gate/up | 86 | `IQ2_XS` |
|
| 235 |
| Routed expert down | 43 | `IQ3_XXS` |
|
| 236 |
| Dense matrices, embedding, output | 661 | `Q8_0` |
|
| 237 |
+
| Routers | 43 | `BF16` |
|
| 238 |
+
| Norms, biases, tables | 492 | `F32` |
|
| 239 |
+
| Routing/index tables | 3 | `I32` |
|
| 240 |
+
| **Total** | **1,328** | |
|
| 241 |
+
|
| 242 |
+
### IQ2_XXS full-context tensor census
|
| 243 |
+
|
| 244 |
+
| Tensor group | Count | Type |
|
| 245 |
+
|---|---:|---|
|
| 246 |
+
| Routed expert gate/up | 86 | `IQ2_XXS` |
|
| 247 |
+
| Routed expert down | 43 | `IQ3_XXS` |
|
| 248 |
+
| Eligible dense matrices | 659 | `Q6_K` |
|
| 249 |
+
| Token embedding and output | 2 | `Q8_0` |
|
| 250 |
+
| Routers | 43 | `BF16` |
|
| 251 |
| Norms, biases, tables | 492 | `F32` |
|
| 252 |
| Routing/index tables | 3 | `I32` |
|
| 253 |
| **Total** | **1,328** | |
|
| 254 |
|
| 255 |
Routed experts dominate this checkpoint's storage, so quantizing only the dense
|
| 256 |
+
layers cannot reach 96 GB. Both recipes spend more bits on expert down
|
| 257 |
+
projections than gate/up. The full-context variant additionally moves eligible
|
| 258 |
+
dense matrices from Q8_0 to Q6_K while retaining embedding and output at Q8_0.
|
| 259 |
|
| 260 |
+
> **Note on the displayed quant type.** These are per-tensor mixed recipes. The
|
| 261 |
+
> GGUF `general.file_type` records only the base type passed to `llama-quantize`,
|
| 262 |
+
> so Hub viewers may show `Q8_0` for the IQ2_XS files or `Q6_K` for the IQ2_XXS
|
| 263 |
+
> files. The tensor censuses above are authoritative.
|
|
|
|
| 264 |
|
| 265 |
+
**No `IQ1_S`, `IQ2_S`, or `IQ3_S` tensors are present.** Those three types have
|
| 266 |
broken CUDA kernels on SM 12.0, which silently poisons many otherwise-plausible
|
| 267 |
sub-4-bit quants on Blackwell. All 43 layers, the release compression-ratio
|
| 268 |
metadata, and the validated 0731 chat template are intact.
|
|
|
|
| 287 |
imatrix entries; lowest final sparse routed-expert coverage 99.61%. Corpus
|
| 288 |
SHA-256 `401ea959421622e148d062d4c9719d4c31027f4af1ee10ebff0525e4bb0a13ea`.
|
| 289 |
|
| 290 |
+
The `IQ2_XXS` variant used a separate expanded corpus with 613,766 tokenizer
|
| 291 |
+
tokens across 23 sections. `llama-imatrix` processed 74 chunks × 8,192 tokens,
|
| 292 |
+
or 606,208 tokens, into 769 entries. Direct inspection of the final imatrix
|
| 293 |
+
found all 256 slices populated for every routed-expert matrix: 100.00% final
|
| 294 |
+
slice coverage. Corpus SHA-256:
|
| 295 |
+
`0b0503b27680df69a8f40507cb329bc49a0bb3cd8c7f30fa4da1fde9ce8cc3bc`.
|
| 296 |
+
Quantization took 5,323.19 seconds (88.72 minutes) with 12 threads.
|
| 297 |
+
|
| 298 |
The embedded Jinja template was validated byte-for-byte against the official
|
| 299 |
0731 encoder fixtures, including tool calls and tool-result continuation.
|
| 300 |
|
|
|
|
| 308 |
- DSML tool call plus tool-result continuation
|
| 309 |
- a generated Python `merge_intervals`, passing 4/4 executable cases
|
| 310 |
|
| 311 |
+
Decode for the IQ2_XS variant clustered at approximately 75 tok/s (63–77
|
| 312 |
+
across individual tests; the low outlier was a 21-token generation where fixed
|
| 313 |
+
overhead dominates), against 21–26 tok/s for the partially-offloaded fidelity
|
| 314 |
+
master on identical prompts — about 3×.
|
| 315 |
+
|
| 316 |
+
The IQ2_XXS variant passed the same exact-output, arithmetic, executable coding,
|
| 317 |
+
Chinese, DSML tool-call, and tool-continuation checks. High-reasoning arithmetic
|
| 318 |
+
and coding hit an old 768-token smoke cap before emitting content, but both
|
| 319 |
+
completed correctly with the documented 4,096-token budget. Its generated
|
| 320 |
+
`merge_intervals` passed 4/4 executable cases. Retrieval was exact at 6K, 131K,
|
| 321 |
+
and 989,987 prompt tokens; the near-1M needle was at 97% document depth.
|
| 322 |
|
| 323 |
+
**These are implementation smoke tests, not a benchmark suite, and not evidence
|
| 324 |
of quality parity with the released checkpoint.**
|
| 325 |
|
| 326 |
## Limitations
|
|
|
|
| 328 |
- Low-bit expert quantization can change reasoning, coding, factuality, routing
|
| 329 |
and tool behaviour in ways short smoke tests will not surface. Evaluate on
|
| 330 |
your own workload before relying on it.
|
| 331 |
+
- The near-1M check is a single synthetic needle test, not evidence of broad
|
| 332 |
+
million-token reasoning, multi-hop retrieval, or benchmark quality.
|
| 333 |
+
- A near-1M prefill took approximately 53.5 minutes on the tested host.
|
| 334 |
+
- The full-context configuration retained only 1,752 MiB at its measured peak;
|
| 335 |
+
display use and runtime/driver differences can eliminate that margin.
|
| 336 |
+
- High-reasoning requests may consume more than 768 completion tokens before
|
| 337 |
+
emitting final content; provide a realistic `max_tokens` budget.
|
| 338 |
- No DSpark speculative draft stages.
|
| 339 |
- No guarantees for other GPUs or other llama.cpp revisions.
|
| 340 |
|
|
|
|
| 344 |
|
| 345 |
## Files
|
| 346 |
|
| 347 |
+
### IQ2_XS quality-first
|
| 348 |
+
|
| 349 |
| File | Size | SHA-256 |
|
| 350 |
|---|---:|---|
|
| 351 |
| `DeepSeek-V4-Flash-0731-IQ2_XS-00001-of-00004.gguf` | 27.50 GiB | `b09025603eb0192bb5dae42084c096427813658f5be0b7ec19341a96b3ce7e20` |
|
|
|
|
| 353 |
| `DeepSeek-V4-Flash-0731-IQ2_XS-00003-of-00004.gguf` | 27.48 GiB | `8c7dd99da2d54f39660659d8c401811149bf341c307fedb30a19f510299e2495` |
|
| 354 |
| `DeepSeek-V4-Flash-0731-IQ2_XS-00004-of-00004.gguf` | 7.27 GiB | `eb0cccbdf4b94ecf42d408b2d03b5a0bb3d706a6f0ca0f63ac0256f947a08f94` |
|
| 355 |
|
| 356 |
+
### IQ2_XXS full-context
|
| 357 |
+
|
| 358 |
+
| File | Size | SHA-256 |
|
| 359 |
+
|---|---:|---|
|
| 360 |
+
| `DeepSeek-V4-Flash-0731-IQ2_XXS-00001-of-00004.gguf` | 25.685443 GiB | `0b220f41ed3260c709adaab5bd6c9d60f65055d9dc2a5d9522abff081f68163f` |
|
| 361 |
+
| `DeepSeek-V4-Flash-0731-IQ2_XXS-00002-of-00004.gguf` | 25.921878 GiB | `4bba1123d7eabeff65386efed047f8dff6c3c3a0ce223aae2fef4b3739070d2e` |
|
| 362 |
+
| `DeepSeek-V4-Flash-0731-IQ2_XXS-00003-of-00004.gguf` | 25.671878 GiB | `fefe6269b82105de55d2b2f16c2988f1501912c9a2b2c7f64ff86360989e5884` |
|
| 363 |
+
| `DeepSeek-V4-Flash-0731-IQ2_XXS-00004-of-00004.gguf` | 5.872108 GiB | `5b1d48df2dcc3944394424c89e531179375960bcdbbdea882711421e57df9ed0` |
|
| 364 |
+
|
| 365 |
```bash
|
| 366 |
sha256sum -c SHA256SUMS
|
| 367 |
```
|
SHA256SUMS
CHANGED
|
@@ -2,3 +2,7 @@ b09025603eb0192bb5dae42084c096427813658f5be0b7ec19341a96b3ce7e20 DeepSeek-V4-Fl
|
|
| 2 |
faf2467279b673bbcdfea7c8413f762f39973b3a758808ec2d6bbdd008710f5f DeepSeek-V4-Flash-0731-IQ2_XS-00002-of-00004.gguf
|
| 3 |
8c7dd99da2d54f39660659d8c401811149bf341c307fedb30a19f510299e2495 DeepSeek-V4-Flash-0731-IQ2_XS-00003-of-00004.gguf
|
| 4 |
eb0cccbdf4b94ecf42d408b2d03b5a0bb3d706a6f0ca0f63ac0256f947a08f94 DeepSeek-V4-Flash-0731-IQ2_XS-00004-of-00004.gguf
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 2 |
faf2467279b673bbcdfea7c8413f762f39973b3a758808ec2d6bbdd008710f5f DeepSeek-V4-Flash-0731-IQ2_XS-00002-of-00004.gguf
|
| 3 |
8c7dd99da2d54f39660659d8c401811149bf341c307fedb30a19f510299e2495 DeepSeek-V4-Flash-0731-IQ2_XS-00003-of-00004.gguf
|
| 4 |
eb0cccbdf4b94ecf42d408b2d03b5a0bb3d706a6f0ca0f63ac0256f947a08f94 DeepSeek-V4-Flash-0731-IQ2_XS-00004-of-00004.gguf
|
| 5 |
+
0b220f41ed3260c709adaab5bd6c9d60f65055d9dc2a5d9522abff081f68163f DeepSeek-V4-Flash-0731-IQ2_XXS-00001-of-00004.gguf
|
| 6 |
+
4bba1123d7eabeff65386efed047f8dff6c3c3a0ce223aae2fef4b3739070d2e DeepSeek-V4-Flash-0731-IQ2_XXS-00002-of-00004.gguf
|
| 7 |
+
fefe6269b82105de55d2b2f16c2988f1501912c9a2b2c7f64ff86360989e5884 DeepSeek-V4-Flash-0731-IQ2_XXS-00003-of-00004.gguf
|
| 8 |
+
5b1d48df2dcc3944394424c89e531179375960bcdbbdea882711421e57df9ed0 DeepSeek-V4-Flash-0731-IQ2_XXS-00004-of-00004.gguf
|