模型简介
模型特点
模型能力
使用案例
🚀 QVQ-72B-Preview的Llamacpp imatrix量化版本
本项目是QVQ-72B-Preview模型基于llamacpp的imatrix量化版本,提供了多种量化类型的模型文件,方便不同硬件配置和使用场景下的部署与应用。
🚀 快速开始
运行方式
QwenVL模型需要使用llama-qwen2vl-cli
工具,示例命令如下:
./llama-qwen2vl-cli -m /models/QVQ-72B-Preview-Q4_K_M.gguf \
--mmproj /models/mmproj-QVQ-72B-Preview-f16.gguf \
-p 'How many fingers does this hand have.' \
--image '/models/hand.jpg'
提示词格式
<|im_start|>system
{system_prompt}<|im_end|>
<|im_start|>user
{prompt}<|im_end|>
<|im_start|>assistant
✨ 主要特性
- 多种量化类型:提供了丰富的量化类型供选择,如Q8_0、Q6_K、Q5_K_L等,满足不同的质量和性能需求。
- 在线重打包:部分量化类型支持在线重打包,可根据硬件情况自动优化性能。
- 性能优化:通过合理选择量化类型和配置,可在不同硬件上实现性能的优化。
📦 安装指南
安装huggingface-cli
首先,确保你已经安装了huggingface-cli:
pip install -U "huggingface_hub[cli]"
下载指定文件
你可以指定要下载的特定文件,例如:
huggingface-cli download bartowski/QVQ-72B-Preview-GGUF --include "QVQ-72B-Preview-Q4_K_M.gguf" --local-dir ./
下载拆分文件
如果模型大小超过50GB,它会被拆分成多个文件。要将它们全部下载到本地文件夹,请运行:
huggingface-cli download bartowski/QVQ-72B-Preview-GGUF --include "QVQ-72B-Preview-Q8_0/*" --local-dir ./
你可以指定一个新的本地目录(如QVQ-72B-Preview-Q8_0),也可以将它们全部下载到当前目录(./)。
💻 使用示例
基础用法
使用llama-qwen2vl-cli
工具运行模型的基本命令如下:
./llama-qwen2vl-cli -m /models/QVQ-72B-Preview-Q4_K_M.gguf \
--mmproj /models/mmproj-QVQ-72B-Preview-f16.gguf \
-p 'How many fingers does this hand have.' \
--image '/models/hand.jpg'
📚 详细文档
模型文件下载
你可以从以下链接下载不同量化类型的模型文件:
文件名 | 量化类型 | 文件大小 | 是否拆分 | 描述 |
---|---|---|---|---|
QVQ-72B-Preview-Q8_0.gguf | Q8_0 | 77.26GB | true | 极高质量,通常不需要,但提供了最大可用的量化。 |
QVQ-72B-Preview-Q6_K.gguf | Q6_K | 64.35GB | true | 非常高质量,接近完美,推荐。 |
QVQ-72B-Preview-Q5_K_L.gguf | Q5_K_L | 55.22GB | true | 嵌入和输出权重使用Q8_0。高质量,推荐。 |
QVQ-72B-Preview-Q5_K_M.gguf | Q5_K_M | 54.45GB | true | 高质量,推荐。 |
QVQ-72B-Preview-Q5_K_S.gguf | Q5_K_S | 51.38GB | true | 高质量,推荐。 |
QVQ-72B-Preview-Q4_K_L.gguf | Q4_K_L | 48.34GB | false | 嵌入和输出权重使用Q8_0。质量良好,推荐。 |
QVQ-72B-Preview-Q4_K_M.gguf | Q4_K_M | 47.42GB | false | 质量良好,大多数用例的默认大小,推荐。 |
QVQ-72B-Preview-Q4_1.gguf | Q4_1 | 45.70GB | false | 旧格式,性能与Q4_K_S相似,但在Apple硅芯片上提高了每瓦令牌数。 |
QVQ-72B-Preview-Q4_K_S.gguf | Q4_K_S | 43.89GB | false | 质量稍低,但节省更多空间,推荐。 |
QVQ-72B-Preview-Q4_0.gguf | Q4_0 | 41.38GB | false | 旧格式,为ARM和AVX CPU推理提供在线重打包。 |
QVQ-72B-Preview-IQ4_NL.gguf | IQ4_NL | 41.32GB | false | 类似于IQ4_XS,但稍大。为ARM CPU推理提供在线重打包。 |
QVQ-72B-Preview-Q3_K_XL.gguf | Q3_K_XL | 40.60GB | false | 嵌入和输出权重使用Q8_0。质量较低但可用,适合低内存情况。 |
QVQ-72B-Preview-IQ4_XS.gguf | IQ4_XS | 39.71GB | false | 质量不错,比Q4_K_S小,性能相似,推荐。 |
QVQ-72B-Preview-Q3_K_L.gguf | Q3_K_L | 39.51GB | false | 质量较低但可用,适合低内存情况。 |
QVQ-72B-Preview-Q3_K_M.gguf | Q3_K_M | 37.70GB | false | 低质量。 |
QVQ-72B-Preview-IQ3_M.gguf | IQ3_M | 35.50GB | false | 中低质量,新方法,性能与Q3_K_M相当。 |
QVQ-72B-Preview-Q3_K_S.gguf | Q3_K_S | 34.49GB | false | 低质量,不推荐。 |
QVQ-72B-Preview-IQ3_XXS.gguf | IQ3_XXS | 31.85GB | false | 质量较低,新方法,性能与Q3量化相当。 |
QVQ-72B-Preview-Q2_K_L.gguf | Q2_K_L | 31.03GB | false | 嵌入和输出权重使用Q8_0。质量非常低,但令人惊讶地可用。 |
QVQ-72B-Preview-Q2_K.gguf | Q2_K | 29.81GB | false | 质量非常低,但令人惊讶地可用。 |
QVQ-72B-Preview-IQ2_M.gguf | IQ2_M | 29.34GB | false | 质量相对较低,使用SOTA技术,令人惊讶地可用。 |
QVQ-72B-Preview-IQ2_S.gguf | IQ2_S | 27.94GB | false | 质量较低,使用SOTA技术可用。 |
QVQ-72B-Preview-IQ2_XS.gguf | IQ2_XS | 27.06GB | false | 质量较低,使用SOTA技术可用。 |
QVQ-72B-Preview-IQ2_XXS.gguf | IQ2_XXS | 25.49GB | false | 质量非常低,使用SOTA技术可用。 |
QVQ-72B-Preview-IQ1_M.gguf | IQ1_M | 23.74GB | 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提供了一篇很棒的文章,带有显示各种性能的图表,可查看此处
首先,你需要确定可以运行多大的模型。为此,你需要了解自己有多少RAM和/或VRAM。
如果你希望模型运行尽可能快,你需要将整个模型放入GPU的VRAM中。选择文件大小比GPU总VRAM小1 - 2GB的量化模型。
如果你追求绝对最高质量,将系统RAM和GPU的VRAM相加,然后选择文件大小比该总和小1 - 2GB的量化模型。
接下来,你需要决定是使用“I量化”还是“K量化”。
如果你不想考虑太多,选择K量化之一。这些格式为'QX_K_X',如Q5_K_M。
如果你想深入了解,可以查看这个非常有用的特性图表:
但基本上,如果你目标是低于Q4,并且你运行的是cuBLAS(Nvidia)或rocBLAS(AMD),你应该考虑I量化。这些格式为IQX_X,如IQ3_M。这些是较新的,对于相同大小的模型提供更好的性能。
这些I量化也可以在CPU和Apple Metal上使用,但比等效的K量化慢,所以你需要在速度和性能之间进行权衡。
I量化与Vulcan(也是AMD)不兼容,所以如果你有AMD显卡,请仔细检查你使用的是rocBLAS版本还是Vulcan版本。在撰写本文时,LM Studio有一个支持ROCm的预览版,其他推理引擎也有针对ROCm的特定版本。
🔧 技术细节
使用llama.cpp发布版本b4381进行量化。原始模型:Qwen/QVQ-72B-Preview。所有量化均使用imatrix选项,数据集来自此处。
📄 许可证
本项目采用Qwen许可证。
致谢
感谢kalomaze和Dampf在创建imatrix校准数据集方面提供的帮助。
感谢ZeroWw在嵌入/输出实验方面的启发。
如果你想支持我的工作,请访问我的ko-fi页面:https://ko-fi.com/bartowski









