Upload 2 files

README.md

@@ -1,3 +1,192 @@
 ---
 license: apache-2.0
+library_name: comfyui
+base_model: GAIR/daVinci-MagiHuman
+pipeline_tag: image-to-video
+language:
+  - en
+  - zh
+  - ja
+  - ko
+  - de
+  - fr
+  - yue
+tags:
+  - comfyui
+  - image-to-video
+  - image-text-to-audio-video
+  - multimodal
+  - int8
 ---
+
+# 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)
+
+INT8-quantised daVinci-MagiHuman DiT and super-resolution weights for
+[ComfyUI-RH-daVinci-MagiHuman](https://github.com/RH-RunningHub/ComfyUI-RH-daVinci-MagiHuman).
+This repository contains only the four converted `.pt` files. TurboVAE, the
+T5 text encoder, and the video/audio VAEs still come from the official
+releases.
+
+The ComfyUI nodes load these INT8 files directly. Official BF16 DiT shards and
+official `540p_sr/` / `1080p_sr/` config directories are not required.
+
+Full snapshot is about **57 GiB**. Download only the files you need.
+
+Mirror: [Hugging Face](https://huggingface.co/Gluttony10/ComfyUI-RH-daVinci-MagiHuman) /
+[ModelScope](https://www.modelscope.cn/models/Gluttony10/ComfyUI-RH-daVinci-MagiHuman)
+
+## Run Online and API Access
+
+If you do not want to download and configure the full model assets locally, you can first try related MagiHuman workflows online on RunningHub, or integrate RunningHub AI app / workflow APIs into your own product.
+
+- [RunningHub](https://www.runninghub.ai)
+- [RunningHub China](https://www.runninghub.cn)
+- [RunningHub API](https://www.runninghub.ai/call-api)
+- [RunningHub API Documentation](https://www.runninghub.cn/runninghub-api-doc-en/)
+- [RunningHub API Docs CN](https://www.runninghub.cn/runninghub-api-doc-cn/)
+- [ComfyUI-RH-daVinci-MagiHuman Plugin](https://github.com/RH-RunningHub/ComfyUI-RH-daVinci-MagiHuman)
+
+RunningHub is useful for quickly validating workflows such as reference-image-to-talking-head video, digital human video, and AI presenter / spokesperson video generation. You can first run and tune the workflow online, then choose local deployment if needed, or integrate similar capabilities into your product through RunningHub API.
+
+> Want to try it quickly? Open [RunningHub](https://www.runninghub.ai) to explore runnable AI workflows. Want to integrate digital human / talking-head video generation into your product? Start with the [RunningHub API Documentation](https://www.runninghub.cn/runninghub-api-doc-en/).
+
+RunningHub API supports model APIs, AI app APIs, workflow APIs, and LLM APIs. For MagiHuman-style video generation workflows, the recommended task flow is:
+
+```text
+Submit task -> get taskId -> check task status -> retrieve generated result
+```
+
+Recommended use cases:
+
+- Run daVinci-MagiHuman / MagiHuman talking-head video generation workflows online
+- Add reference-image-to-video, digital human presenter, and AI video generation capabilities to your product
+- Provide creators, developers, and teams with no-local-setup generative AI workflows
+- Build automated video generation, content production, or multimodal applications with RunningHub API
+
+## Contents
+
+| File | Size | Role |
+|---|---:|---|
+| `base_int8.pt` | 14.25 GiB | INT8 Base DiT (32 steps, higher quality) |
+| `distill_int8.pt` | 14.25 GiB | INT8 Distill DiT (8 steps, faster) |
+| `sr_540p_sr_int8.pt` | 14.25 GiB | Optional INT8 540p super-resolution |
+| `sr_1080p_sr_int8.pt` | 14.25 GiB | Optional INT8 1080p super-resolution |
+
+You need **one** of `base_int8.pt` / `distill_int8.pt`. Add an SR file only
+when the loader's `sr_model` is `540p_sr` or `1080p_sr`.
+
+## Install into ComfyUI
+
+```text
+ComfyUI/models/MagiHuman/
+├── base_int8.pt
+├── distill_int8.pt
+├── sr_540p_sr_int8.pt          # optional
+└── sr_1080p_sr_int8.pt         # optional
+```
+
+### 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
+```
+
+## Other required assets
+
+These files are **not** in this repository:
+
+```bash
+# Official MagiHuman assets (TurboVAE, T5 text encoder)
+hf download GAIR/daVinci-MagiHuman --local-dir ./models/MagiHuman
+pip install modelscope
+modelscope download --model GAIR/daVinci-MagiHuman --local_dir ./models/MagiHuman
+
+# External VAEs
+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
+```
+
+Expected layout after everything is in place:
+
+```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/
+```
+
+## Plugin
+
+Current plugin: [RH-RunningHub/ComfyUI-RH-daVinci-MagiHuman](https://github.com/RH-RunningHub/ComfyUI-RH-daVinci-MagiHuman)
+
+| Node | Purpose |
+|---|---|
+| `RH MagiHuman Model Loader` (`RH_MagiHumanModelLoader`) | Load INT8 DiT, VAEs, and optional SR |
+| `RH MagiHuman Generate` (`RH_MagiHumanGenerate`) | Talking-head video from a reference image and text prompt |
+
+Loader options:
+
+- `model_type`: `base` (32 steps) or `distill` (8 steps)
+- `vram_mode`: `mid_vram` (~16 GB) or `low_vram` (~6.5 GB)
+- `sr_model`: `none` / `540p_sr` / `1080p_sr`
+
+`mid_vram` + 540p SR needs about 24 GB. `mid_vram` + 1080p SR needs about 48 GB.
+
+## License
+
+Converted weights follow the upstream
+[Apache-2.0](https://opensource.org/licenses/Apache-2.0) license of
+[daVinci-MagiHuman](https://huggingface.co/GAIR/daVinci-MagiHuman).
+
+## Links
+
+[![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)
+
+- [RunningHub](https://www.runninghub.ai)
+- [RunningHub China](https://www.runninghub.cn)
+- [RunningHub API](https://www.runninghub.ai/call-api)
+- [RunningHub API Documentation](https://www.runninghub.cn/runninghub-api-doc-en/)
+- [TokenPlus](https://tokenplus.net/)
+- [Official daVinci-MagiHuman](https://github.com/GAIR-NLP/daVinci-MagiHuman)
+- [Official weights](https://huggingface.co/GAIR/daVinci-MagiHuman)
+- [Official assets on ModelScope](https://www.modelscope.cn/models/GAIR/daVinci-MagiHuman)
+- [ComfyUI-RH-daVinci-MagiHuman](https://github.com/RH-RunningHub/ComfyUI-RH-daVinci-MagiHuman)

README_CN.md

@@ -0,0 +1,168 @@
+# 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)
+
+## 在线运行与 API 接入
+
+如果你不想在本地下载和配置完整模型资源，可以先通过 RunningHub 在线体验相关 MagiHuman 工作流，或将 RunningHub 的 AI 应用 / 工作流 API 集成到自己的产品中。
+
+- [RunningHub 在线体验](https://www.runninghub.ai)
+- [RunningHub 中国站](https://www.runninghub.cn)
+- [RunningHub API 文档](https://www.runninghub.cn/runninghub-api-doc-cn/)
+- [RunningHub API Documentation](https://www.runninghub.cn/runninghub-api-doc-en/)
+- [ComfyUI-RH-daVinci-MagiHuman 插件](https://github.com/RH-RunningHub/ComfyUI-RH-daVinci-MagiHuman)
+
+RunningHub 适合用于快速验证参考图生成说话人视频、数字人视频、AI 口播视频等工作流效果。用户可以先在线运行和调试工作流，再根据需要选择本地部署，或通过 RunningHub API 将同类能力接入自己的产品。
+
+> 想快速体验效果？点击 [RunningHub 在线体验](https://www.runninghub.ai) 查看可运行的 AI 工作流。想把数字人 / 说话人视频生成能力接入产品？查看 [RunningHub API 文档](https://www.runninghub.cn/runninghub-api-doc-cn/) 开始集成。
+
+RunningHub API 支持模型 API、AI 应用 API、工作流 API 和 LLM API。对于 MagiHuman 这类视频生成工作流，推荐使用任务型调用流程：
+
+```text
+提交任务 → 获取 taskId → 查询任务状态 → 获取生成结果
+```
+
+适合的使用场景：
+
+- 在线运行 daVinci-MagiHuman / MagiHuman 说话人视频生成工作流
+- 将参考图生成视频、数字人口播、AI 视频生成能力接入自己的产品
+- 为创作者、开发者和团队提供免本地部署的生成式 AI 工作流
+- 基于 RunningHub API 构建自动化视频生成、内容生产或多模态应用
+
+## 内容清单
+
+| 文件 | 大小 | 用途 |
+|---|---:|---|
+| `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)
+
+- [RunningHub](https://www.runninghub.ai)
+- [RunningHub 中国站](https://www.runninghub.cn)
+- [RunningHub API](https://www.runninghub.ai/call-api)
+- [RunningHub API Documentation](https://www.runninghub.cn/runninghub-api-doc-en/)
+- [TokenPlus](https://tokenplus.net/)
+- [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)