Instructions to use KarLexAI/DeepSeek-V4.1-Flash-1017-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 KarLexAI/DeepSeek-V4.1-Flash-1017-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 KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S # Run inference directly in the terminal: llama cli -hf KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S # Run inference directly in the terminal: llama cli -hf KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S # Run inference directly in the terminal: ./build/bin/llama cli -hf KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
Use Docker
docker model run hf.co/KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
- Llama new
- LM Studio
- Jan
- vLLM
How to use KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "KarLexAI/DeepSeek-V4.1-Flash-1017-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": "KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
- Ollama
How to use KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF with Ollama:
ollama run hf.co/KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
- Unsloth Desktop
- Pi
How to use KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
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": "KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF with Docker Model Runner:
docker model run hf.co/KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
- Lemonade
How to use KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
Run and chat with the model
lemonade run user.DeepSeek-V4.1-Flash-1017-GGUF-IQ1_S
List all available models
lemonade list
- Hermes Agent
How to use KarLexAI/DeepSeek-V4.1-Flash-1017-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 KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
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 KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S
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 "KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF:IQ1_S" \ --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.1 Flash is a 763B-parameter mixture-of-experts model, 510 GB as released. KLX-IQ1_S is 233 GB and runs on four H100 80 GB GPUs with eight 80K-token conversations at once. Standard GGUF, stock llama.cpp, no fork.
✨ Highlights
- 🖥️ Four GPUs, not a cluster. On 4× H100 80 GB with eight parallel 81,920-token slots, each GPU holds about 44 GiB; the rest of the file stays memory-mapped in system RAM.
- 🧠 Still reasons. 100% on AIME 2025, 96.7% on AIME 2026, 91.0% on MATH-500 and 95.5% on IFEval (strict).
- ⚖️ Matches Unsloth's UD-IQ1_S, and sits closer to the full model. On the same 1,099 questions and seeds, the scores are equal within error, with 24% lower KL divergence to the full model and a slightly smaller file.
- ⚡ Shorter reasoning. About 16% fewer tokens per MATH-500 answer and 18% fewer per AIME 2025 answer than UD-IQ1_S in the same runs.
- 🔌 Plain GGUF. Only standard llama.cpp tensor types; the chat template is built in.
📦 The file
| Folder | Size | Mean KL vs. full model ↓ | Pick it for |
|---|---|---|---|
| KLX-IQ1_S | 232.6 GB | 0.082 | running DeepSeek V4.1 Flash on 4× H100 |
You need more memory than the file size, in GPU memory plus system RAM. Scores, the head-to-head and how every number was measured: BENCHMARKS.md.
🚀 Run it with two commands
hf download KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF --include "KLX-IQ1_S/*" --local-dir .
llama-server -m KLX-IQ1_S/DeepSeek-V4.1-Flash-1017-KLX-IQ1_S-00001-of-00006.gguf --fit on -c 131072 --jinja --reasoning-format deepseek --temp 1.0 --top-p 1.0
Then open http://localhost:8080 and chat. You need a llama.cpp build with DeepSeek V4.1 support (we tested commit
bcb0152). With less GPU memory, --fit on keeps part of the experts in system RAM.
🖼️ Images
DeepSeek V4.1 Flash also reads images. Download the vision projector (about 1 GB) and add --mmproj:
hf download KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF mmproj-F16.gguf --local-dir .
llama-server -m KLX-IQ1_S/DeepSeek-V4.1-Flash-1017-KLX-IQ1_S-00001-of-00006.gguf --mmproj mmproj-F16.gguf --fit on -c 131072 --jinja --reasoning-format deepseek --temp 1.0 --top-p 1.0
mmproj-BF16.gguf works the same way (we tested llama.cpp commit 351025ec).
🧾 The fine print
- Post-training quantization of deepseek-ai/DeepSeek-V4.1-Flash-1017. No fine-tuning. The vision encoder is in the separate mmproj files, unquantized (F16 and BF16), converted with upstream llama.cpp and tested with KLX-IQ1_S.
- Chat template: Unsloth's llama.cpp port of DeepSeek's template (MIT), which renders the same prompts as DeepSeek's
own
chat_template.jinja. - Use is governed by the MIT license of the base model: see LICENSE.
Made by KarLex AI. If this file saves you GPUs, a ❤️ on this repo helps others find it.
Not affiliated with DeepSeek or Unsloth.
- Downloads last month
- 145
1-bit
Model tree for KarLexAI/DeepSeek-V4.1-Flash-1017-GGUF
Base model
deepseek-ai/DeepSeek-V4.1-Flash-1017