模型概述
模型特點
模型能力
使用案例
🚀 PocketDoc的Dans-SakuraKaze-V1.0.0-12b的Llamacpp imatrix量化版本
本項目是對PocketDoc的Dans-SakuraKaze-V1.0.0-12b模型進行的量化處理,旨在提升模型在不同硬件環境下的運行效率。通過使用特定的量化工具和數據集,生成了多種量化類型的模型文件,方便用戶根據自身需求選擇合適的版本。
模型信息
🚀 快速開始
- 量化工具:使用 llama.cpp 發佈版本 b4882 進行量化。
- 原始模型:https://huggingface.co/PocketDoc/Dans-SakuraKaze-V1.0.0-12b
- 量化數據集:所有量化均使用imatrix選項,並使用來自 此處 的數據集。
- 運行方式:
✨ 主要特性
- 多種量化類型:提供了豐富的量化類型,如bf16、Q8_0、Q6_K_L等,滿足不同用戶對模型質量和文件大小的需求。
- 在線重打包:部分量化類型支持在線重打包,可根據硬件情況自動優化權重,提升性能。
- 性能優化:通過合理選擇量化類型和優化權重,在保證一定質量的前提下,提高模型的運行速度。
💻 使用示例
提示格式
<|im_start|>system
{system_prompt}<|im_end|>
<|im_start|>user
{prompt}<|im_end|>
<|im_start|>assistant
📦 安裝指南
使用huggingface-cli下載
首先,確保你已安裝huggingface-cli:
pip install -U "huggingface_hub[cli]"
然後,你可以指定要下載的特定文件:
huggingface-cli download bartowski/PocketDoc_Dans-SakuraKaze-V1.0.0-12b-GGUF --include "PocketDoc_Dans-SakuraKaze-V1.0.0-12b-Q4_K_M.gguf" --local-dir ./
如果模型文件大於50GB,它會被分割成多個文件。要將它們全部下載到本地文件夾,請運行:
huggingface-cli download bartowski/PocketDoc_Dans-SakuraKaze-V1.0.0-12b-GGUF --include "PocketDoc_Dans-SakuraKaze-V1.0.0-12b-Q8_0/*" --local-dir ./
你可以指定一個新的本地目錄(如PocketDoc_Dans-SakuraKaze-V1.0.0-12b-Q8_0),也可以將它們全部下載到當前目錄(./)。
📚 詳細文檔
下載文件選擇
文件名 | 量化類型 | 文件大小 | 分割情況 | 描述 |
---|---|---|---|---|
Dans-SakuraKaze-V1.0.0-12b-bf16.gguf | bf16 | 24.50GB | 否 | 完整的BF16權重。 |
Dans-SakuraKaze-V1.0.0-12b-Q8_0.gguf | Q8_0 | 13.02GB | 否 | 極高質量,通常不需要,但為最大可用量化。 |
Dans-SakuraKaze-V1.0.0-12b-Q6_K_L.gguf | Q6_K_L | 10.38GB | 否 | 嵌入和輸出權重使用Q8_0。非常高質量,接近完美,推薦。 |
Dans-SakuraKaze-V1.0.0-12b-Q6_K.gguf | Q6_K | 10.06GB | 否 | 非常高質量,接近完美,推薦。 |
Dans-SakuraKaze-V1.0.0-12b-Q5_K_L.gguf | Q5_K_L | 9.14GB | 否 | 嵌入和輸出權重使用Q8_0。高質量,推薦。 |
Dans-SakuraKaze-V1.0.0-12b-Q5_K_M.gguf | Q5_K_M | 8.73GB | 否 | 高質量,推薦。 |
Dans-SakuraKaze-V1.0.0-12b-Q5_K_S.gguf | Q5_K_S | 8.52GB | 否 | 高質量,推薦。 |
Dans-SakuraKaze-V1.0.0-12b-Q4_K_L.gguf | Q4_K_L | 7.98GB | 否 | 嵌入和輸出權重使用Q8_0。質量良好,推薦。 |
Dans-SakuraKaze-V1.0.0-12b-Q4_1.gguf | Q4_1 | 7.80GB | 否 | 舊格式,性能與Q4_K_S相似,但在Apple硅芯片上每瓦處理的令牌數有所提高。 |
Dans-SakuraKaze-V1.0.0-12b-Q4_K_M.gguf | Q4_K_M | 7.48GB | 否 | 質量良好,是大多數用例的默認大小,推薦。 |
Dans-SakuraKaze-V1.0.0-12b-Q3_K_XL.gguf | Q3_K_XL | 7.15GB | 否 | 嵌入和輸出權重使用Q8_0。質量較低但可用,適合低內存情況。 |
Dans-SakuraKaze-V1.0.0-12b-Q4_K_S.gguf | Q4_K_S | 7.12GB | 否 | 質量略低,但節省空間,推薦。 |
Dans-SakuraKaze-V1.0.0-12b-IQ4_NL.gguf | IQ4_NL | 7.10GB | 否 | 與IQ4_XS相似,但略大。支持ARM CPU推理的在線重打包。 |
Dans-SakuraKaze-V1.0.0-12b-Q4_0.gguf | Q4_0 | 7.09GB | 否 | 舊格式,支持ARM和AVX CPU推理的在線重打包。 |
Dans-SakuraKaze-V1.0.0-12b-IQ4_XS.gguf | IQ4_XS | 6.74GB | 否 | 質量不錯,比Q4_K_S小,性能相似,推薦。 |
Dans-SakuraKaze-V1.0.0-12b-Q3_K_L.gguf | Q3_K_L | 6.56GB | 否 | 質量較低但可用,適合低內存情況。 |
Dans-SakuraKaze-V1.0.0-12b-Q3_K_M.gguf | Q3_K_M | 6.08GB | 否 | 質量低。 |
Dans-SakuraKaze-V1.0.0-12b-IQ3_M.gguf | IQ3_M | 5.72GB | 否 | 中低質量,新方法,性能與Q3_K_M相當。 |
Dans-SakuraKaze-V1.0.0-12b-Q3_K_S.gguf | Q3_K_S | 5.53GB | 否 | 質量低,不推薦。 |
Dans-SakuraKaze-V1.0.0-12b-Q2_K_L.gguf | Q2_K_L | 5.45GB | 否 | 嵌入和輸出權重使用Q8_0。質量非常低,但出人意料地可用。 |
Dans-SakuraKaze-V1.0.0-12b-IQ3_XS.gguf | IQ3_XS | 5.31GB | 否 | 質量較低,新方法,性能不錯,略優於Q3_K_S。 |
Dans-SakuraKaze-V1.0.0-12b-IQ3_XXS.gguf | IQ3_XXS | 4.95GB | 否 | 質量較低,新方法,性能不錯,與Q3量化相當。 |
Dans-SakuraKaze-V1.0.0-12b-Q2_K.gguf | Q2_K | 4.79GB | 否 | 質量非常低,但出人意料地可用。 |
Dans-SakuraKaze-V1.0.0-12b-IQ2_M.gguf | IQ2_M | 4.44GB | 否 | 質量相對較低,使用了最先進的技術,出人意料地可用。 |
Dans-SakuraKaze-V1.0.0-12b-IQ2_S.gguf | IQ2_S | 4.14GB | 否 | 質量低,使用了最先進的技術,可用。 |
嵌入/輸出權重
部分量化類型(如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的顯存中。選擇文件大小比你的GPU總顯存小1 - 2GB的量化版本。
如果你追求絕對的最高質量,將你的系統內存和GPU顯存相加,然後選擇文件大小比該總和小1 - 2GB的量化版本。
接下來,你需要決定是使用“I量化”還是“K量化”。
如果你不想考慮太多,選擇K量化版本。這些版本的格式為“QX_K_X”,如Q5_K_M。
如果你想深入瞭解,可以查看這個非常有用的特性圖表:llama.cpp特性矩陣
但基本上,如果你目標是低於Q4的量化,並且你使用的是cuBLAS(Nvidia)或rocBLAS(AMD),你應該考慮I量化版本。這些版本的格式為IQX_X,如IQ3_M。這些是較新的版本,在相同大小下提供更好的性能。
這些I量化版本也可以在CPU上使用,但比相應的K量化版本慢,所以你需要在速度和性能之間做出權衡。
I量化版本 不 與Vulcan(也是AMD)兼容,所以如果你有AMD顯卡,請仔細檢查你使用的是rocBLAS版本還是Vulcan版本。在撰寫本文時,LM Studio有一個支持ROCm的預覽版,其他推理引擎也有針對ROCm的特定版本。
🔧 技術細節
本項目使用llama.cpp的特定版本進行量化,通過imatrix選項和特定數據集生成多種量化類型的模型文件。部分量化類型支持在線重打包,可根據硬件情況自動優化權重,提升性能。同時,在選擇量化類型時,需要考慮模型質量、文件大小、硬件環境等因素。
📄 許可證
本項目採用Apache-2.0許可證。
致謝
感謝kalomaze和Dampf在創建imatrix校準數據集方面提供的幫助。
感謝ZeroWw在嵌入/輸出實驗方面提供的靈感。
感謝LM Studio對我工作的贊助。
如果你想支持我的工作,請訪問我的ko-fi頁面:https://ko-fi.com/bartowski



