ComfyUI-UniRig
使用 UniRig 自动提取 ComfyUI 骨架 (SIGGRAPH 2025)。独立包含捆绑的 Blender 和 UniRig 代码。
绑定你的角色网格并为其蒙皮！
改变他们的姿势，导出一个新姿势
# 视频演示
装配/蒙皮工作流程（出于记录目的，视频已加速）：
操作/保存/导出：
https://github.com/user-attachments/assets/f320db66-4323-4993-a46e-87e2717748ef
# 可用节点
# 模型装载机
- UniRig：加载骨架模型 - 从 HuggingFace 加载骨架提取模型
- UniRig：加载蒙皮模型 - 从 HuggingFace 加载蒙皮权重模型
# 网状输入/输出
- UniRig：加载网格 - 加载 3D 网格文件（OBJ、FBX、GLB 等）
- UniRig：保存网格 - 将网格保存到文件
# 骨骼提取
- UniRig：提取骨架 - 使用 ML 从任何 3D 网格中提取骨架
- 输入：TRIMESH网格、骨架模型
- 输出：标准化骨架、标准化网格、纹理预览
- 骨架模板：选择
auto（型号决定），vroid（VRoid 兼容 52 骨命名），或articulationxl（通用/灵活）
# 剥皮
- UniRig：应用蒙皮 - 将基于 ML 的蒙皮权重应用于网格
- 输入：标准化网格、骨架、蒙皮模型
- 输出：带有骨架和权重的装配网格
# 骨架 I/O 和导出
- UniRig：保存骨架 - 将骨架保存到 JSON 文件
- UniRig：加载 Rigged Mesh - 加载带有骨架的 Rigged FBX 文件
- UniRig：预览 Rigged Mesh - 生成 Rigged 网格的预览图像
- UniRig：导出姿势 FBX - 将具有自定义姿势的装备网格导出到 FBX/GLB
# 特征
- 最先进：基于 UniRig (SIGGRAPH 2025)
- 独立：捆绑 UniRig 代码和自动安装 Blender
- 通用：适用于人类、动物、物体、任何 3D 网格
- 快速：优化的推理管道
- 简单：通过 ComfyUI Manager 一键安装
# 安装
# 通过 ComfyUI Manager（推荐）
- 打开 ComfyUI 管理器
- 搜索“UniRig”
- 单击安装
- 重启ComfyUI
安装将自动：
- 安装所有必需的依赖项
- 下载并安装适合您平台的 Blender 4.2.3
- 设置 UniRig 模型缓存
# 手动安装
cd ComfyUI/custom_nodes
git clone https://github.com/PozzettiAndrea/ComfyUI-UniRig.git
cd ComfyUI-UniRig
python install.py
1
2
3
4
2
3
4
# 兼容性
体素化后端：此节点包使用trimesh用于体素化，确保跨所有平台的兼容性，包括 Windows 上的 Python 3.13+。
支持的平台：
- ✅ Windows（Python 3.10 - 3.13+）
- ✅ Linux（Python 3.10 - 3.13+）
- ✅ macOS 英特尔（Python 3.10 - 3.13+）
- ✅ macOS Apple Silicon（Python 3.10 - 3.13+）
高级配置：如果遇到体素化问题，您可以更改backend配置文件中的设置：
- 默认：
trimesh（纯Python，无处不在） - 选择：
pyrender（需要 OpenGL/EGL）
配置文件：lib/unirig/configs/transform/inference_skin_transform.yaml
