模型概述
模型特點
模型能力
使用案例
🚀 Google Gemma-3-12B-IT-QAT的Llamacpp imatrix量化版本
本項目是基於Google提供的QAT(量化感知訓練)權重進行量化處理的。主要提供了Google Gemma-3-12B-IT-QAT模型的多種量化版本,方便不同硬件條件和需求的用戶使用。
🚀 快速開始
這些量化版本衍生自Google提供的QAT(量化感知訓練)權重。
- 僅Q4_0預計會有更好的效果,但在處理過程中也生成了其他量化類型,以探索不同的可能性。
- gemma-3-12b-it-qat-Q4_0.gguf | Q4_0 | 6.91GB | false | 由於採用了QAT,性能應有所提升,支持為ARM和AVX CPU推理進行在線重新打包。
原始模型:https://huggingface.co/google/gemma-3-12b-it-qat-q4_0-unquantized
所有量化版本均使用imatrix選項和來自此處的數據集生成。
可以在 LM Studio 中運行這些量化版本,也可以直接使用 llama.cpp 或任何基於llama.cpp的項目運行。
✨ 主要特性
- 多種量化類型:提供了豐富的量化類型,如bf16、Q8_0、Q6_K_L等,滿足不同用戶對模型質量和文件大小的需求。
- 在線重新打包:部分量化版本(如Q4_0)支持在線重新打包權重,可自動提升ARM和AVX機器的性能。
- 詳細的選擇指南:為用戶提供了選擇合適量化版本的詳細指南,幫助用戶根據自身硬件條件和需求進行選擇。
📦 安裝指南
使用huggingface-cli下載
首先,確保你已經安裝了huggingface-cli:
pip install -U "huggingface_hub[cli]"
然後,你可以指定要下載的具體文件:
huggingface-cli download bartowski/google_gemma-3-12b-it-qat-GGUF --include "google_gemma-3-12b-it-qat-Q4_K_M.gguf" --local-dir ./
如果模型大小超過50GB,它會被分割成多個文件。要將它們全部下載到本地文件夾,請運行:
huggingface-cli download bartowski/google_gemma-3-12b-it-qat-GGUF --include "google_gemma-3-12b-it-qat-Q8_0/*" --local-dir ./
你可以指定一個新的本地目錄(如google_gemma-3-12b-it-qat-Q8_0),也可以將它們下載到當前目錄(./)。
💻 使用示例
基礎用法
提示格式
<bos><start_of_turn>user
{system_prompt}
{prompt}<end_of_turn>
<start_of_turn>model
<end_of_turn>
<start_of_turn>model
📚 詳細文檔
下載文件
可以從以下表格中選擇要下載的文件:
文件名 | 量化類型 | 文件大小 | 分割情況 | 描述 |
---|---|---|---|---|
gemma-3-12b-it-qat-bf16.gguf | bf16 | 23.54GB | false | 完整的BF16權重。 |
gemma-3-12b-it-qat-Q8_0.gguf | Q8_0 | 12.51GB | false | 極高質量,通常不需要,但提供了最大可用的量化。 |
gemma-3-12b-it-qat-Q6_K_L.gguf | Q6_K_L | 9.90GB | false | 嵌入和輸出權重使用Q8_0。非常高質量,接近完美,推薦。 |
gemma-3-12b-it-qat-Q6_K.gguf | Q6_K | 9.66GB | false | 非常高質量,接近完美,推薦。 |
gemma-3-12b-it-qat-Q5_K_L.gguf | Q5_K_L | 8.69GB | false | 嵌入和輸出權重使用Q8_0。高質量,推薦。 |
gemma-3-12b-it-qat-Q5_K_M.gguf | Q5_K_M | 8.45GB | false | 高質量,推薦。 |
gemma-3-12b-it-qat-Q5_K_S.gguf | Q5_K_S | 8.23GB | false | 高質量,推薦。 |
gemma-3-12b-it-qat-Q4_1.gguf | Q4_1 | 7.56GB | false | 舊格式,性能與Q4_K_S相似,但在Apple硅芯片上的每瓦令牌數有所提高。 |
gemma-3-12b-it-qat-Q4_K_L.gguf | Q4_K_L | 7.54GB | false | 嵌入和輸出權重使用Q8_0。質量良好,推薦。 |
gemma-3-12b-it-qat-Q4_K_M.gguf | Q4_K_M | 7.30GB | false | 質量良好,是大多數用例的默認大小,推薦。 |
gemma-3-12b-it-qat-Q4_K_S.gguf | Q4_K_S | 6.94GB | false | 質量稍低,但節省更多空間,推薦。 |
gemma-3-12b-it-qat-Q4_0.gguf | Q4_0 | 6.91GB | false | 舊格式,為ARM和AVX CPU推理提供在線重新打包。 |
gemma-3-12b-it-qat-IQ4_NL.gguf | IQ4_NL | 6.89GB | false | 與IQ4_XS相似,但稍大。為ARM CPU推理提供在線重新打包。 |
gemma-3-12b-it-qat-Q3_K_XL.gguf | Q3_K_XL | 6.72GB | false | 嵌入和輸出權重使用Q8_0。質量較低但可用,適合低內存情況。 |
gemma-3-12b-it-qat-IQ4_XS.gguf | IQ4_XS | 6.55GB | false | 質量不錯,比Q4_K_S小,性能相似,推薦。 |
gemma-3-12b-it-qat-Q3_K_L.gguf | Q3_K_L | 6.48GB | false | 質量較低但可用,適合低內存情況。 |
gemma-3-12b-it-qat-Q3_K_M.gguf | Q3_K_M | 6.01GB | false | 低質量。 |
gemma-3-12b-it-qat-IQ3_M.gguf | IQ3_M | 5.66GB | false | 中低質量,新方法,性能與Q3_K_M相當。 |
gemma-3-12b-it-qat-Q3_K_S.gguf | Q3_K_S | 5.46GB | false | 低質量,不推薦。 |
gemma-3-12b-it-qat-IQ3_XS.gguf | IQ3_XS | 5.21GB | false | 質量較低,新方法,性能不錯,略優於Q3_K_S。 |
gemma-3-12b-it-qat-Q2_K_L.gguf | Q2_K_L | 5.01GB | false | 嵌入和輸出權重使用Q8_0。質量非常低,但出人意料地可用。 |
gemma-3-12b-it-qat-IQ3_XXS.gguf | IQ3_XXS | 4.78GB | false | 質量較低,新方法,性能不錯,與Q3量化相當。 |
gemma-3-12b-it-qat-Q2_K.gguf | Q2_K | 4.77GB | false | 質量非常低,但出人意料地可用。 |
gemma-3-12b-it-qat-IQ2_M.gguf | IQ2_M | 4.31GB | false | 質量相對較低,使用了最先進的技術,出人意料地可用。 |
嵌入/輸出權重
部分量化版本(如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。加載時間可能會較慢,但總體速度會提高。
選擇合適的文件
點擊查看詳細信息
Artefact2提供了一篇很棒的文章,帶有顯示各種性能的圖表,可 [點擊此處查看](https://gist.github.com/Artefact2/b5f810600771265fc1e39442288e8ec9)。首先,你需要確定你可以運行多大的模型。為此,你需要了解你有多少系統內存(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量化版本慢,因此你需要在速度和性能之間進行權衡。
🔧 技術細節
量化工具
數據集
所有量化版本均使用imatrix選項和來自此處的數據集生成。
📄 許可證
本項目使用Gemma許可證。訪問Hugging Face上的Gemma模型,你需要審查並同意Google的使用許可。請確保你已登錄Hugging Face,然後點擊下方按鈕。請求將立即處理。
致謝
感謝kalomaze和Dampf協助創建imatrix校準數據集。 感謝ZeroWw提供關於嵌入/輸出實驗的靈感。 感謝LM Studio贊助本項目。
如果你想支持我的工作,請訪問我的ko-fi頁面:https://ko-fi.com/bartowski



