Configuración de HY-Motion en ComfyUI: tutorial para crear animaciones 3D a partir de texto

Requisitos previos: instalar Miniconda

Antes de empezar, necesitas tener Miniconda instalado en tu sistema. Esta guía no trata sobre cómo instalar Miniconda en sí, pero es esencial para lo que vamos a hacer. Si todavía no lo tienes, sigue la guía oficial de instalación de Miniconda.

¿Por qué Conda? La función de exportación a FBX de HY-Motion solo funciona con Python 3.11. La versión portable más reciente de ComfyUI viene con Python 3.13, lo que rompe la exportación a FBX. Conda nos permite crear un entorno separado específicamente para Python 3.11 sin alterar tu instalación principal de Python.

Paso 1: crear el entorno de Python 3.11

Abre PowerShell (necesario para que Conda funcione correctamente). También recomiendo usar la terminal de Cursor o VS Code —si tienes algún problema, puedes pedirle al agente de IA que te ayude a depurar.

# Create a new environment with Python 3.11
conda create -n comfy311 python=3.11 -y

# Activate the environment
conda activate comfy311

Ahora estás en un entorno limpio de Python 3.11. Todo lo que instalemos a partir de aquí quedará aislado en este entorno.

Paso 2: clonar e instalar ComfyUI

Navega hasta el directorio donde quieras instalar esta nueva instancia de ComfyUI. Puede ser en cualquier lugar —yo elegí mi unidad E:, pero elige lo que mejor te funcione.

# Go to your preferred directory (change this to wherever you want)
cd E:\

# Clone ComfyUI into a new folder
git clone https://github.com/comfyanonymous/ComfyUI.git ComfyUI_py311

# Enter the ComfyUI folder
cd ComfyUI_py311

Importante: Antes de instalar los requisitos de ComfyUI, tenemos que instalar PyTorch con soporte para CUDA. Si te saltas este paso y solo ejecutas pip install torch, obtendrás la versión para CPU —la cual es significativamente más lenta.

# Upgrade pip first
python -m pip install --upgrade pip

# Install PyTorch with CUDA support (this is critical!)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124

# Now install ComfyUI requirements
pip install -r requirements.txt

En este punto, ya tienes una instalación funcional de ComfyUI. Pero todavía tenemos que agregar HY-Motion.

Paso 3: instalar el plugin de HY-Motion

Ahora vamos a instalar el plugin ComfyUI-HY-Motion1. Tenemos que clonarlo en la carpeta custom_nodes.

# Navigate to custom_nodes folder
cd custom_nodes

# Clone the HY-Motion plugin
git clone https://github.com/jtydhr88/ComfyUI-HY-Motion1

# Enter the plugin folder
cd ComfyUI-HY-Motion1

# Install plugin dependencies (includes FBX SDK)
pip install -r requirements.txt

El archivo requirements.txt ya incluye el SDK de FBX (fbxsdkpy). Si quieres verificar que esté instalado, puedes ejecutar este comando —si todo está bien, simplemente dirá "requirement already satisfied":

pip install fbxsdkpy --extra-index-url https://gitlab.inria.fr/api/v4/projects/18692/packages/pypi/simple

Paso 4: descargar los pesos del modelo

HY-Motion requiere los pesos del modelo que debes descargar manualmente desde Hugging Face. Tendrás que crear la estructura de carpetas correcta dentro de tu instalación de ComfyUI.

Así es como debes configurar la estructura de carpetas:

1. Ve a tu carpeta models de ComfyUI
2. Crea una nueva carpeta llamada HY-Motion
3. Dentro de ella, crea ckpts
4. Dentro de ckpts, crea tencent
5. Descarga y coloca allí las carpetas HY-Motion-1.0 y/o HY-Motion-1.0-Lite

ComfyUI/
└── models/
    └── HY-Motion/           # Crea esta carpeta
        └── ckpts/           # Crea esta carpeta
            ├── tencent/     # Crea esta carpeta
            │   ├── HY-Motion-1.0/        # Descarga desde HuggingFace
            │   │   ├── config.yml
            │   │   └── latest.ckpt
            │   └── HY-Motion-1.0-Lite/   # Descarga desde HuggingFace
            │       ├── config.yml
            │       └── latest.ckpt
            └── GGUF/                     # Opcional: solo si usas GGUF
                └── Qwen3-8B-Q4_K_M.gguf

Si quieres usar modelos cuantizados en GGUF para el codificador de texto, también tendrás que descargarlos por separado:

Requisitos de VRAM

Elige los modelos según tu VRAM disponible. El modelo de movimiento y el codificador de texto se ejecutan juntos, así que suma los requisitos:

Paso 5: ejecutar ComfyUI

Abre una terminal en la carpeta raíz de ComfyUI (asegúrate de que tu entorno de Conda siga activo) e inicia ComfyUI:

# Make sure you're in the ComfyUI root folder
cd E:\ComfyUI_py311

# Run ComfyUI
python main.py

Los flujos de trabajo de prueba están en la carpeta workflow dentro del directorio del plugin de HY-Motion. Carga uno de ellos para comenzar.

Exportación a FBX y rendimiento

La exportación a FBX funciona muy bien. Con mi GPU de 12GB y el modelo Lite, generar una animación de 12 segundos tarda alrededor de 40 segundos, lo cual es muy rápido.

El formato de salida es una animación SMPLX, que puedes importar directamente en Blender. Si quieres usar la animación con un esqueleto diferente (como Mixamo para Unreal Engine), tendrás que hacerle retargeting.

Conclusión

HY-Motion es una herramienta extremadamente potente. La calidad de las animaciones generadas solo a partir de prompts de texto es impresionante, y la exportación a FBX permite usarlas en flujos de trabajo de producción reales.

Un gran reconocimiento al equipo de Tencent Hunyuan por crear HY-Motion, y a jtydhr88 por desarrollar la integración de ComfyUI que hace que esto sea accesible.

¿Quieres generar movimiento a partir de texto sin ComfyUI, Python o CUDA? Kimodo de NVIDIA tiene un port en C++ y GGML que funciona con Vulkan o en un procesador común con menos de 2 GB. Cubrimos la configuración completa en Windows y el retargeting en la guía de kimodo.cpp.