模型概述
模型特點
模型能力
使用案例
🚀 Qwen3-4B的Llamacpp imatrix量化版本
本項目使用 llama.cpp 的 b5200 版本進行量化。原始模型可在 這裡 查看。所有量化模型均使用 imatrix 選項,並採用了 此數據集。
🚀 快速開始
你可以在 LM Studio 中運行這些量化模型,也可以直接使用 llama.cpp 或其他基於 llama.cpp 的項目來運行。
✨ 主要特性
- 使用特定版本的 llama.cpp 進行量化,確保量化的準確性和穩定性。
- 提供多種量化類型,滿足不同場景下對模型質量和文件大小的需求。
📦 安裝指南
使用huggingface-cli下載
點擊查看下載說明
首先,確保你已經安裝了 hugginface-cli:
pip install -U "huggingface_hub[cli]"
然後,你可以指定要下載的特定文件:
huggingface-cli download bartowski/Qwen_Qwen3-4B-GGUF --include "Qwen_Qwen3-4B-Q4_K_M.gguf" --local-dir ./
如果模型大小超過 50GB,它會被分割成多個文件。若要將它們全部下載到本地文件夾,請運行:
huggingface-cli download bartowski/Qwen_Qwen3-4B-GGUF --include "Qwen_Qwen3-4B-Q8_0/*" --local-dir ./
你可以指定一個新的本地目錄(如 Qwen_Qwen3-4B-Q8_0),也可以將它們全部下載到當前目錄(./)。
💻 使用示例
提示格式
<|im_start|>system
{system_prompt}<|im_end|>
<|im_start|>user
{prompt}<|im_end|>
<|im_start|>assistant
📚 詳細文檔
下載文件
你可以從以下列表中選擇並下載單個文件(而非整個分支):
文件名 | 量化類型 | 文件大小 | 分割情況 | 描述 |
---|---|---|---|---|
Qwen3-4B-bf16.gguf | bf16 | 8.05GB | 否 | 完整的 BF16 權重。 |
Qwen3-4B-Q8_0.gguf | Q8_0 | 4.28GB | 否 | 極高質量,通常不需要,但為最大可用量化。 |
Qwen3-4B-Q6_K_L.gguf | Q6_K_L | 3.40GB | 否 | 嵌入和輸出權重使用 Q8_0。非常高質量,接近完美,推薦。 |
Qwen3-4B-Q6_K.gguf | Q6_K | 3.31GB | 否 | 非常高質量,接近完美,推薦。 |
Qwen3-4B-Q5_K_L.gguf | Q5_K_L | 2.98GB | 否 | 嵌入和輸出權重使用 Q8_0。高質量,推薦。 |
Qwen3-4B-Q5_K_M.gguf | Q5_K_M | 2.89GB | 否 | 高質量,推薦。 |
Qwen3-4B-Q5_K_S.gguf | Q5_K_S | 2.82GB | 否 | 高質量,推薦。 |
Qwen3-4B-Q4_1.gguf | Q4_1 | 2.60GB | 否 | 舊格式,性能與 Q4_K_S 相似,但在蘋果硅芯片上每瓦處理的令牌數有所提高。 |
Qwen3-4B-Q4_K_L.gguf | Q4_K_L | 2.59GB | 否 | 嵌入和輸出權重使用 Q8_0。質量良好,推薦。 |
Qwen3-4B-Q4_K_M.gguf | Q4_K_M | 2.50GB | 否 | 質量良好,為大多數用例的默認大小,推薦。 |
Qwen3-4B-Q4_K_S.gguf | Q4_K_S | 2.38GB | 否 | 質量略低,但節省更多空間,推薦。 |
Qwen3-4B-Q4_0.gguf | Q4_0 | 2.38GB | 否 | 舊格式,可為 ARM 和 AVX CPU 推理提供在線重新打包。 |
Qwen3-4B-IQ4_NL.gguf | IQ4_NL | 2.38GB | 否 | 與 IQ4_XS 相似,但略大。可為 ARM CPU 推理提供在線重新打包。 |
Qwen3-4B-Q3_K_XL.gguf | Q3_K_XL | 2.33GB | 否 | 嵌入和輸出權重使用 Q8_0。質量較低但可用,適合低內存情況。 |
Qwen3-4B-IQ4_XS.gguf | IQ4_XS | 2.27GB | 否 | 質量尚可,比 Q4_K_S 小,性能相似,推薦。 |
Qwen3-4B-Q3_K_L.gguf | Q3_K_L | 2.24GB | 否 | 質量較低但可用,適合低內存情況。 |
Qwen3-4B-Q3_K_M.gguf | Q3_K_M | 2.08GB | 否 | 低質量。 |
Qwen3-4B-IQ3_M.gguf | IQ3_M | 1.96GB | 否 | 中低質量,新方法,性能與 Q3_K_M 相當。 |
Qwen3-4B-Q3_K_S.gguf | Q3_K_S | 1.89GB | 否 | 低質量,不推薦。 |
Qwen3-4B-IQ3_XS.gguf | IQ3_XS | 1.81GB | 否 | 質量較低,新方法,性能尚可,略優於 Q3_K_S。 |
Qwen3-4B-Q2_K_L.gguf | Q2_K_L | 1.76GB | 否 | 嵌入和輸出權重使用 Q8_0。質量非常低,但出人意料地可用。 |
Qwen3-4B-IQ3_XXS.gguf | IQ3_XXS | 1.67GB | 否 | 質量較低,新方法,性能尚可,與 Q3 量化相當。 |
Qwen3-4B-Q2_K.gguf | Q2_K | 1.67GB | 否 | 質量非常低,但出人意料地可用。 |
Qwen3-4B-IQ2_M.gguf | IQ2_M | 1.51GB | 否 | 質量相對較低,使用了最先進的技術,出人意料地可用。 |
嵌入/輸出權重
部分量化模型(如 Q3_K_XL、Q4_K_L 等)採用標準量化方法,將嵌入和輸出權重量化為 Q8_0,而非默認值。
ARM/AVX 信息
以前,你會下載 Q4_0_4_4/4_8/8_8 模型,這些模型的權重會在內存中交錯排列,以便通過一次加載更多數據來提高 ARM 和 AVX 機器的性能。
然而,現在有了一種名為“在線重新打包”的權重處理方式,詳情見 此 PR。如果你使用 Q4_0 模型,並且你的硬件能從重新打包權重中受益,它將自動即時進行處理。
從 llama.cpp 構建版本 b4282 開始,你將無法運行 Q4_0_X_X 文件,而需要使用 Q4_0。
此外,如果你想獲得略高的質量,可以使用 IQ4_NL,這得益於 此 PR,它也會為 ARM 重新打包權重,不過目前僅支持 4_4 格式。加載時間可能會更長,但總體速度會提高。
點擊查看 Q4_0_X_X 信息(已棄用)
我保留這部分內容是為了展示使用支持在線重新打包的 Q4_0 模型在理論上可能帶來的性能提升。
點擊查看 AVX2 系統(EPYC7702)上的基準測試
模型 | 大小 | 參數 | 後端 | 線程數 | 測試用例 | 每秒令牌數 | 與 Q4_0 相比的百分比 |
---|---|---|---|---|---|---|---|
qwen2 3B Q4_0 | 1.70 GiB | 3.09 B | CPU | 64 | pp512 | 204.03 ± 1.03 | 100% |
qwen2 3B Q4_0 | 1.70 GiB | 3.09 B | CPU | 64 | pp1024 | 282.92 ± 0.19 | 100% |
qwen2 3B Q4_0 | 1.70 GiB | 3.09 B | CPU | 64 | pp2048 | 259.49 ± 0.44 | 100% |
qwen2 3B Q4_0 | 1.70 GiB | 3.09 B | CPU | 64 | tg128 | 39.12 ± 0.27 | 100% |
qwen2 3B Q4_0 | 1.70 GiB | 3.09 B | CPU | 64 | tg256 | 39.31 ± 0.69 | 100% |
qwen2 3B Q4_0 | 1.70 GiB | 3.09 B | CPU | 64 | tg512 | 40.52 ± 0.03 | 100% |
qwen2 3B Q4_K_M | 1.79 GiB | 3.09 B | CPU | 64 | pp512 | 301.02 ± 1.74 | 147% |
qwen2 3B Q4_K_M | 1.79 GiB | 3.09 B | CPU | 64 | pp1024 | 287.23 ± 0.20 | 101% |
qwen2 3B Q4_K_M | 1.79 GiB | 3.09 B | CPU | 64 | pp2048 | 262.77 ± 1.81 | 101% |
qwen2 3B Q4_K_M | 1.79 GiB | 3.09 B | CPU | 64 | tg128 | 18.80 ± 0.99 | 48% |
qwen2 3B Q4_K_M | 1.79 GiB | 3.09 B | CPU | 64 | tg256 | 24.46 ± 3.04 | 83% |
qwen2 3B Q4_K_M | 1.79 GiB | 3.09 B | CPU | 64 | tg512 | 36.32 ± 3.59 | 90% |
qwen2 3B Q4_0_8_8 | 1.69 GiB | 3.09 B | CPU | 64 | pp512 | 271.71 ± 3.53 | 133% |
qwen2 3B Q4_0_8_8 | 1.69 GiB | 3.09 B | CPU | 64 | pp1024 | 279.86 ± 45.63 | 100% |
qwen2 3B Q4_0_8_8 | 1.69 GiB | 3.09 B | CPU | 64 | pp2048 | 320.77 ± 5.00 | 124% |
qwen2 3B Q4_0_8_8 | 1.69 GiB | 3.09 B | CPU | 64 | tg128 | 43.51 ± 0.05 | 111% |
qwen2 3B Q4_0_8_8 | 1.69 GiB | 3.09 B | CPU | 64 | tg256 | 43.35 ± 0.09 | 110% |
qwen2 3B Q4_0_8_8 | 1.69 GiB | 3.09 B | CPU | 64 | tg512 | 42.60 ± 0.31 | 105% |
Q4_0_8_8 模型在提示處理方面有顯著提升,在文本生成方面也有小幅提升。
如何選擇文件
點擊查看詳情
Artefact2 提供了一篇很棒的文章,配有圖表展示各種性能,可查看 此處。
首先,你需要確定能夠運行的模型大小。為此,你需要了解自己擁有的 RAM 和/或 VRAM 容量。
如果你希望模型運行速度儘可能快,你需要將整個模型放入 GPU 的 VRAM 中。選擇文件大小比 GPU 總 VRAM 小 1 - 2GB 的量化模型。
如果你追求絕對的最高質量,將系統 RAM 和 GPU 的 VRAM 相加,然後選擇文件大小比該總和小 1 - 2GB 的量化模型。
接下來,你需要決定是使用“I 量化”還是“K 量化”模型。
如果你不想考慮太多,可以選擇 K 量化模型。這些模型的格式為 'QX_K_X',如 Q5_K_M。
如果你想深入瞭解,可以查看這個非常有用的特性圖表: llama.cpp 特性矩陣
但基本上,如果你希望量化級別低於 Q4,並且使用 cuBLAS(英偉達)或 rocBLAS(AMD),你應該考慮 I 量化模型。這些模型的格式為 IQX_X,如 IQ3_M。這些模型較新,在相同大小下性能更好。
這些 I 量化模型也可以在 CPU 上使用,但速度會比相應的 K 量化模型慢,因此你需要在速度和性能之間進行權衡。
🔧 技術細節
在線重新打包
現在 llama.cpp 支持在線重新打包權重,詳情見 此 PR。如果你使用 Q4_0 模型,並且硬件能從重新打包權重中受益,它將自動即時進行處理。
📄 許可證
文檔中未提及相關許可證信息。
致謝
感謝 kalomaze 和 Dampf 在創建 imatrix 校準數據集方面提供的幫助。 感謝 ZeroWw 啟發我對嵌入/輸出進行實驗。 感謝 LM Studio 對我工作的贊助。
如果你想支持我的工作,請訪問我的 ko-fi 頁面:https://ko-fi.com/bartowski



