# MuseTalk-50Series-Adaptation

**Repository Path**: Wilson_Lws/MuseTalk-50Series-Adaptation

## Basic Information

- **Project Name**: MuseTalk-50Series-Adaptation
- **Description**: MuseTalk 50系列显卡适配教程
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-05-29
- **Last Updated**: 2025-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MuseTalk-50Series-Adaptation

#### 介绍
MuseTalk 50系列显卡适配教程，win11环境，conda


#### 安装教程

1. 构建环境

```
conda create -n MuseTalk python==3.10
conda activate MuseTalk
```

2. 安装PyTorch 2.7 + cu12.8

```
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128
```

3. 安装依赖

```
pip install -r requirements.txt
```

4. 安装 MMLab 包

```
pip install --no-cache-dir -U openmim
mim install mmengine
mim install "mmcv-full==1.7.2"
mim install "mmdet==3.2.0"
mim install "mmpose==1.3.2"
```

5. 修改 mmdet 和 mmpose 版本校验

    从 anaconda3\envs\MuseTalk\Lib\site-packages\mmdet 和 anaconda3\envs\MuseTalk\Lib\site-packages\mmpose 目录中找到 __init__.py，修改

    `mmcv_minimum_version = '1.7.2'`

6. 修改 mmengine 代码

    从 anaconda3\envs\MuseTalk\Lib\site-packages\mmengine\runner 目录下找到 checkpoint.py，修改第347行
    
    `checkpoint = torch.load(filename, map_location=map_location, weights_only=False)`

7. 为1.7.2版本的 mmcv 添加最新版的 transforms 模块
    
    下载 https://github.com/open-mmlab/mmcv 源码， 将 mmcv/transforms 文件夹拷贝到 anaconda3\envs\mmcv\Lib\site-packages\mmcv 目录下

8. 安装 ffmpeg，下载权重模型（略，参考官网）

9. 至此项目就可以跑起来了，使用命令 `python app.py` 可以启动 Web 页面，如果运行中报了 `weights_only` 的错，可以参考第6条，找到报错文件的 `torch.load` 方法，加一个 `weights_only=False` 参数即可