模型简介
模型特点
模型能力
使用案例
🚀 TheDrummer的Cydonia-24B-v4的Llamacpp imatrix量化模型
本项目提供了基于llama.cpp
对TheDrummer的Cydonia-24B-v4模型进行量化的版本。通过量化处理,模型可以在资源有限的设备上更高效地运行,同时尽可能保持模型的性能。
🚀 快速开始
运行环境
提示词格式
<s>[SYSTEM_PROMPT]{system_prompt}[/SYSTEM_PROMPT][INST]{prompt}[/INST]
✨ 主要特性
- 多种量化类型:提供了丰富的量化类型,如
bf16
、Q8_0
、Q6_K_L
等,满足不同用户对模型质量和文件大小的需求。 - 在线重打包技术:部分量化模型支持在线重打包技术,可根据硬件自动优化权重,提高性能。
- 详细的下载和使用指南:为用户提供了详细的下载和使用说明,方便用户选择和使用合适的量化模型。
📦 安装指南
安装huggingface-cli
首先,确保你已经安装了huggingface-cli
:
pip install -U "huggingface_hub[cli]"
下载单个文件
如果你想下载单个文件,可以使用以下命令:
huggingface-cli download bartowski/TheDrummer_Cydonia-24B-v4-GGUF --include "TheDrummer_Cydonia-24B-v4-Q4_K_M.gguf" --local-dir ./
下载拆分文件
如果模型文件大于50GB,它会被拆分成多个文件。要将它们全部下载到本地文件夹,可以运行以下命令:
huggingface-cli download bartowski/TheDrummer_Cydonia-24B-v4-GGUF --include "TheDrummer_Cydonia-24B-v4-Q8_0/*" --local-dir ./
你可以指定一个新的本地目录(如TheDrummer_Cydonia-24B-v4-Q8_0
),也可以将它们全部下载到当前目录(./
)。
💻 使用示例
目前文档未提供具体代码示例,你可以参考以下通用步骤使用这些量化模型:
- 选择合适的量化模型文件进行下载。
- 根据你的运行环境(如LM Studio或llama.cpp),将下载的模型文件加载到相应的工具中。
- 使用指定的提示词格式输入提示信息,获取模型的输出结果。
📚 详细文档
量化信息
- 量化工具:使用 llama.cpp 版本 b5934 进行量化。
- 原始模型:TheDrummer/Cydonia-24B-v4
- 量化数据集:所有量化模型均使用
imatrix
选项和来自 这里 的数据集生成。
下载文件列表
文件名 | 量化类型 | 文件大小 | 拆分情况 | 描述 |
---|---|---|---|---|
Cydonia-24B-v4-bf16.gguf | bf16 | 47.15GB | false | 完整的BF16权重。 |
Cydonia-24B-v4-Q8_0.gguf | Q8_0 | 25.05GB | false | 极高质量,通常不需要,但为最大可用量化。 |
Cydonia-24B-v4-Q6_K_L.gguf | Q6_K_L | 19.67GB | false | 嵌入和输出权重使用Q8_0。非常高质量,接近完美,推荐。 |
Cydonia-24B-v4-Q6_K.gguf | Q6_K | 19.35GB | false | 非常高质量,接近完美,推荐。 |
Cydonia-24B-v4-Q5_K_L.gguf | Q5_K_L | 17.18GB | false | 嵌入和输出权重使用Q8_0。高质量,推荐。 |
Cydonia-24B-v4-Q5_K_M.gguf | Q5_K_M | 16.76GB | false | 高质量,推荐。 |
Cydonia-24B-v4-Q5_K_S.gguf | Q5_K_S | 16.30GB | false | 高质量,推荐。 |
Cydonia-24B-v4-Q4_1.gguf | Q4_1 | 14.87GB | false | 旧格式,性能与Q4_K_S相似,但在Apple硅芯片上每瓦令牌数有所提高。 |
Cydonia-24B-v4-Q4_K_L.gguf | Q4_K_L | 14.83GB | false | 嵌入和输出权重使用Q8_0。质量良好,推荐。 |
Cydonia-24B-v4-Q4_K_M.gguf | Q4_K_M | 14.33GB | false | 质量良好,大多数用例的默认大小,推荐。 |
Cydonia-24B-v4-Q4_K_S.gguf | Q4_K_S | 13.55GB | false | 质量略低,但节省更多空间,推荐。 |
Cydonia-24B-v4-Q4_0.gguf | Q4_0 | 13.49GB | false | 旧格式,为ARM和AVX CPU推理提供在线重打包。 |
Cydonia-24B-v4-IQ4_NL.gguf | IQ4_NL | 13.47GB | false | 类似于IQ4_XS,但略大。为ARM CPU推理提供在线重打包。 |
Cydonia-24B-v4-Q3_K_XL.gguf | Q3_K_XL | 12.99GB | false | 嵌入和输出权重使用Q8_0。质量较低但可用,适合低内存情况。 |
Cydonia-24B-v4-IQ4_XS.gguf | IQ4_XS | 12.76GB | false | 质量不错,比Q4_K_S小,性能相似,推荐。 |
Cydonia-24B-v4-Q3_K_L.gguf | Q3_K_L | 12.40GB | false | 质量较低但可用,适合低内存情况。 |
Cydonia-24B-v4-Q3_K_M.gguf | Q3_K_M | 11.47GB | false | 低质量。 |
Cydonia-24B-v4-IQ3_M.gguf | IQ3_M | 10.65GB | false | 中低质量,新方法,性能与Q3_K_M相当。 |
Cydonia-24B-v4-Q3_K_S.gguf | Q3_K_S | 10.40GB | false | 低质量,不推荐。 |
Cydonia-24B-v4-IQ3_XS.gguf | IQ3_XS | 9.91GB | false | 质量较低,新方法,性能不错,略优于Q3_K_S。 |
Cydonia-24B-v4-Q2_K_L.gguf | Q2_K_L | 9.55GB | false | 嵌入和输出权重使用Q8_0。质量非常低,但出奇地可用。 |
Cydonia-24B-v4-IQ3_XXS.gguf | IQ3_XXS | 9.28GB | false | 质量较低,新方法,性能不错,与Q3量化相当。 |
Cydonia-24B-v4-Q2_K.gguf | Q2_K | 8.89GB | false | 质量非常低,但出奇地可用。 |
Cydonia-24B-v4-IQ2_M.gguf | IQ2_M | 8.11GB | false | 质量相对较低,使用SOTA技术,出奇地可用。 |
Cydonia-24B-v4-IQ2_S.gguf | IQ2_S | 7.48GB | false | 低质量,使用SOTA技术可用。 |
Cydonia-24B-v4-IQ2_XS.gguf | IQ2_XS | 7.21GB | false | 低质量,使用SOTA技术可用。 |
嵌入/输出权重说明
部分量化模型(如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 提供了一篇很棒的文章,配有图表展示各种性能,点击查看
首先,你需要确定你能运行多大的模型。为此,你需要了解你有多少内存(RAM)和/或显存(VRAM)。
如果你希望模型运行得尽可能快,你需要将整个模型放入GPU的显存中。选择文件大小比你的GPU总显存小1 - 2GB的量化模型。
如果你追求绝对最高质量,将系统内存和GPU显存相加,然后选择文件大小比该总和小1 - 2GB的量化模型。
接下来,你需要决定是使用“I量化”还是“K量化”。
如果你不想考虑太多,选择K量化模型。这些模型的格式为'QX_K_X',如Q5_K_M。
如果你想深入了解,可以查看这个非常有用的特性图表:
但基本上,如果你目标是低于Q4的量化,并且你使用的是cuBLAS(Nvidia)或rocBLAS(AMD),你应该考虑I量化模型。这些模型的格式为IQX_X,如IQ3_M。它们是较新的模型,在相同大小下提供更好的性能。
这些I量化模型也可以在CPU上使用,但比相应的K量化模型慢,因此你需要在速度和性能之间做出权衡。
🔧 技术细节
在线重打包技术
目前的llama.cpp
版本支持在线重打包技术,对于Q4_0量化模型,如果硬件支持,会自动对权重进行重打包,以提高性能。具体细节可参考 此PR。
性能提升
以AVX2系统(EPYC7702)的基准测试为例,Q4_0_8_8在提示处理方面有显著提升,在文本生成方面也有小幅提升。具体测试结果如下:
模型 | 大小 | 参数 | 后端 | 线程数 | 测试项 | 令牌/秒 | 与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% |
📄 许可证
文档未提及相关许可证信息。
致谢
感谢kalomaze和Dampf协助创建imatrix校准数据集。
感谢ZeroWw启发了对嵌入/输出的实验。
感谢LM Studio对本项目的赞助。
如果你想支持我的工作,请访问我的ko-fi页面:https://ko-fi.com/bartowski



