# ComfyUI-RH-daVinci-MagiHuman INT8

[![RunningHub China](https://img.shields.io/badge/RunningHub-China-2F80ED)](https://www.runninghub.cn/?inviteCode=rh-v1367)
[![RunningHub International](https://img.shields.io/badge/RunningHub-International-7B61FF)](https://www.runninghub.ai/?inviteCode=rh-v1367)
[![English](https://img.shields.io/badge/Language-English-2563EB)](./README.md)
[![简体中文](https://img.shields.io/badge/Language-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-EF4444)](./README_CN.md)

面向 [ComfyUI-RH-daVinci-MagiHuman](https://github.com/RH-RunningHub/ComfyUI-RH-daVinci-MagiHuman)
的 daVinci-MagiHuman INT8 量化 DiT 与超分权重。本仓库只包含 4 个转换后的
`.pt` 文件。TurboVAE、T5 文本编码器以及视频/音频 VAE 仍需从官方仓库另行下载。

ComfyUI 节点直接加载这些 INT8 文件，不需要官方 BF16 DiT shard，也不需要官方
`540p_sr/`、`1080p_sr/` 配置目录。

完整快照约 **57 GiB**。按需下载即可。

镜像：[Hugging Face](https://huggingface.co/Gluttony10/ComfyUI-RH-daVinci-MagiHuman) /
[ModelScope](https://www.modelscope.cn/models/Gluttony10/ComfyUI-RH-daVinci-MagiHuman)

## 内容清单

| 文件 | 大小 | 用途 |
|---|---:|---|
| `base_int8.pt` | 14.25 GiB | INT8 Base DiT（32 步，画质更高） |
| `distill_int8.pt` | 14.25 GiB | INT8 Distill DiT（8 步，更快） |
| `sr_540p_sr_int8.pt` | 14.25 GiB | 可选 INT8 540p 超分 |
| `sr_1080p_sr_int8.pt` | 14.25 GiB | 可选 INT8 1080p 超分 |

`base_int8.pt` 与 `distill_int8.pt` **任选其一**即可运行。只有加载节点的
`sr_model` 设为 `540p_sr` 或 `1080p_sr` 时，才需要对应的 SR 文件。

## 安装到 ComfyUI

```text
ComfyUI/models/MagiHuman/
├── base_int8.pt
├── distill_int8.pt
├── sr_540p_sr_int8.pt          # 可选
└── sr_1080p_sr_int8.pt         # 可选
```

### Hugging Face

```bash
cd /path/to/ComfyUI
python3 -m pip install -U huggingface_hub

hf download Gluttony10/ComfyUI-RH-daVinci-MagiHuman base_int8.pt \
  --local-dir ./models/MagiHuman
hf download Gluttony10/ComfyUI-RH-daVinci-MagiHuman distill_int8.pt \
  --local-dir ./models/MagiHuman
hf download Gluttony10/ComfyUI-RH-daVinci-MagiHuman sr_540p_sr_int8.pt \
  --local-dir ./models/MagiHuman
hf download Gluttony10/ComfyUI-RH-daVinci-MagiHuman sr_1080p_sr_int8.pt \
  --local-dir ./models/MagiHuman
```

### ModelScope

```bash
pip install modelscope
cd /path/to/ComfyUI
modelscope download --model Gluttony10/ComfyUI-RH-daVinci-MagiHuman base_int8.pt \
  --local_dir ./models/MagiHuman
modelscope download --model Gluttony10/ComfyUI-RH-daVinci-MagiHuman distill_int8.pt \
  --local_dir ./models/MagiHuman
modelscope download --model Gluttony10/ComfyUI-RH-daVinci-MagiHuman sr_540p_sr_int8.pt \
  --local_dir ./models/MagiHuman
modelscope download --model Gluttony10/ComfyUI-RH-daVinci-MagiHuman sr_1080p_sr_int8.pt \
  --local_dir ./models/MagiHuman
```

## 其它必需资源

以下文件**不在**本仓库中：

```bash
# 官方 MagiHuman 资源（TurboVAE、T5 文本编码器）
hf download GAIR/daVinci-MagiHuman --local-dir ./models/MagiHuman
pip install modelscope
modelscope download --model GAIR/daVinci-MagiHuman --local_dir ./models/MagiHuman

# 外部 VAE
hf download stabilityai/stable-audio-open-1.0 \
  --local-dir ./models/audio_checkpoints/stable-audio-open-1.0
hf download Wan-AI/Wan2.2-TI2V-5B \
  --local-dir ./models/Ovi/Wan2.2-TI2V-5B
```

全部就位后的目录：

```text
ComfyUI/models/
├── MagiHuman/
│   ├── base_int8.pt
│   ├── distill_int8.pt
│   ├── sr_540p_sr_int8.pt
│   ├── sr_1080p_sr_int8.pt
│   ├── t5gemma-9b-9b-ul2/
│   └── turbo_vae/
├── audio_checkpoints/stable-audio-open-1.0/
└── Ovi/Wan2.2-TI2V-5B/
```

## 插件

当前插件仓库：[RH-RunningHub/ComfyUI-RH-daVinci-MagiHuman](https://github.com/RH-RunningHub/ComfyUI-RH-daVinci-MagiHuman)

| 节点 | 用途 |
|---|---|
| `RH MagiHuman Model Loader` (`RH_MagiHumanModelLoader`) | 加载 INT8 DiT、VAE 和可选 SR |
| `RH MagiHuman Generate` (`RH_MagiHumanGenerate`) | 根据参考图和文本生成说话人视频 |

加载节点选项：

- `model_type`：`base`（32 步）或 `distill`（8 步）
- `vram_mode`：`mid_vram`（约 16 GB）或 `low_vram`（约 6.5 GB）
- `sr_model`：`none` / `540p_sr` / `1080p_sr`

`mid_vram` + 540p SR 大约需要 24 GB；`mid_vram` + 1080p SR 大约需要 48 GB。

## 许可证

转换权重遵循上游
[daVinci-MagiHuman](https://huggingface.co/GAIR/daVinci-MagiHuman) 的
[Apache-2.0](https://opensource.org/licenses/Apache-2.0) 许可证。

## 相关链接

[![RunningHub China](https://img.shields.io/badge/RunningHub-China-2F80ED)](https://www.runninghub.cn/?inviteCode=rh-v1367)
[![RunningHub International](https://img.shields.io/badge/RunningHub-International-7B61FF)](https://www.runninghub.ai/?inviteCode=rh-v1367)

- [daVinci-MagiHuman 官方项目](https://github.com/GAIR-NLP/daVinci-MagiHuman)
- [官方权重](https://huggingface.co/GAIR/daVinci-MagiHuman)
- [官方资源 ModelScope](https://www.modelscope.cn/models/GAIR/daVinci-MagiHuman)
- [ComfyUI-RH-daVinci-MagiHuman](https://github.com/RH-RunningHub/ComfyUI-RH-daVinci-MagiHuman)