
DeepSeek-VL
看懂图片并回答问题的开源多模态大模型
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4191
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python >= 3.8
- 已安装 pip(用于执行 pip install -e .)
- 按 README 的 Model Download 章节下载好模型权重
安装与启动步骤
-
1克隆项目仓库
从 GitHub 拉取 DeepSeek-VL 源码,pip install -e . 需要在仓库根目录执行。
git clone https://github.com/deepseek-ai/DeepSeek-VL.git -
2进入仓库目录
切换到克隆下来的 DeepSeek-VL 目录,后续安装命令都在这里执行。
cd DeepSeek-VL -
3确认 Python 版本
README 要求在 Python >= 3.8 的环境下操作,版本过低请先升级。
python --version -
4安装项目依赖
在仓库根目录以可编辑模式安装依赖,README 明确给出的唯一安装命令。
pip install -e . -
5准备模型权重
按 README 的 Model Download 章节获取权重;README 未给出具体下载命令,请以官方页面指引为准。
-
6编写推理脚本
参考 README Quick Start 的示例代码,加载模型与 tokenizer,调用 prepare_inputs_embeds 得到图像嵌入。
-
7运行模型生成回答
用 language_model.generate 生成结果,并用 tokenizer.decode 解码后打印。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
max_new_tokens | 否 | 单次生成的最大新 token 数 | 512 |
do_sample | 否 | 是否启用采样;False 为确定性输出 | False |
use_cache | 否 | 是否启用 KV 缓存以加速生成 | True |
如何确认成功
脚本成功打印出 sft_format 对应的提问与 answer 回答文本,即表示模型加载与推理正常。
常见问题
Q:pip install -e . 报错怎么办?
A:先确认 Python >= 3.8,并确保命令是在克隆下来的 DeepSeek-VL 仓库根目录执行(存在 setup.py/pyproject.toml 的那一层)。
Q:模型权重在哪里下载?
A:README 顶部提供 Model Download 章节入口,并给出 HuggingFace 官方页面(deepseek-ai),请从该章节和官方页面获取权重。
Q:有不用本地部署的体验方式吗?
A:README 中提供了 HuggingFace Space 在线 Demo 链接(deepseek-ai/DeepSeek-VL-7B),可直接在浏览器中试用。
Q:生成的回答里带特殊符号怎么办?
A:解码时使用 skip_special_tokens=True,示例代码已这样设置,可过滤掉特殊 token。
注意事项
- README 只给出 pip install -e . 这一条安装命令,未提供 Docker 或 conda 方式,不要自行替换。
- 推理代码需要先完成模型权重加载,显存要求 README 未给出,请以官方页面说明为准。
- 项目包含代码许可证 LICENSE-CODE 与模型许可证 LICENSE-MODEL,商用前请分别阅读。
核心亮点
- 视觉编码器与语言模型深度对齐,细粒度理解能力强
- 支持高分辨率图像输入,细节捕捉更准确
- 提供完整训练和推理代码,便于二次开发
不足之处
- 模型参数量较大,部署资源要求高
- 文档/社区待观察
适用场景
- 图像问答与对话
- 文档图像内容提取
- 多模态研究基准测试
替代项目
LLaVA、Qwen-VL、InternVL
同类项目推荐
GLM-4.5
开源
开箱即用的智能体+推理+编程全能模型,复杂任务一次搞定
GLM-4.5: Agentic, Reasoning, and Coding (ARC) Foundation Models
state-of-open-source-ai
开源
一张图看清开源AI版图,快速把握技术趋势。
:closed_book: Clarity in the current fast-paced mess of Open Source innovation
awesome-claude-fable-5-prompt-va···
开源
一站式掌握 Claude Fable 5 玩法,快速选型不踩坑
Ultimate Claude Fable 5 Guide 2026: Use Cases, Integrations & Benchmarks
fast-stable-diffusion
开源
一键加速 SD 训练与生成,低配也能玩转 DreamBooth
fast-stable-diffusion + DreamBooth
xlstm
开源
让 LSTM 重获新生,长序列建模更快更省
Official repository of the xLSTM.
Taiwan-LLM
开源
让 AI 更懂台湾腔,本地化部署更顺手
Traditional Mandarin LLMs for Taiwan
Large-Language-Models
开源
智能爬虫+知识图谱,让LLM直接吃到结构化知识
xLLM 1.0, smart crawling, knowledge graph discovery.
awesome-vlm-architectures
开源
一张图看懂155+视觉语言模型架构,快速选型不迷路
Curated visual catalog of 200+ vision-language model (VLM/MLLM) architectures: paper···
Time-Series-Reasoning-Survey
开源
一篇综述看懂LLM如何推理时间序列
[TMLR 2026] A Survey of Reasoning and Agentic Systems in Time Series with Large Lang···