🚀 Qwen2-VL-7B-Instruct的Llamacpp imatrix量化版本
本项目基于llama.cpp
对Qwen2-VL-7B-Instruct模型进行量化处理,为用户提供不同量化类型的模型文件,以满足在不同硬件条件下的使用需求。
🚀 快速开始
由于这是一个新的视觉模型,下面为你提供运行的特殊说明。
如果你已经在本地编译了llama.cpp
,可以运行以下命令:
./llama-qwen2vl-cli -m /models/Qwen2-VL-7B-Instruct-Q4_0.gguf --mmproj /models/mmproj-Qwen2-VL-7B-Instruct-f32.gguf -p 'Describe this image.' --image '/models/test_image.jpg'
模型将输出答案。操作非常简单,与其他llava模型类似,只需确保使用正确的二进制文件!
✨ 主要特性
- 多量化类型支持:提供了多种量化类型的模型文件,如f16、Q8_0、Q6_K_L等,可根据不同的硬件资源和性能需求进行选择。
- 优化性能:部分量化文件采用特殊方法处理嵌入和输出权重,以提高在ARM和AVX机器上的性能。
- 在线重打包:支持在线重打包权重,可自动优化硬件性能。
📦 安装指南
使用huggingface-cli下载
首先,确保你已经安装了huggingface-cli
:
pip install -U "huggingface_hub[cli]"
然后,你可以指定要下载的特定文件:
huggingface-cli download bartowski/Qwen2-VL-7B-Instruct-GGUF --include "Qwen2-VL-7B-Instruct-Q4_K_M.gguf" --local-dir ./
如果模型文件大于50GB,它会被分割成多个文件。若要将它们全部下载到本地文件夹,可运行:
huggingface-cli download bartowski/Qwen2-VL-7B-Instruct-GGUF --include "Qwen2-VL-7B-Instruct-Q8_0/*" --local-dir ./
你可以指定一个新的本地目录(如Qwen2-VL-7B-Instruct-Q8_0),也可以将它们全部下载到当前目录(./)。
💻 使用示例
基础用法
运行模型的基本命令如下:
./llama-qwen2vl-cli -m /models/Qwen2-VL-7B-Instruct-Q4_0.gguf --mmproj /models/mmproj-Qwen2-VL-7B-Instruct-f32.gguf -p 'Describe this image.' --image '/models/test_image.jpg'
高级用法
在使用不同量化类型的模型文件时,可根据硬件资源和性能需求进行选择。例如,若要追求极致速度,可选择文件大小比GPU总VRAM小1 - 2GB的量化文件;若要追求最高质量,可将系统RAM和GPU的VRAM相加,选择比总容量小1 - 2GB的量化文件。
📚 详细文档
提示格式
<|im_start|>system
{system_prompt}<|im_end|>
<|im_start|>user
{prompt}<|im_end|>
<|im_start|>assistant
下载文件选择
嵌入/输出权重
部分量化文件(如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。
如果你想深入了解,可以查看这个非常有用的特性图表:llama.cpp特性矩阵。
一般来说,如果你目标是低于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的发布版本b4327进行量化。原始模型可在此处获取。所有量化文件均使用imatrix选项和来自这里的数据集生成。
📄 许可证
本项目采用Apache 2.0许可证。
致谢
感谢kalomaze和Dampf协助创建imatrix校准数据集。感谢ZeroWw提供关于嵌入/输出实验的灵感。
如果你想支持我的工作,请访问我的ko - fi页面:https://ko-fi.com/bartowski