项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4792
使用教程
环境要求
- uv 包管理器(README 推荐用 uv 创建干净环境,替代 Conda)
- NVIDIA GPU + CUDA 12(使用 UV_TORCH_BACKEND=cu126)或 CUDA 13(使用 cu130)
- Apple Silicon Mac 走 MLX 安装路线,DGX Spark(GB10/ARM64 + CUDA 13)需源码安装
安装与启动步骤
-
1准备 uv 环境
README 建议用 uv 创建干净的虚拟环境,并说明从 Conda 迁移到 uv 通常安装更快更稳定;README 未给出具体建环境命令。
-
2CUDA 12 安装
在 CUDA 12 环境下安装 FastVideo,UV_TORCH_BACKEND 指定为 cu126,请在已激活的 uv 环境中执行。
UV_TORCH_BACKEND=cu126 uv pip install fastvideo -
3CUDA 13 安装
CUDA 13 用户把后端变量换成 cu130,其余安装方式与 CUDA 12 完全相同。
UV_TORCH_BACKEND=cu130 uv pip install fastvideo -
4Mac 安装 MLX
Apple Silicon 通过 MLX 运行时跑 FastMetal-QAD,需可编辑安装 mlx 附加项,并下载 FastVideo/FastMetal-1.3B-QAD 权重,参考官方 MPS 指南。
uv pip install -e '.[mlx]' -
5DGX 源码安装
DGX Spark(GB10 / ARM64 + CUDA 13)没有预编译 ARM wheel,改用以 cu130 的可编辑源码安装,编译时会顺便构建 CUDA kernel。
UV_TORCH_BACKEND=cu130 uv pip install -e . -
6验证安装
先确认能导入 fastvideo 并检测到 CUDA,再查看命令行帮助,确认安装完整可用。
python -c "import fastvideo, torch; print('cuda', torch.cuda.is_available())" fastvideo --help
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
UV_TORCH_BACKEND | 是 | 指定安装使用的 PyTorch/CUDA 后端,cu126 对应 CUDA 12,cu130 对应 CUDA 13 | cu126 |
如何确认成功
执行 python -c "import fastvideo, torch; print('cuda', torch.cuda.is_available())" 能正常导入并输出 cuda 状态,且 fastvideo --help 能打印
常见问题
Q:应该用 uv 还是 Conda 建环境?
A:README 推荐使用 uv 创建干净环境,并说明如果之前用 Conda,切换到 uv 一般安装更快、更稳定。
Q:CUDA 12 和 CUDA 13 分别怎么装?
A:CUDA 12 执行 UV_TORCH_BACKEND=cu126 uv pip install fastvideo;CUDA 13 把变量改为 UV_TORCH_BACKEND=cu130 即可。
Q:Apple Silicon Mac 上怎么安装?
A:执行 uv pip install -e '.[mlx]',下载 FastVideo/FastMetal-1.3B-QAD 权重,并按官方 Apple Silicon(MPS)安装指南操作。
Q:DGX Spark 为什么不能直接 pip install fastvideo?
A:因为没有预编译的 ARM wheel,需改成 UV_TORCH_BACKEND=cu130 uv pip install -e . 从源码编译 CUDA kernel,另需单独装兼容的 ARM64 FlashAttention wheel。
注意事项
- README 只给出安装与验证命令,更详细的安装说明需查阅官方文档 https://hao-ai-lab.github.io/FastVideo/getting_started/installation/
- Apple Silicon 用户请遵循 MPS 安装指南;DGX Spark 用户请遵循 Spark 安装指南
- 也可把 README 提供的提示词粘贴给 Claude Code、Cursor 等编码代理,自动检测平台并按对应指南安装
- DGX Spark 需要另行获取预编译的 ARM64 FlashAttention wheel
核心亮点
- 统一推理与后训练框架,支持多种视频生成模型的加速与微调,降低使用门槛
- 基于diffusers生态,易于集成现有扩散模型工作流,社区兼容性好
- 提供蒸馏等加速技术,针对视频生成场景优化推理效率,实用性强
不足之处
- 项目较新,文档和社区生态尚在完善中,部分高级功能缺乏详细示例
- 主要依赖特定模型和框架,对非diffusers系模型支持有限
适用场景
- 视频生成模型的快速推理部署,如短视频内容生成
- 对现有视频扩散模型进行后训练优化,提升生成速度
- 研究蒸馏等模型压缩技术在视频生成领域的应用
替代项目
AnimateDiff、VideoCrafter、ModelScope Text-to-Video
上一篇:unsloth
下一篇:MirrorFlow
同类项目推荐
Tutel
开源
让 MoE 大模型训练更快更省显存,支持 FP8/FP4 低精度。
Tutel MoE: Optimized Mixture-of-Experts Library, Support GLM/Kimi/Gpt/DeepSeek/Qwen ···
MLM_Filter
开源
用多模态模型自动筛出高质量图文对,提升训练数据纯净度
Official implementation of our paper "Finetuned Multimodal Language Models are High-···
peft
开源
用极低成本微调大模型,省显存省时间,效果不打折。
PEFT: State-of-the-art Parameter-Efficient Fine-Tuning.
LLM-Finetuning-Toolkit
开源
像写单元测试一样微调大模型,实验更稳更可控。
Toolkit for fine-tuning, ablating and unit-testing open-source LLMs.
mcore-bridge
开源
让 Megatron 像 Transformers 一样简单,直接训 500+ 大模型
MCore-Bridge: Providing Megatron-Core model definitions for state-of-the-art large m···
autogluon
开源
三行代码搞定高精度模型,自动调参集成,省时省力
Fast and Accurate ML in 3 Lines of Code
Long-RL
开源
让强化学习轻松驾驭超长序列,训练更稳更快
Long-RL: Scaling RL to Long Sequences (NeurIPS 2025)
grafting
开源
像嫁接植物一样组合扩散模型架构,快速找到最优设计。
[NeurIPS 2025 Oral] Official Code for Exploring Diffusion Transformer Designs via Gr···
lora-svc
开源
用少量干声克隆歌手音色,轻松实现歌声转换
singing voice change based on whisper, and lora for singing voice clone
