DreamOmni2

环境要求

• 已安装 Git，可访问 GitHub
• 已安装 Python 与 pip（能执行 pip install）
• 已安装 huggingface-cli（huggingface_hub）用于下载权重
• 磁盘空间充足，用于存放 DreamOmni2 模型权重
• 网络可访问 GitHub 与 Hugging Face

安装与启动步骤

1. 1克隆代码仓库

   从 GitHub 拉取 DreamOmni2 官方代码到本地，README 提供的仓库地址为 dvlab-research/DreamOmni2。

   git clone https://github.com/dvlab-research/DreamOmni2

   复制

2. 2进入项目目录

   切换到刚克隆下来的 DreamOmni2 目录，后续安装与下载都在该目录内执行。

   cd ./DreamOmni2

   复制

3. 3安装 Python 依赖

   按 README 要求安装 requirements.txt 中列出的必要依赖，建议先建好虚拟环境再执行。

   pip install -r requirements.txt

   复制

4. 4下载模型权重

   用 huggingface-cli 把 xiabs/DreamOmni2 权重下载到项目下的 models 目录，README 明确要求放在此目录。

   huggingface-cli download --resume-download --local-dir-use-symlinks False xiabs/DreamOmni2 --local-dir ./models

   复制

5. 5在线体验（可选）

   若只想快速试用，README 提供了 Hugging Face 编辑/生成两个官方 Space，可直接在浏览器中使用。

如何确认成功

克隆后目录内出现 requirements.txt，且 ./models 目录成功下载到 DreamOmni2 权重文件，即表示环境准备完成。

常见问题

注意事项

• README 节选中未给出推理/训练的具体启动命令，相关用法需查看仓库完整文档。
• 模型权重文件较大，下载耗时较长，请预留足够的磁盘空间与时间。
• 官方同时提供 Hugging Face Space 在线 Demo，可作为本地部署前的快速验证方式。
• 安装依赖建议在独立虚拟环境中进行，避免污染系统 Python 环境。