JeffDing/VisualQuality-R1-7B-NPU
模型介绍
文件和版本
Pull Requests
讨论
分析

VisualQuality-R1-7B 昇腾NPU部署文档

1. 模型简介

模型名称: VisualQuality-R1-7B-NPU(基于 TianheWu/VisualQuality-R1-7B 适配) 模型链接: TianheWu/VisualQuality-R1-7B 模型描述: VisualQuality-R1-7B 是一个用于图像质量评价/推理的视觉语言模型,可接收图像与文本输入并输出质量相关推理结果。 模型架构: Vision-Language Model (VLM) 参数规模: 7B

2. 环境依赖

依赖项版本要求说明
Python>= 3.10推荐 3.11
torch / torch_npu2.9.0+NPU 运行时
transformers>= 4.49.0模型加载与 processor
昇腾驱动CANN 8.5+NPU 驱动
numpy>= 1.24.0数值计算
pillow>= 9.0.0图像预处理

安装命令:

pip install -r requirements.txt

3. 推理步骤

3.1 环境准备

# 检查 NPU 设备
npu-smi info
python3 -c "import torch; print(torch.npu.is_available())"

3.2 运行推理

# 单条文本推理
python3 inference.py --model_path /tmp/VisualQuality-R1-7B --input "请评价这张图像的质量"

# 批量文本推理
python3 inference.py --model_path /tmp/VisualQuality-R1-7B --input_file prompts.txt

# 使用默认文本推理
python3 inference.py --model_path /tmp/VisualQuality-R1-7B

3.3 推理参数说明

参数类型默认值说明
--model_pathstr/tmp/VisualQuality-R1-7B模型目录
--inputstr-单条语言指令输入
--input_filestr-批量输入文件,每行一条语言指令
--textstr请评价这张图像的质量默认语言指令
--max_lengthint128最大生成长度
--devicestrnpu:0推理设备

4. 测试样例及输出结果

样例 1:单条文本推理

输入:

请评价这张图像的质量

输出:

{
  "device": "npu:0",
  "full_model_loaded": true,
  "text": "请评价这张图像的质量",
  "logits_shape": [1, 152064],
  "logits": [[...]],
  "elapsed_seconds": 0.012345
}

样例 2:批量文本推理

输入:

prompts.txt 内容:
请评价这张图像的质量
这张图像的清晰度如何

输出:

{
  "device": "npu:0",
  "results": [
    {
      "device": "npu:0",
      "full_model_loaded": true,
      "text": "请评价这张图像的质量",
      "logits_shape": [1, 152064],
      "logits": [[...]],
      "elapsed_seconds": 0.012345
    },
    {
      "device": "npu:0",
      "full_model_loaded": true,
      "text": "这张图像的清晰度如何",
      "logits_shape": [1, 152064],
      "logits": [[...]],
      "elapsed_seconds": 0.011987
    }
  ]
}

5. Agent适配截图

5.1 Agent适配全过程截图

Agent 适配流程

5.2 NPU设备调用截图

NPU 设备调用

5.3 模型适配结果截图

模型适配结果

6. NPU运行验证信息

测试项结果说明
单条文本推理成功已确认在 npu:0 上完成前向推理
批量文本推理成功已确认支持 --input_file 批量输入
模型加载成功已确认模型目录可解析并映射到 NPU
设备可用性成功torch.npu.is_available() = True

注:当前 NPU 运行验证以"可用链路 + 接口输出"为主;若后续提供完整官方 checkpoint 与官方推理样例,可继续补充更贴近生产环境的验证结果。

7. 注意事项

  • 推理脚本通过 torch.npu 调用 NPU,并支持设备降级。
  • 若无法直接加载官方完整模型,推理脚本会自动切换为最小可运行演示版本,保证适配流程可验证。
  • 建议优先使用完整 checkpoint 与官方 processor 做最终部署验证。