## CompuAI Hi-Hi Motion 1: 텍스트로 3D 캐릭터 춤/움직임 생성 ### 소개 - **사이버 BJ 컴피리아**가 소개하는 **CompuAI Hi-Hi Motion 1**은 텍스트 입력만으로 3D 캐릭터의 춤과 움직임을 생성하는 혁신적인 커스텀 노드입니다. ### 주요 특징 및 기능 * **Text-to-Motion**: * "A Person Dancing Hip Hop"과 같은 텍스트를 입력하면 해당 동작을 수행하는 캐릭터의 뼈대(Rig)와 움직임을 3D로 생성합니다. * **3D Animation Preview Node**: * 결과물을 별도 프로그램 없이 CompuUI 내에서 바로 확인할 수 있는 **3D JS Viewer**를 제공합니다. * *마우스 조작을 통한 회전, 재생 속도 조절, 그리드 On/Off 기능* 지원. * **GLB Export**: * 뷰어 자체에 **GLB Export** 버튼이 내장되어 있어 별도의 SDK 설치 없이 간편하게 파일을 내보낼 수 있습니다. * 기존 FBX 파일 추출 시 발생했던 복잡한 설치 및 에러 문제를 해결했습니다. (순수 프론트엔드 방식) * Export된 파일은 Blender, Maya 등 3D 프로그램에서 바로 활용 가능합니다. ### 스펙 및 최적화 * **AI 모델**: Tencent의 **Hi-Hi Motion 1.0** 모델 사용. * **기본 모델**: VRAM 8GB 이상 필요. * **LLM 모델**: QN3-8B (텍스트 이해용) * **최적화 방안**: * **GGUF 양자화 지원**: `Load LLM GGUF` 노드를 통해 **Q4-KM 버전 (약 5GB)** 사용 시 VRAM 사용량을 크게 줄여 품질 유지 및 메모리 절약 가능. * **라이트 버전 모션 모델**: 4GB VRAM으로도 구동 가능. ### 설치 및 사용법 1. **커스텀 노드 및 Requirements 설치**: `requirements.txt` 파일의 내용에 따라 설치. 2. **모델 다운로드**: * **Hi-Hi Motion 1.0 모델**: Hugging Face에서 다운로드 후 `CompuAI/models/hi-hi-motion/ckts/tencent` 폴더에 저장. * **GGUF 파일**: 별도 다운로드 후 `CompuAI/ckts/gguf` 폴더에 저장. 3. **워크플로우 연결**: * `Load LLM` → `Load Network` → `Text Encode` → `Generate` → `3D Preview` 순서로 연결. ### 자주 발생하는 에러 및 해결 방법 (VRAM 부족) * **증상**: 빨간색 에러 메시지, "Some Modules Artists Patched on the CPU" 등의 로그 확인. * **원인**: 80억 파라미터의 LLM 모델 (QN3A, B)을 INT8로 GPU에 로드하려 할 때 VRAM 부족. (최소 16GB 이상 권장) * **해결 방법**: 1. **모델 양자화 옵션 변경**: Hi-Hi Motion 노드 내 LLM 노드의 `quantization` 옵션을 `INT8`에서 **`INT4` 또는 `NF4`**로 변경. * 모델 크기가 절반 가까이 줄어들어 약 5~6GB가 되어 대부분의 그래픽카드에서 사용 가능. * 춤 생성 품질에 큰 지장 없음. 2. **GGUF 로드 방식 사용**: 위 방법으로도 해결되지 않을 경우, `Load LLM GGUF` 노드를 사용하고 **`q4km.gguf` 파일**을 연결. (가장 강력한 메모리 최적화) ### 마무리 * 텍스트 한 줄로 자신만의 춤추는 캐릭터를 만들어 보세요. * **구독, 좋아요, GitHub Star**는 필수!