MuseV

环境要求

• 支持 CUDA 的 NVIDIA GPU（启动命令使用 --gpus all）
• 已安装 Docker，并配置好 NVIDIA Container Toolkit 以便容器内调用 GPU
• 如不使用 Docker，需自行准备 Python 环境（README 未指定具体版本）
• 镜像内默认 conda 环境名为 musev

安装与启动步骤

1. 1拉取镜像

   从 Docker Hub 拉取官方 MuseV 镜像，latest 标签即最新版本。

   docker pull anchorxia/musev:latest

   复制

2. 2启动容器

   以交互方式进入容器；--gpus all 让容器使用全部 GPU，否则无法加速。

   docker run --gpus all -it --entrypoint /bin/bash anchorxia/musev:latest

   复制

3. 3激活环境

   镜像内默认 conda 环境名为 musev，进入容器后激活它再运行代码。

   conda activate musev

   复制

4. 4本地装依赖

   不用 Docker 时，README 要求准备 Python 环境并安装这些额外包（未给出版本号）。

   pip install diffusers controlnet_aux mmcm

   复制

如何确认成功

进入容器后执行 conda activate musev 无报错，即表示镜像与运行环境已就绪；README 未提供推理启动命令。

常见问题

注意事项

• 本教程仅依据 README 节选中出现的内容整理，模型权重下载与推理参数请以仓库完整文档为准。
• 启动容器必须带 --gpus all，否则容器内无法使用 GPU。
• MuseV 可与同团队的 MuseTalk（唇形同步）、MusePose（姿态驱动）配合组成完整虚拟人方案。