
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1700
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 环境(依赖由 pyproject.toml 声明、uv.lock 锁定)
- 已安装 uv 工具(README 使用 uv sync 创建虚拟环境)
- 已克隆 Sa2VA 仓库(后续均在仓库根目录操作)
- HuggingFace token / OpenRouter API key(填入 .env 供脚本自动加载)
安装与启动步骤
-
1克隆仓库
把 Sa2VA 代码库拉到本地并进入仓库根目录,后续所有命令都在根目录执行。
git clone https://github.com/bytedance/Sa2VA.git cd Sa2VA -
2脚本一键配置
在仓库根目录执行 setup_env.sh,传项目名 sa2va 与环境类型。InternVL2.5 或更早的骨干用 legacy。
bash setup_env.sh sa2va legacy -
3手动创建环境
不想用脚本时手动进入项目目录,用 uv sync 按锁定版本安装依赖;--extra 可选 latest 或 legacy。
cd projects/sa2va uv sync --extra=latest -
4激活虚拟环境
回到仓库根目录激活 uv 创建的环境,激活后训练与评测脚本才能找到依赖。
source projects/sa2va/.venv/bin/activate -
5配置密钥文件
复制环境变量模板为 .env,再编辑填入 HuggingFace / OpenRouter 的 token 与 API key,脚本会自动加载。
cp .env.example .env -
6运行训练或评测
在仓库根目录、环境已激活的前提下执行训练/评测命令,具体命令各子项目 README 单独给出。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.env | 是 | 从 .env.example 复制而来,存放 HuggingFace、OpenRouter 等 token 与 API key | cp .env.example .env |
如何确认成功
uv sync 无报错、虚拟环境成功激活(命令行出现 .venv 标识),即环境就绪。
常见问题
Q:setup_env.sh 的两个参数分别代表什么?
A:第一个 sa2va 指项目名,第二个是环境类型;legacy 对应 InternVL2.5 或更早的骨干模型。
Q:uv sync 的 latest 和 legacy 怎么选?
A:使用最新骨干(如 Qwen3-VL、InternVL3)选 --extra=latest;使用 InternVL2.5 或更早版本选 --extra=legacy。
Q:为什么不用 pip install 装依赖?
A:项目用 uv 把依赖视为代码:pyproject.toml 声明、uv.lock 锁定全部传递依赖,一条 uv sync 即可精确复现。
Q:.env 里的密钥会被自动读取吗?
A:会,setup_env.sh 会自动加载根目录下的 .env 文件,因此只需复制模板并填写内容。
注意事项
- 不要手动 pip install,依赖版本由 uv.lock 统一锁定,手动安装容易造成版本漂移
- 激活环境后务必回到仓库根目录再执行训练/评测,各子项目还有自己的专属步骤
- .env 含真实密钥,不要提交到代码仓库
- latest 与 legacy 二选一,混用可能造成依赖冲突
核心亮点
- 集成多种SOTA模型,覆盖图像/视频分割主流任务
- 提供LSVOS冠军方案,实战验证效果强
- 模块化设计,便于扩展和定制
不足之处
- 依赖较多,环境配置可能复杂
- 文档/社区待观察
适用场景
- 学术研究:复现SOTA分割模型,对比实验
- 视频编辑:自动分割视频中的目标对象
- 自动驾驶:理解场景并分割动态物体
替代项目
SEEM、Grounded-SAM、VideoCutLER
上一篇:ha-llmvision
下一篇:PaDT
同类项目推荐
TextGrabber2
开源
菜单栏一点,图片文字秒变可复制文本
Mac menu bar “Copy-to-Action” tool with support for extracting text from images.
scanbot-sdk-example-flutter
开源
Flutter 里几行代码接入文档扫描与 MRZ 识别
Easy-to-use Flutter document scanner and data extraction plugin
Awesome-CVPR2024-Low-Level-Visio···
开源
按任务分类整理CVPR底层视觉论文和代码,找前沿成果快人一步
A Collection of Papers and Codes in CVPR2023/2022 about low level vision
yomihon
开源
看日漫直接 OCR 查词,边读边学不切应用
Free and open source manga reader for Android - now with OCR (text recognition)
SmartJavaAI
开源
Java 开发者福音:一行依赖,离线搞定人脸、OCR、语音等 AI 功能
Java免费离线AI算法工具箱,支持人脸识别,活体检测,表情识别、目标检测、实例分割、行人···
GroundAnything
开源
一个模型并行解码,快速从图里框出目标、文字和界面元素
A 4B diffusion grounding model for fast, precise visual evidence extraction. Unifies···
EgoLife
开源
戴上眼镜录视频,AI帮你回忆和检索生活瞬间
[CVPR 2025] EgoLife: Towards Egocentric Life Assistant
Awesome_Mamba
开源
一网打尽医学影像中的高效状态空间模型研究
Computation-Efficient Era: A Comprehensive Survey of State Space Models in Medical I···
tapnet
开源
在视频里盯住任意一个点,遮挡变形也不丢
Tracking Any Point (TAP)