Files
product/environments.md
2026-03-27 10:49:34 +08:00

199 lines
6.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 已配置环境与已下载模型清单
> 最后更新:2026-03-25
> 机器:WSL2, RTX 5090, CUDA 12.9
---
## 一、Conda 环境总览
```
conda env list
```
| 环境名 | 路径 | 用途 | 磁盘占用 |
|--------|------|------|---------|
| `LivePortrait` | `/home/xsl/miniconda3/envs/LivePortrait` | 头部动作驱动 | 8.6GB |
| `MuseTalk` | `/home/xsl/miniconda3/envs/MuseTalk` | 唇形同步(主力) | 11GB |
| `latentsync` | `/home/xsl/miniconda3/envs/latentsync` | 唇形同步(备用) | 9.2GB |
| `condiff-train-hair` | `/home/xsl/miniconda3/envs/condiff-train-hair` | 其他项目(未动) | — |
| `onediff` | `/home/xsl/miniconda3/envs/onediff` | 其他项目(未动) | — |
| `vllm-qwen3` | `/home/xsl/miniconda3/envs/vllm-qwen3` | 其他项目(未动) | — |
| `py310` | `/home/xsl/miniconda3/envs/py310` | 通用 Python 3.10 | — |
---
## 二、LivePortrait 环境
**激活**`conda activate LivePortrait`
### 关键包版本
| 包 | 版本 |
|----|------|
| torch | `2.12.0.dev20260324+cu128`nightly |
| CUDA | 12.8 |
### 已下载权重
位置:`/home/xsl/work/LivePortrait/pretrained_weights/`(总计 **1.2GB**
```
pretrained_weights/
├── insightface/
│ └── models/buffalo_l/
│ ├── 2d106det.onnx (4.8MB) 人脸关键点检测
│ └── det_10g.onnx (17MB) 人脸检测
├── liveportrait/
│ ├── base_models/
│ │ ├── appearance_feature_extractor.pth (3.3MB)
│ │ ├── motion_extractor.pth (108MB)
│ │ ├── spade_generator.pth (212MB)
│ │ └── warping_module.pth (174MB)
│ ├── retargeting_models/
│ │ └── stitching_retargeting_module.pth (2.3MB)
│ └── landmark.onnx (110MB)
└── liveportrait_animals/
├── base_models/ (同上,动物版)
└── base_models_v1.1/
└── appearance_feature_extractor.pth (3.3MB)
```
**来源**`hf download KlingTeam/LivePortrait --local-dir pretrained_weights`
---
## 三、MuseTalk 环境
**激活**`conda activate MuseTalk`
### 关键包版本
| 包 | 版本 | 备注 |
|----|------|------|
| torch | `2.12.0.dev20260324+cu128` | nightlysm_120 必须 |
| mmcv | `2.1.0` | 从源码编译,需要 nvcc |
| mmdet | `3.3.0` | ≥3.3.0 才兼容 mmcv 2.1.0 |
| mmpose | `1.3.2` | ≥1.3.0 才兼容 mmcv 2.1.0 |
| transformers | `5.3.0` | ≥4.45.0 才兼容 huggingface_hub 1.x |
| huggingface_hub | `1.7.2` | CLI 命令名为 `hf` |
| diffusers | `0.32.2` | |
### 已下载权重
位置:`/home/xsl/work/MuseTalk/models/`(总计 **5.5GB**
```
models/
├── musetalkV15/
│ ├── unet.pth (3.2GB) 主模型
│ └── musetalk.json 模型配置
├── sd-vae/
│ ├── diffusion_pytorch_model.bin (320MB) VAE 解码器
│ └── config.json
├── dwpose/
│ └── dw-ll_ucoco_384.pth (389MB) 姿态估计(DWPose
├── whisper/
│ ├── pytorch_model.bin (145MB) 音频特征提取
│ ├── config.json
│ └── preprocessor_config.json
├── syncnet/
│ └── latentsync_syncnet.pt (1.4GB) 唇形同步评估
└── face-parse-bisent/
├── 79999_iter.pth (51MB) 人脸解析
└── resnet18-5c106cde.pth (45MB) backbone
```
**来源**
- `musetalkV15``hf download TMElyralab/MuseTalk`
- `sd-vae``hf download stabilityai/sd-vae-ft-mse`
- `dwpose``hf download yzd-v/DWPose`
- `whisper``hf download openai/whisper-tiny`
- `syncnet``hf download ByteDance/LatentSync`
- `face-parse-bisent` → gdown (Google Drive) + pytorch.org
---
## 四、LatentSync 环境
**激活**`conda activate latentsync`
### 关键包版本
| 包 | 版本 |
|----|------|
| torch | `2.12.0.dev20260324+cu128`nightly |
| diffusers | `0.32.2` |
### 已下载权重
位置:`/home/xsl/work/LatentSync/checkpoints/`(总计 **5.4GB**
```
checkpoints/
├── latentsync_unet.pt (4.8GB) 主扩散模型
├── whisper/
│ └── tiny.pt (73MB) Whisper 音频编码器
└── auxiliary/
└── models/buffalo_l/ (约330MB) insightface 人脸模型
├── 1k3d68.onnx (137MB)
├── 2d106det.onnx (4.8MB)
├── det_10g.onnx (17MB)
├── genderage.onnx (1.3MB)
└── w600k_r50.onnx (167MB)
```
**来源**
- `latentsync_unet.pt``hf download ByteDance/LatentSync-1.6`
- `whisper/tiny.pt``hf download ByteDance/LatentSync-1.6`
- `buffalo_l` → 运行时自动下载(insightface
---
## 五、磁盘占用汇总
| 类别 | 路径 | 大小 |
|------|------|------|
| LivePortrait 权重 | `work/LivePortrait/pretrained_weights` | 1.2GB |
| LatentSync 权重 | `work/LatentSync/checkpoints` | 5.4GB |
| MuseTalk 权重 | `work/MuseTalk/models` | 5.5GB |
| **模型合计** | | **~12GB** |
| LivePortrait conda 环境 | `envs/LivePortrait` | 8.6GB |
| MuseTalk conda 环境 | `envs/MuseTalk` | 11GB |
| latentsync conda 环境 | `envs/latentsync` | 9.2GB |
| **环境合计** | | **~29GB** |
---
## 六、产品新环境建议
如果要为产品重建一套干净环境,**最小必要集合**是:
```bash
# 一个统一环境(避免两套 conda env 切换)
conda create -n digital-human python=3.10
conda activate digital-human
conda install -y -c conda-forge ffmpeg
# PyTorch nightlyRTX 5090 必须)
pip install --pre torch torchvision torchaudio \
--index-url https://download.pytorch.org/whl/nightly/cu128
# LivePortrait 依赖
pip install -r /home/xsl/work/LivePortrait/requirements.txt
# MuseTalk 依赖(含 MMLab 完整链)
pip install -r /home/xsl/work/MuseTalk/requirements.txt
pip install --no-build-isolation chumpy
pip install mmengine
MMCV_WITH_OPS=1 pip install mmcv==2.1.0 --no-build-isolation
pip install "mmdet>=3.3.0" "mmpose>=1.3.0"
pip install xtcocotools json-tricks munkres
pip install "transformers>=4.45.0"
```
**可复用的模型权重**(无需重新下载):
- LivePortrait`/home/xsl/work/LivePortrait/pretrained_weights/` — 直接用
- MuseTalk`/home/xsl/work/MuseTalk/models/` — 直接用
- LatentSync(如需):`/home/xsl/work/LatentSync/checkpoints/` — 直接用