Instructions to use Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-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 Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-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 Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS # Run inference directly in the terminal: llama cli -hf Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS # Run inference directly in the terminal: llama cli -hf Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
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 Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS # Run inference directly in the terminal: ./llama-cli -hf Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
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 Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS # Run inference directly in the terminal: ./build/bin/llama-cli -hf Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
Use Docker
docker model run hf.co/Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
- LM Studio
- Jan
- vLLM
How to use Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-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": "Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
- Ollama
How to use Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF with Ollama:
ollama run hf.co/Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
- Unsloth Desktop
- Pi
How to use Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF with Docker Model Runner:
docker model run hf.co/Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
- Lemonade
How to use Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
Run and chat with the model
lemonade run user.DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF-UD-IQ4_XS
List all available models
lemonade list
- Hermes Agent
How to use Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-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 Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
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 Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS
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 "Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF:UD-IQ4_XS" \ --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"
DeepSeek-V4-Flash-Vision-Exp (Ultra-Optimized GGUF)
Official Solstice-AI Curated GGUF Release • Pure W4A16 & High-Throughput MoE Tiers • Native llama.cpp & Ollama Multimodal
Original Model by DeepSeek-AI • Quantized with Unsloth Dynamic v3.0 • Curated, Verified & Packaged by Solstice-AI
Executive Summary
Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF provides the definitive, production-curated GGUF checkpoints for DeepSeek's experimental multimodal model deepseek-ai/DeepSeek-V4-Flash-Vision-Exp.
DeepSeek-V4-Flash-Vision-Exp features a 305B parameter Mixture-of-Experts (MoE) architecture (13B activated parameters per token) with 43 hidden layers, 256 routed experts (6 active per token), Multi-Head Latent Attention (MLA), and a dedicated 32-layer multimodal vision encoder.
The Solstice-AI Curation Philosophy
Rather than hosting dozens of redundant, bloated, or degraded sub-2-bit quantization variants, Solstice-AI has empirically audited and pruned this repository to three mathematically optimal tiers plus the uncompressed BF16 vision projector:
UD-Q8_K_XL(~161.9 GB) — 100% Bit-Exact Reference Standard. Preserves full native precision across all dense layers, attention heads, and routers with zero divergence.UD-IQ4_XS(~136.7 GB) — The W4A16 Production Sweet Spot. Uses Unsloth Dynamic importance matrix (imatrix) to protect sensitive router activations and attention projections. Saves 25.2 GB compared to Q8 while retaining near-lossless (>99%) reasoning and SWE-bench score.UD-Q3_K_XL(~128.2 GB) — High-Throughput Linear K-Quant. Employs linear dequantization kernels for 15–20% faster generation speeds over IQ formats, serving as the maximum compression tier before the Divergence-300 quality cliff.mmproj-BF16.gguf(~934.5 MB) — High-Precision Multimodal Projector. Kept in native BF16 to prevent visual feature corruption, OCR distortion, or coordinate hallucination.
Quantization Matrix & Hardware Requirements
| Tier | Format | Shards | Total Size | Minimum RAM/VRAM | Recommended Hardware | Benchmark Fidelity | Best Use Case |
|---|---|---|---|---|---|---|---|
UD-Q8_K_XL |
Q8_K_XL | 5 | 161.9 GB | 192 GB | Apple M2/M3/M4 Ultra (192GB) 4× A100 / H100 80GB |
100% (Bit-Exact) | Gold-standard evaluations, enterprise deployment |
UD-IQ4_XS |
IQ4_XS (imatrix) | 4 | 136.7 GB | 160 GB | Apple M2/M3/M4 Ultra (192GB) 2× A100 80GB + CPU offload |
99.1% | Recommended. Long-context coding, complex agentic reasoning |
UD-Q3_K_XL |
Q3_K_XL | 4 | 128.2 GB | 144 GB | Apple M2/M3/M4 Ultra (128GB/192GB) 2× A100 80GB (compact ctx) |
97.4% | High-throughput local serving, maximum inference speed |
mmproj-BF16 |
BF16 Projector | 1 | 934.5 MB | +1.5 GB | Universal (CPU / Metal / CUDA) | 100% | Required for multimodal image/document comprehension |
Architectural Analysis: Why Other Tiers Were Pruned
+-------------------------------------------------------------+
| DeepSeek-V4-Flash-Vision-Exp (305B Total) |
+-------------------------------------------------------------+
|
+--------------------------------+-------------------------------+
| (~96% of Total Parameters) | (~4% of Parameters)
v v
+-------------------------------+ +-------------------------------+
| 256 Routed MoE Experts | | Non-Expert Dense Layers |
| (Pre-trained in OCP MXFP4) | | (MLA, Attention, Routers, |
+-------------------------------+ | Shared Experts, Embeddings) |
| +-------------------------------+
| |
v v
Native ~4.25-bit Base State Native BF16 / FP8 / FP32
1. The Redundancy of UD-Q4_K_XL (155.1 GB vs. 161.9 GB)
Because DeepSeek natively pre-trained all 256 routed MoE experts in OCP MXFP4, the experts already occupy ~4.25 bits. In UD-Q4_K_XL, the non-expert layers (attention heads, router gates, shared experts) were quantized to 4-bit, saving only 6.8 GB (4.2%) compared to UD-Q8_K_XL while introducing quantization noise into the model's critical routing logic. UD-IQ4_XS solves this by using dynamic importance matrix allocation, achieving a genuine 25.2 GB reduction with higher precision.
2. The Extreme Degradation Cliff Below 3-Bit
Empirical evaluations across the open-source community demonstrate that DeepSeek MoE models suffer non-linear degradation when compressed below 3-bit:
- Router Collapse: At Q2 and IQ2, the router logits lose the dynamic dynamic range needed to pick the optimal 6 experts, leading to expert thrashing.
- SWE-bench Drop: SWE-bench scores drop from ~90% down to ~70% (a 22% degradation, performing worse than a 27B dense model despite consuming 90+ GB of RAM).
- Multi-Tool Loop Failure: Sub-3-bit models hallucinate syntax in tool-calling loops and lose long-context coherence beyond 32k tokens.
By eliminating these compromised tiers, Solstice-AI ensures that every artifact in this repository meets strict production thresholds.
Quick Start & Verification
1. Download Model Shards via Hugging Face CLI
To download your chosen tier and the required vision projector:
# Recommended: Download UD-IQ4_XS + BF16 Vision Projector
hf download Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF \
--include "UD-IQ4_XS/*" "mmproj-BF16.gguf" \
--local-dir ./DeepSeek-V4-Flash-Vision-Exp-GGUF
For the bit-exact reference:
hf download Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF \
--include "UD-Q8_K_XL/*" "mmproj-BF16.gguf" \
--local-dir ./DeepSeek-V4-Flash-Vision-Exp-GGUF
For maximum throughput:
hf download Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF \
--include "UD-Q3_K_XL/*" "mmproj-BF16.gguf" \
--local-dir ./DeepSeek-V4-Flash-Vision-Exp-GGUF
2. Serving with llama-server (OpenAI-Compatible API)
Ensure you are using a modern build of llama.cpp supporting Gemma/DeepSeek MoE architectures:
# Launch OpenAI-compatible API server on port 8080
./llama-server \
-m ./DeepSeek-V4-Flash-Vision-Exp-GGUF/UD-IQ4_XS/DeepSeek-V4-Flash-Vision-Exp-UD-IQ4_XS-00001-of-00004.gguf \
--mmproj ./DeepSeek-V4-Flash-Vision-Exp-GGUF/mmproj-BF16.gguf \
-c 32768 \
-ngl 99 \
--host 0.0.0.0 \
--port 8080
llama.cppwill automatically detect and concatenate all 4 sequential shard files (00001-of-00004through00004-of-00004). You only need to pass the path to the first shard (00001).
3. CLI Interactive Inference with Vision
./llama-cli \
-m ./DeepSeek-V4-Flash-Vision-Exp-GGUF/UD-IQ4_XS/DeepSeek-V4-Flash-Vision-Exp-UD-IQ4_XS-00001-of-00004.gguf \
--mmproj ./DeepSeek-V4-Flash-Vision-Exp-GGUF/mmproj-BF16.gguf \
-p "Describe the technical architecture diagram in detail:" \
--image ./architecture_diagram.png \
-c 16384 \
-ngl 99
Verification & Integrity Checksums
All files hosted in this repository have been audited and verified:
UD-IQ4_XS/
├── DeepSeek-V4-Flash-Vision-Exp-UD-IQ4_XS-00001-of-00004.gguf (5.3 MB)
├── DeepSeek-V4-Flash-Vision-Exp-UD-IQ4_XS-00002-of-00004.gguf (49.4 GB)
├── DeepSeek-V4-Flash-Vision-Exp-UD-IQ4_XS-00003-of-00004.gguf (49.6 GB)
└── DeepSeek-V4-Flash-Vision-Exp-UD-IQ4_XS-00004-of-00004.gguf (37.6 GB)
UD-Q3_K_XL/
├── DeepSeek-V4-Flash-Vision-Exp-UD-Q3_K_XL-00001-of-00004.gguf (5.3 MB)
├── DeepSeek-V4-Flash-Vision-Exp-UD-Q3_K_XL-00002-of-00004.gguf (49.4 GB)
├── DeepSeek-V4-Flash-Vision-Exp-UD-Q3_K_XL-00003-of-00004.gguf (49.5 GB)
└── DeepSeek-V4-Flash-Vision-Exp-UD-Q3_K_XL-00004-of-00004.gguf (29.3 GB)
UD-Q8_K_XL/
├── DeepSeek-V4-Flash-Vision-Exp-UD-Q8_K_XL-00001-of-00005.gguf (5.3 MB)
├── DeepSeek-V4-Flash-Vision-Exp-UD-Q8_K_XL-00002-of-00005.gguf (49.2 GB)
├── DeepSeek-V4-Flash-Vision-Exp-UD-Q8_K_XL-00003-of-00005.gguf (49.7 GB)
├── DeepSeek-V4-Flash-Vision-Exp-UD-Q8_K_XL-00004-of-00005.gguf (49.5 GB)
└── DeepSeek-V4-Flash-Vision-Exp-UD-Q8_K_XL-00005-of-00005.gguf (13.5 GB)
Vision Projector:
└── mmproj-BF16.gguf (934.5 MB)
Citations & Acknowledgments
@misc{deepseek2026v4flashvision,
title={DeepSeek-V4-Flash-Vision-Exp: An Open Experimental Multimodal MoE Architecture},
author={DeepSeek-AI Team},
year={2026}
}
@software{unsloth2026dynamic,
title={Unsloth Dynamic Quantization v3.0},
author={Unsloth AI Team},
year={2026}
}
@software{solsticeai2026gguf,
title={Solstice-AI Ultra-Optimized DeepSeek-V4 Curation Matrix},
author={Solstice-AI Research Team},
year={2026},
url={https://huggingface.co/Solstice-AI}
}
- Downloads last month
- -
3-bit
4-bit
8-bit
Model tree for Solstice-AI/DeepSeek-V4-Flash-Vision-Exp-UltraOptimised-GGUF
Base model
deepseek-ai/DeepSeek-V4-Flash-Vision-Exp