Maintained by DeepSeek fans
Current API: deepseek-v4-flash
Last corpus check: 01 Aug 2026

Field note / deepseek v4 flash gguf

How to Run DeepSeek V4 Flash Locally with GGUF

Run DeepSeek V4 Flash on your own machine with Unsloth GGUF builds: pick the right file for your RAM, install in one command, and start chatting.

Verification record

Checked
01 Aug 2026
Reading time
8 min
Release state
Public beta
Native API input
Text only

Yes, you can run DeepSeek V4 Flash on your own computer, and the whole path is three steps: pick the GGUF file that fits your memory, install one tool, run one command. The files come from Unsloth's GGUF builds on Hugging Face - downloaded about 129,000 times in the last month alone - and the official Unsloth DeepSeek-V4 guide documents every command we use below. This page walks through it in plain language for a first-time local user.

What You Need Before You Start

You need exactly two things: enough memory for the file you choose, and one of three free tools (Unsloth Studio, llama.cpp, or Ollama). No account, no API key, no payment - the weights are MIT-licensed and free to download.

The three-step overview

Step 1: choose a quantization (a compressed version of the model) sized for your machine - options run from 82.5 GB up to 162 GB. Step 2: install a runner; the fastest route is Unsloth Studio's one-line installer, and llama.cpp or Ollama work just as well. Step 3: run the one-line launch command and start chatting. Everything below is just detail on those three steps, plus the settings that make output quality match the hosted API as closely as possible.

How much memory you need

Total memory (RAM plus VRAM, or unified memory on a Mac) decides your quantization, and the Unsloth guide publishes concrete tiers: roughly 110-135 GB of memory for the 3-bit builds, about 162 GB for 4-bit, and about 169 GB for the lossless Q8 build - figures that already include working headroom beyond the file itself. A 128 GB Mac Studio or a workstation with 128 GB RAM plus a GPU is a genuinely comfortable machine for the 3-bit tier; 192 GB-class machines run 4-bit and up. If you have less, the 1-bit and 2-bit builds (82.5-96.8 GB files) are the entry point. Remember DeepSeek V4 Flash is a 284B-parameter mixture-of-experts model with only 13B active per token - that MoE design is exactly why a model this capable runs on desk-size hardware at all.

Step 1: Pick Your GGUF File

All sizes live in one place: unsloth/DeepSeek-V4-Flash-GGUF. You do not download the whole repository - you pick one quantization and the tools fetch just that.

The full size menu

As of 2026-08-01 the repository offers, from smallest to largest: UD-IQ1_S (82.5 GB) and UD-IQ1_M (86.9 GB) at 1-bit; UD-IQ2_XXS and UD-IQ2_M (90.9 GB) and UD-Q2_K_XL (96.8 GB) at 2-bit; UD-IQ3_XXS (103 GB), UD-IQ3_S (117 GB), UD-Q3_K_M and UD-Q3_K_XL (129 GB) at 3-bit; UD-IQ4_XS and UD-IQ4_NL (138 GB) and UD-Q4_K_XL (155 GB) at 4-bit; and UD-Q8_K_XL (162 GB) at 8-bit. These are Unsloth Dynamic builds - the layers that matter most for quality are kept at higher precision, which is why even the small builds stay usable.

Our pick for most machines

Simple rule: take the largest build that fits your memory tier. On a 128 GB machine, Unsloth's own recommendation is UD-IQ3_XXS (103 GB) - the best-results pick for that class. With 192 GB or more, take UD-Q4_K_XL (155 GB); Unsloth's quality testing shows it lands close to full precision. With around 170 GB and up and a preference for maximum fidelity, UD-Q8_K_XL (162 GB) is reported by Unsloth to match the original weights' quality - it is only 7 GB bigger than Q4, which is why enthusiasts jump straight to it. Under 100 GB, start with a 1-bit or 2-bit build and treat it as your test drive before deciding whether the model earns a hardware upgrade.

Step 2: Install a Runner

Three good options, all free. If you have never run a local model, use Unsloth Studio. If you are comfortable in a terminal, llama.cpp gives the most control. If you already use Ollama, stay in Ollama.

Easiest: Unsloth Studio in one command

On macOS, Linux, or Windows WSL, paste one line into a terminal:

curl -fsSL https://unsloth.ai/install.sh | sh

On Windows PowerShell:

irm https://unsloth.ai/install.ps1 | iex

Then launch it with unsloth studio -H 0.0.0.0 -p 8888 and open http://127.0.0.1:8888 in your browser. Studio gives you a chat interface, handles model downloads for you, and applies sensible defaults - the shortest path from zero to first reply.

The classic: llama.cpp

Current llama.cpp supports the V4 Flash architecture out of the box - support was merged upstream on June 29, 2026 (PR #24162) with a follow-up KV-cache fix on July 7 (PR #25202) - so a normal install just works. Build it per the Unsloth guide:

git clone https://github.com/ggml-org/llama.cpp
cmake llama.cpp -B llama.cpp/build -DBUILD_SHARED_LIBS=OFF -DGGML_CUDA=ON
cmake --build llama.cpp/build --config Release -j --target llama-cli

(Leave off -DGGML_CUDA=ON on a Mac; Metal is used automatically.)

Already on Ollama?

Ollama pulls Unsloth GGUFs directly from Hugging Face with one line - no Modelfile needed. Note that this local pull is different from Ollama's deepseek-v4-flash:cloud catalog entry, which runs on Ollama's servers; the command in the next section keeps everything on your machine.

Step 3: Run It

One command downloads your chosen quantization and starts serving. Swap UD-Q4_K_XL for the build you picked in Step 1.

The one-line launch commands

llama.cpp:

llama serve -hf unsloth/DeepSeek-V4-Flash-GGUF:UD-Q4_K_XL

Ollama:

ollama run hf.co/unsloth/DeepSeek-V4-Flash-GGUF:UD-Q4_K_XL

Both fetch the files on first run (grab a coffee - it is an 80-160 GB download) and cache them locally afterward. For a manual download you can script and resume, use hf download unsloth/DeepSeek-V4-Flash-GGUF --local-dir DeepSeek-V4-Flash-GGUF --include "*UD-Q4_K_XL*", then point llama-cli --model at the first .gguf part.

Settings that match the model's design

Use the sampling settings Unsloth and DeepSeek recommend: --temp 1.0 --top-p 1.0 --min-p 0.0 (drop top-p to 0.95 for agentic tool-calling work). Thinking mode defaults to on at high effort; for long "Think Max"-style sessions, give the model room by setting the context window to at least 384K tokens if your memory allows. To turn thinking off for quick answers, pass --chat-template-kwargs '{"enable_thinking":false}'. How context size interacts with memory is covered in our context window guide.

Check that it works

Ask it something you know the answer to, then ask it to write a small function. First-token latency on MoE models is short relative to their total size because only 13B parameters are active per token - if generation runs, you are done. For a sense of what the model is strong at, our benchmark breakdown covers the agent-task results that made this release notable.

Preview and 0731 Builds

DeepSeek released the updated 0731 checkpoint on July 31 - here is how to choose between the two Unsloth repositories today, and it is an easy choice.

Which repository to download today

The main repository, unsloth/DeepSeek-V4-Flash-GGUF, has the complete size menu above and is the right starting point when you want a build matched to your exact memory budget. The newer unsloth/DeepSeek-V4-Flash-0731-GGUF tracks the 0731 release - Unsloth shipped Q4 and Q8 there within hours of launch and is rolling out the rest of the lineup. If your machine handles 155 GB and up, go straight to the 0731 repo's UD-Q4_K_XL or UD-Q8_K_XL for the newest checkpoint; if you need a smaller build, start on the main repository today and switch when your size lands in the 0731 repo.

Switching later is cheap

A switch is just re-running the same launch command with the other repository name - your runner, settings, and workflow all stay identical. Watch the Unsloth guide for the rollout announcement; it is updated in place as new quantizations land.

Troubleshooting First Runs

Three issues cover almost every first-run problem, and all three have quick fixes.

It does not fit in memory

Drop one quantization tier and rerun the same command - that is the whole fix. The gap between tiers is 10-30 GB, so one step down usually clears it. Also close memory-heavy apps and, in llama.cpp, reduce the context size flag before reducing the quant: a large context reserves memory beyond the file size, and most tasks need far less than the maximum.

It runs but slowly

Speed scales with how much of the model sits on fast memory. On Macs, unified memory handles this automatically. On PCs, raise --n-gpu-layers to push more layers onto the GPU, and prefer the IQ-series quants (like UD-IQ3_XXS) when VRAM is tight. MoE models generate faster than their total size suggests - if you are getting under a few tokens per second on a machine that fits the file comfortably, a flag is usually misconfigured, and the Unsloth guide lists the current recommended set.

Output looks strange

Make sure llama.cpp is current (the July 7 KV-cache fix matters), keep temperature at 1.0 rather than the 0.7 habit from other models, and re-download the file if a resumed download was interrupted. If the model rambles, remember thinking mode is on by default - disable it with the flag above for terse answers.

DeepSeek V4 Flash GGUF FAQ

Where do I download DeepSeek V4 Flash GGUF?

From unsloth/DeepSeek-V4-Flash-GGUF on Hugging Face, which offers every size from 82.5 GB to 162 GB, with the newest-checkpoint builds arriving in unsloth/DeepSeek-V4-Flash-0731-GGUF. The one-line commands above download the right files automatically.

Which quantization should I choose?

The largest one that fits your total memory: UD-IQ3_XXS (103 GB) for 128 GB machines, UD-Q4_K_XL (155 GB) for 192 GB machines, UD-Q8_K_XL (162 GB, effectively lossless per Unsloth's testing) if you have about 170 GB or more, and the 1-2-bit builds (82.5-96.8 GB) to get started below that.

Can I run it on a 128 GB Mac?

Yes - that is the sweet-spot machine for the 3-bit tier. Unsloth specifically recommends UD-IQ3_XXS (103 GB) for best results on 128 GB devices; unified memory means no GPU-offload tuning is needed.

Do I need a GPU?

No. A GPU speeds things up on PCs, but CPU-plus-RAM setups and Apple unified memory both work; the runner splits work automatically. What matters is total memory, not GPU brand.

Is it free to use?

Yes. The weights are MIT-licensed, the GGUF builds are free downloads, and llama.cpp, Ollama, and Unsloth Studio are free tools. Running locally has no per-token cost - compare that with hosted API pricing to see which fits your usage.

Is the local GGUF the same as the API model?

It is the same model family at your chosen precision: the DeepSeek V4 Flash API serves the full-precision 0731 checkpoint, while your local build is a quantized version of the released weights - Q8 matches full-precision quality in Unsloth's testing, and smaller builds trade a little quality for a lot of memory. For guaranteed-current behavior in production apps, use the API; for private, unlimited, offline use, local GGUF is exactly what it is for.