HY-Motion ComfyUI 설정: 텍스트에서 3D 애니메이션 튜토리얼

사전 준비: Miniconda 설치

시작하기 전에 시스템에 Miniconda가 설치되어 있어야 합니다. 이 가이드에서는 Miniconda 설치 자체를 다루지 않지만, 이후 과정에 필수적입니다. 아직 설치하지 않았다면 공식 Miniconda 설치 가이드를 참고하세요.

왜 Conda를 사용하나요? HY-Motion의 FBX 내보내기 기능은 Python 3.11에서만 작동합니다. 최신 포터블 ComfyUI에는 Python 3.13이 포함되어 있어 FBX 내보내기가 작동하지 않습니다. Conda를 사용하면 기존 Python 설치를 건드리지 않고 Python 3.11 전용 환경을 별도로 만들 수 있습니다.

1단계: Python 3.11 환경 만들기

PowerShell을 열어주세요 (Conda가 제대로 작동하려면 필수입니다).Cursor 또는 VS Code 터미널 사용도 추천합니다 — 문제가 발생하면 AI 에이전트에게 디버깅 도움을 요청할 수 있습니다.

# Python 3.11로 새 환경 생성
conda create -n comfy311 python=3.11 -y

# 환경 활성화
conda activate comfy311

이제 새로운 Python 3.11 환경에 들어왔습니다. 여기서부터 설치하는 모든 것은 이 환경에만 격리됩니다.

2단계: ComfyUI 클론 및 설치

이 새로운 ComfyUI 인스턴스를 설치할 디렉토리로 이동하세요. 아무 곳이나 가능합니다 — 저는 E: 드라이브를 선택했지만 편한 곳을 고르시면 됩니다.

# 원하는 디렉토리로 이동 (원하는 위치로 변경하세요)
cd E:\

# ComfyUI를 새 폴더에 클론
git clone https://github.com/comfyanonymous/ComfyUI.git ComfyUI_py311

# ComfyUI 폴더로 이동
cd ComfyUI_py311

중요: ComfyUI의 requirements를 설치하기 전에 먼저 CUDA 지원이 포함된 PyTorch를 설치해야 합니다. 이 단계를 건너뛰고 pip install torch만 실행하면 CPU 버전이 설치되어 속도가 크게 느려집니다.

# pip 업그레이드
python -m pip install --upgrade pip

# CUDA 지원 PyTorch 설치 (매우 중요!)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124

# ComfyUI requirements 설치
pip install -r requirements.txt

이 시점에서 작동하는 ComfyUI 설치가 완료되었습니다. 하지만 아직 HY-Motion을 추가해야 합니다.

3단계: HY-Motion 플러그인 설치

이제 ComfyUI-HY-Motion1 플러그인을 설치하겠습니다.custom_nodes 폴더에 클론해야 합니다.

# custom_nodes 폴더로 이동
cd custom_nodes

# HY-Motion 플러그인 클론
git clone https://github.com/jtydhr88/ComfyUI-HY-Motion1

# 플러그인 폴더로 이동
cd ComfyUI-HY-Motion1

# 플러그인 종속성 설치 (FBX SDK 포함)
pip install -r requirements.txt

requirements.txt에 이미 FBX SDK (fbxsdkpy)가 포함되어 있습니다. 설치가 제대로 되었는지 확인하려면 다음 명령어를 실행하세요 — 정상이라면 "requirement already satisfied"라는 메시지만 표시됩니다:

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

4단계: 모델 가중치 다운로드

HY-Motion에는 Hugging Face에서 수동으로 다운로드해야 하는 모델 가중치가 필요합니다. ComfyUI 설치 폴더 내에 올바른 폴더 구조를 만들어야 합니다.

폴더 구조를 설정하는 방법은 다음과 같습니다:

1. ComfyUI의 models 폴더로 이동합니다
2. HY-Motion이라는 새 폴더를 만듭니다
3. 그 안에 ckpts를 만듭니다
4. ckpts 안에 tencent를 만듭니다
5. HY-Motion-1.0 및/또는 HY-Motion-1.0-Lite 폴더를 다운로드하여 배치합니다

ComfyUI/
└── models/
    └── HY-Motion/           # 이 폴더 생성
        └── ckpts/           # 이 폴더 생성
            ├── tencent/     # 이 폴더 생성
            │   ├── HY-Motion-1.0/        # HuggingFace에서 다운로드
            │   │   ├── config.yml
            │   │   └── latest.ckpt
            │   └── HY-Motion-1.0-Lite/   # HuggingFace에서 다운로드
            │       ├── config.yml
            │       └── latest.ckpt
            └── GGUF/                     # 선택사항: GGUF 사용 시에만
                └── Qwen3-8B-Q4_K_M.gguf

텍스트 인코더에 GGUF 양자화 모델을 사용하려면 별도로 다운로드해야 합니다:

VRAM 요구 사항

사용 가능한 VRAM에 따라 모델을 선택하세요. 모션 모델과 텍스트 인코더가 함께 실행되므로 요구 사항을 합산해야 합니다:

5단계: ComfyUI 실행

ComfyUI 루트 폴더에서 터미널을 열고 (Conda 환경이 아직 활성화되어 있는지 확인) ComfyUI를 시작합니다:

# ComfyUI 루트 폴더에 있는지 확인
cd E:\ComfyUI_py311

# ComfyUI 실행
python main.py

테스트 워크플로우는 HY-Motion 플러그인 디렉토리 내 workflow 폴더에 있습니다. 그중 하나를 불러와서 시작하세요.

FBX 내보내기 및 성능

FBX 내보내기는 정말 잘 작동합니다. 12GB GPU에서 Lite 모델로12초 애니메이션에 약 40초 정도 걸립니다 — 매우 빠릅니다.

출력 형식은 SMPLX 애니메이션으로, Blender에 바로 가져올 수 있습니다. 다른 스켈레톤(예: Unreal Engine용 Mixamo)에서 애니메이션을 사용하려면리타겟팅이 필요합니다.

결론

HY-Motion은 매우 강력한 도구입니다. 텍스트 프롬프트만으로 생성되는 애니메이션 품질이 인상적이며, FBX 내보내기 덕분에 실제 프로덕션 워크플로우에서 바로 활용할 수 있습니다.

HY-Motion을 만든 Tencent Hunyuan 팀에게 큰 감사를 드리며, 이를 쉽게 사용할 수 있게 해준 ComfyUI 통합을 개발한 jtydhr88에게도 감사드립니다.