模型简介
模型特点
模型能力
使用案例
🚀 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



