Instructions to use sokann/DeepSeek-V3-0324-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use sokann/DeepSeek-V3-0324-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="sokann/DeepSeek-V3-0324-GGUF", filename="DeepSeek-V3-0324-IQ1_S_R4-00001-of-00003.gguf", )
llm.create_chat_completion( messages = "No input example has been defined for this model task." )
- Notebooks
- Google Colab
- Kaggle
- Local Apps
- llama.cpp
How to use sokann/DeepSeek-V3-0324-GGUF with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R # Run inference directly in the terminal: llama-cli -hf sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R # Run inference directly in the terminal: llama-cli -hf sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R
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 sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R # Run inference directly in the terminal: ./llama-cli -hf sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R
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 sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R # Run inference directly in the terminal: ./build/bin/llama-cli -hf sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R
Use Docker
docker model run hf.co/sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R
- LM Studio
- Jan
- Ollama
How to use sokann/DeepSeek-V3-0324-GGUF with Ollama:
ollama run hf.co/sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R
- Unsloth Studio new
How to use sokann/DeepSeek-V3-0324-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 sokann/DeepSeek-V3-0324-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 sokann/DeepSeek-V3-0324-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for sokann/DeepSeek-V3-0324-GGUF to start chatting
- Docker Model Runner
How to use sokann/DeepSeek-V3-0324-GGUF with Docker Model Runner:
docker model run hf.co/sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R
- Lemonade
How to use sokann/DeepSeek-V3-0324-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull sokann/DeepSeek-V3-0324-GGUF:IQ1_S_R
Run and chat with the model
lemonade run user.DeepSeek-V3-0324-GGUF-IQ1_S_R
List all available models
lemonade list
This is an IQ1_S_R4 quant of DeepSeek-V3-0324, using the imatrix from ubergarm, with a slightly modified recipe:
# Token embedding and output tensors (GPU)
# note token_embd cannot be repacked quant type
token_embd\.weight=iq4_ks
output\.weight=iq4_ks
output_norm\.weight=iq4_ks
# First 3 dense layers (0-3) (GPU)
# Except blk.*.attn_k_b.weight is not divisible by 256 so only supports qN_0
blk\.[0-2]\.attn_k_b.*=q4_0
blk\.[0-2]\.attn_.*=iq4_ks
blk\.[0-2]\..*=iq4_ks
# All attention, norm weights, and bias tensors for MoE layers (3-60) (GPU)
# Except blk.*.attn_k_b.weight is not divisible by 256 so only supports qN_0
blk\.[3-9]\.attn_k_b.*=q4_0
blk\.[1-5][0-9]\.attn_k_b.*=q4_0
blk\.60\.attn_k_b.*=q4_0
blk\.[3-9]\.attn_.*=iq4_ks
blk\.[1-5][0-9]\.attn_.*=iq4_ks
blk\.60\.attn_.*=iq4_ks
blk\.[3-9]\.ffn_norm\.weight=iq4_ks
blk\.[1-5][0-9]\.ffn_norm\.weight=iq4_ks
blk\.60\.ffn_norm\.weight=iq4_ks
blk\.[3-9]\.exp_probs_b\.bias=iq4_ks
blk\.[1-5][0-9]\.exp_probs_b\.bias=iq4_ks
blk\.60\.exp_probs_b\.bias=iq4_ks
# Shared Experts (3-60) (GPU)
blk\.[3-9]\.ffn_down_shexp\.weight=iq4_ks
blk\.[1-5][0-9]\.ffn_down_shexp\.weight=iq4_ks
blk\.60\.ffn_down_shexp\.weight=iq4_ks
blk\.[3-9]\.ffn_(gate|up)_shexp\.weight=iq4_ks
blk\.[1-5][0-9]\.ffn_(gate|up)_shexp\.weight=iq4_ks
blk\.60\.ffn_(gate|up)_shexp\.weight=iq4_ks
# Routed Experts (3-60) (CPU)
blk\.[3-9]\.ffn_down_exps\.weight=iq1_s_r4
blk\.[1-5][0-9]\.ffn_down_exps\.weight=iq1_s_r4
blk\.60\.ffn_down_exps\.weight=iq1_s_r4
blk\.[3-9]\.ffn_(gate|up)_exps\.weight=iq1_s_r4
blk\.[1-5][0-9]\.ffn_(gate|up)_exps\.weight=iq1_s_r4
blk\.60\.ffn_(gate|up)_exps\.weight=iq1_s_r4
The file size is 132998282944 bytes, or 123.864 GiB.
With the routed experts fully offloaded to CPU, the memory usage (before context) will be:
llm_load_tensors: CPU buffer size = 117247.00 MiB
llm_load_tensors: CUDA_Host buffer size = 469.99 MiB
llm_load_tensors: CUDA0 buffer size = 9115.01 MiB
I have a code refactoring eval that uses greedy decoding with deterministic output, and this is the smallest quant I tested that can still perform the same as the FP8 version.
Note that this quant only works with ik_llama.cpp. For the eval, it works even with just 6 experts, i.e. with the flag -ser 6,1.
Big thanks to ubergarm for sharing the imatrix, the recipes, and most importantly the detailed guidance and thought processes.
- Downloads last month
- 2
1-bit
Model tree for sokann/DeepSeek-V3-0324-GGUF
Base model
deepseek-ai/DeepSeek-V3-0324