visualbruno/ComfyUI-HY-Motion

ComfyUI Wrapper for Tencent HY-Motion, its model for 3D character animation generation. hunyuan.tencent.com/motion

Python

14

9 commits

updated Jan 2, 2026

See the code

README

🌀 ComfyUI Wrapper for https://github.com/Tencent-Hunyuan/HY-Motion-1.0


{D0EC5C97-9B7D-4035-98A9-E33326E7B305}

REQUIREMENTS

You need to download first these models:

And save them in the folder "ComfyUI/models/HY-Motion/ckpts/"

So you must have a folder structure like this:

HY-Motion/
  |──ckpts/
      ├── tencent/
      │   ├── HY-Motion-1.0/          # Contains config.yml and latest.ckpt
      │   └── HY-Motion-1.0-Lite/     # Contains config.yml and latest.ckpt
      ├── clip-vit-large-patch14/     # CLIP weights
      ├── Qwen3-8B/                   # Qwen text encoder weights

⚙️ Installation Guide

Tested on Windows 11 with Python 3.11 and Torch = 2.7.0 + cu128.

1. Install Requirements.txt file

For a standard python environment:

python -m pip install -r ComfyUI/custom_nodes/ComfyUI-HY-Motion/requirements.txt

For ComfyUI Portable:

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-HY-Motion\requirements.txt

visualbruno/ComfyUI-HY-Motion

ComfyUI Wrapper for Tencent HY-Motion, its model for 3D character animation generation. hunyuan.tencent.com/motion

Python

14

9 commits

updated Jan 2, 2026

See the code

README

🌀 ComfyUI Wrapper for https://github.com/Tencent-Hunyuan/HY-Motion-1.0


{D0EC5C97-9B7D-4035-98A9-E33326E7B305}

REQUIREMENTS

You need to download first these models:

And save them in the folder "ComfyUI/models/HY-Motion/ckpts/"

So you must have a folder structure like this:

HY-Motion/
  |──ckpts/
      ├── tencent/
      │   ├── HY-Motion-1.0/          # Contains config.yml and latest.ckpt
      │   └── HY-Motion-1.0-Lite/     # Contains config.yml and latest.ckpt
      ├── clip-vit-large-patch14/     # CLIP weights
      ├── Qwen3-8B/                   # Qwen text encoder weights

⚙️ Installation Guide

Tested on Windows 11 with Python 3.11 and Torch = 2.7.0 + cu128.

1. Install Requirements.txt file

For a standard python environment:

python -m pip install -r ComfyUI/custom_nodes/ComfyUI-HY-Motion/requirements.txt

For ComfyUI Portable:

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-HY-Motion\requirements.txt