3 步在本地跑通 Open-Sora 视频生成:新手完整安装指南

发布时间:2026/9/3 11:16:07
3 步在本地跑通 Open-Sora 视频生成:新手完整安装指南
3 步在本地跑通 Open-Sora 视频生成新手完整安装指南【免费下载链接】Open-SoraOpen-Sora: Democratizing Efficient Video Production for All项目地址: https://gitcode.com/GitHub_Trending/op/Open-SoraOpen-Sora 是一个开源的视频生成项目输入一句文字或一张图片它能产出 2 秒到 15 秒、分辨率从 256px 到 768px 的视频。如果你有一块 NVIDIA 显卡、平时会敲几条终端命令跟着这篇文章走一遍就能在本地生成自己的第一段 AI 视频。 装完之后你能做什么先说清楚这个工具的实际产出避免装完不知道拿它干什么文生视频输入 raining, sea 这样的短句得到一个 mp4。模型默认推荐走「文字→图片→视频」的两段式管线用 Flux 文生图模型先出一张高质量首帧再由视频扩散模型把它演起来。图生视频给一张参考图加一段描述它会基于这张图生成动态视频。仓库自带了示例参考图 assets/texts/i2v.png 和对应提示词 assets/texts/i2v.csv可以直接拿来试。可控参数宽高比可选16:9、9:16、1:1、2.39:1帧数需满足4k1且小于 129对应 2 秒到约 8 秒16fps。 环境清单装之前对着这张表核对自己的机器推荐值直接照抄即可项目推荐值说明操作系统LinuxUbuntu 18.04官方验证环境Python3.10用 conda 建独立环境隔离PyTorch2.4.0需与 CUDA 版本配套GPUNVIDIA 显卡建议 24GB 显存起步768px 单卡峰值约 60GB显存小的卡请开 offload 或走 256px 配置显存优化库xformers 0.0.27.post2 flash-attn需按自己的 CUDA 版本选对应 wheel️ 部署实战整个安装分三个阶段搭环境、装代码和依赖、下载模型全部完成后再跑首次生成。阶段一搭环境。建一个干净的 conda 环境避免依赖污染系统 Python。conda create -n opensora python3.10 conda activate opensora阶段二拉代码装依赖。克隆仓库后pip install -v .会按 requirements.txt 装好 PyTorch 2.4.0、ColossalAI 等全部基础包xformers 和 flash-attn 是加速注意力计算的组件按你机器的 CUDA 版本选 wheel下面是 cu121 的写法。git clone https://gitcode.com/GitHub_Trending/op/Open-Sora cd Open-Sora pip install -v . pip install xformers0.0.27.post2 --index-url https://download.pytorch.org/whl/cu121 pip install flash-attn --no-build-isolation阶段三下载模型权重。11B 的 v2 模型同时支持文生视频和图生视频约几十 GB用官方 CLI 拉到本地./ckpts目录。pip install huggingface_hub[cli] huggingface-cli download hpcai-tech/Open-Sora-v2 --local-dir ./ckpts✅ 首次生成与跑通验证装完后用 256px 的低分辨率配置做第一次生成单卡即可torchrun --nproc_per_node 1 --standalone scripts/diffusion/inference.py configs/diffusion/inference/t2i2v_256px.py --save-dir samples --prompt raining, sea这条命令做的事启动单进程推理加载./ckpts里的模型先出首帧图、再生成视频。跑通后终端会打印Inference finished.生成的 mp4 落在samples/目录下的video_256px/子文件夹里——文件出现即为成功。另外可以随时用python -c import opensora快速确认依赖装对了。⚡ 进阶调优跑通之后常用的几个开关显存不够命令末尾加--offload True推理时把用不到的模型挪到内存256px 单卡约可省一半峰值显存。多卡加速把--nproc_per_node 1改成 8 并换用 configs/diffusion/inference/t2i2v_768px.py序列并行下 768px 单卡约 1656 秒、8 卡约 276 秒H100 官方数据。调整画幅和时长--aspect_ratio 9:16、--num_frames 49。批量生成--dataset.data-path assets/texts/example.csv仓库自带示例 csv。控制动作幅度--motion-score 4默认值数值越大画面动得越猛。结果可复现加--sampling_option.seed 42 --seed 42。❓ 常见问题症状flash-attn 安装直接报错或编译半天。原因没有匹配当前 PyTorch/CUDA 组合的预编译包。 解法确认 torch 与 CUDA 版本配套如 2.4.0 cu121保留--no-build-isolation让它本地编译。症状推理时报 CUDA OOM。原因显存低于该分辨率的峰值需求768px 单卡峰值约 60GB。 解法加--offload True或换 256px 配置、增加显卡数量。症状xformers 与 torch 版本不兼容。原因装错 CUDA 版本的 wheel。 解法按 torch 的 CUDA 版本重新选--index-urlcu118/cu121/cu124重装 xformers。症状生成速度远超官方数据。原因官方耗时基于 H100/H800消费级显卡慢数倍属正常现象。 解法耐心等或降分辨率、减少帧数。下一步想训练或微调自己的模型从 docs/train.md 的逐步教程入手想了解架构与实验细节可读 docs/report_04.md 等历版技术报告。项目仍在积极迭代建议关注仓库 main 分支获取新版模型与配置。【免费下载链接】Open-SoraOpen-Sora: Democratizing Efficient Video Production for All项目地址: https://gitcode.com/GitHub_Trending/op/Open-Sora创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考