dreamtalk

环境要求

• 已安装 Conda（conda 命令可用）
• Python 3.7.0（README 指定版本）
• 支持 CUDA 11.1 的 NVIDIA GPU 环境（README 安装 cudatoolkit=11.1）
• 磁盘空间用于存放依赖与模型权重

安装与启动步骤

1. 1创建 Conda 环境

   按 README 指定版本创建名为 dreamtalk 的独立环境，Python 版本必须是 3.7.0，避免与其他项目依赖冲突。

   conda create -n dreamtalk python=3.7.0

   复制

2. 2激活环境

   后续所有安装命令都要在 dreamtalk 环境中执行，若中途换终端需重新激活。

   conda activate dreamtalk

   复制

3. 3安装基础依赖

   在项目根目录执行，安装 requirements.txt 中列出的 Python 依赖包。需先克隆或下载项目源码。

   pip install -r requirements.txt

   复制

4. 4安装 PyTorch 与 CUDA

   通过 conda 安装 README 指定的 PyTorch 1.8.0、torchvision 0.9.0、torchaudio 0.8.0 及 cudatoolkit 11.1，注意要带 -c pytorch -c conda-forg

   conda install pytorch==1.8.0 torchvision==0.9.0 torchaudio==0.8.0 cudatoolkit=11.1 -c pytorch -c conda-forge

   复制

5. 5更新 ffmpeg

   README 要求用 conda 更新 ffmpeg，用于后续音视频文件的读取与处理。

   conda update ffmpeg

   复制

6. 6安装指定版本库

   分别固定安装 urllib3 1.26.6、transformers 4.28.1 和 dlib，版本不能随意升级，否则可能不兼容。

   pip install urllib3==1.26.6
   pip install transformers==4.28.1
   pip install dlib

   复制

7. 7申请模型权重

   官方已停止公开下载 checkpoint，需发邮件到 mayf18@mails.tsinghua.edu.cn 申请，发信即表示同意使用方法。

如何确认成功

README 未提供启动命令；确认 conda activate dreamtalk 可正常激活、各依赖安装无报错，且已获得官方 checkpoint 授权。

常见问题

注意事项

• checkpoint 已停止公开下载，必须邮件申请，且发信即视为同意官方使用方法。
• README 节选中未给出推理/运行命令，安装完成后如何生成视频请以官方仓库后续文档为准。
• PyTorch、transformers、urllib3 均锁定了版本号，不要自行升级。
• 安装 dlib 可能耗时较长，请保持网络与编译环境稳定。