目次3 セクション
本指南说明如何用 Python 和 Transformers 向一张本地图片提问。可直接下载本站的完整示例脚本；脚本默认使用经过验证的社区转换版本 KamilaMila/FastVLM-0.5B。若要加载 Apple 原始权重，请改用官方代码库的说明 ，不能只替换模型 ID。
先确认运行环境
准备 Python 虚拟环境和支持的 PyTorch 版本。安装 Transformers、Pillow、timm 及脚本所需依赖；具体版本以下载脚本顶部的要求和Transformers FastVLM 文档为准 。首次运行需要从 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 演示或浏览器开发指南。 |
常见问题
如果找不到 FastVLM 类或 timm，先确认当前虚拟环境中安装的是兼容版本，而不是系统中另一套 Python。如果下载中断，重试前检查缓存与磁盘空间；脚本提供关闭 Xet 下载的环境变量用法。出现显存不足时，降低输入图像尺寸、限制生成长度或改用合适的设备。模型输出为空或格式不符合预期时，先用一张简单图片和明确问题验证，再逐步增加任务复杂度。
本站曾使用固定环境和合成收据验证示例脚本可以返回金额；这只是一次运行记录，不能代表所有图片和运行环境的准确率。请保留依赖版本、模型 ID、提示词和原图以便复现。
続きを読む
同じテーマやツールに関連する記事。
関連ツール
この記事のテーマに近いディレクトリ項目を確認できます。
