# 用 Python 和 Transformers 运行 FastVLM

下载完整图片问答脚本，核对权重格式与依赖，并排查首次运行的常见问题。

Canonical URL: https://aiidelist.com/zh/blog/run-fastvlm-python-zh

Language: zh

Published: 2026-09-24

Updated: 2026-09-24

本指南说明如何用 Python 和 Transformers 向一张本地图片提问。可直接下载本站的[完整示例脚本](/fastvlm/downloads/fastvlm_transformers.py)；脚本默认使用经过验证的社区转换版本 `KamilaMila/FastVLM-0.5B`。若要加载 Apple 原始权重，请改用[官方代码库](https://github.com/apple-aiml-research/ml-fastvlm)的说明，不能只替换模型 ID。

[在线体验](/zh/fastvlm/demo) · [比较模型与权重](/zh/blog/fastvlm-models-zh)

## 先确认运行环境

准备 Python 虚拟环境和支持的 PyTorch 版本。安装 Transformers、Pillow、`timm` 及脚本所需依赖；具体版本以下载脚本顶部的要求和[Transformers FastVLM 文档](https://huggingface.co/docs/transformers/model_doc/fast_vlm)为准。首次运行需要从 Hugging Face 下载模型，请确认网络和磁盘空间充足。

```bash
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install "transformers==5.0.0" "timm==1.0.29" torch pillow
python fastvlm_transformers.py image.png
```

在 Windows 上使用 `.venv\Scripts\activate`。如果希望指定问题，请查看脚本中的命令行参数；运行前先阅读脚本，确认输入文件与所选设备正确。对图片中的金额、表格和文字，务必对照原图复核模型回答。

## 不同权重不能互换

| 路径 | 权重 | 用途 |
| --- | --- | --- |
| 本站完整 Transformers 示例 | `KamilaMila/FastVLM-0.5B` | 与下载脚本的兼容处理配套。 |
| Apple 原始实现 | Apple 模型目录中的 Stage2/Stage3 权重 | 使用 Apple 仓库的环境与预测脚本。 |
| Apple 原生应用 | 专用 Apple Silicon 导出包 | 使用官方应用的下载与放置流程。 |
| 浏览器 | 社区 ONNX 0.5B 转换版 | 使用[WebGPU 演示](/zh/fastvlm/demo)或[浏览器开发指南](/zh/blog/fastvlm-webgpu-zh)。 |

## 常见问题

如果找不到 FastVLM 类或 `timm`，先确认当前虚拟环境中安装的是兼容版本，而不是系统中另一套 Python。如果下载中断，重试前检查缓存与磁盘空间；脚本提供关闭 Xet 下载的环境变量用法。出现显存不足时，降低输入图像尺寸、限制生成长度或改用合适的设备。模型输出为空或格式不符合预期时，先用一张简单图片和明确问题验证，再逐步增加任务复杂度。

本站曾使用固定环境和合成收据验证示例脚本可以返回金额；这只是一次运行记录，不能代表所有图片和运行环境的准确率。请保留依赖版本、模型 ID、提示词和原图以便复现。