37 lines
919 B
Markdown
37 lines
919 B
Markdown
# Hunyuan3D-2 + Sunnie Animation Pipeline
|
|
|
|
Self-hosted Hunyuan3D-2 (mini-turbo variant) for generating a 3D Sunnie
|
|
mesh from a reference image, then rigging and animating in Blender via
|
|
Mixamo.
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Clone the model repo
|
|
git clone https://github.com/Tencent-Hunyuan/Hunyuan3D-2.git
|
|
|
|
# Build and run
|
|
cd docker
|
|
docker compose build
|
|
docker compose up
|
|
|
|
# Gradio UI at http://localhost:8080
|
|
```
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
hunyuan3d-sunnie/
|
|
Hunyuan3D-2/ # cloned repo (git submodule or manual clone)
|
|
docker/
|
|
Dockerfile # custom build with CUDA 12.4
|
|
compose.yml # GPU-enabled compose with model volume
|
|
outputs/ # generated meshes land here
|
|
```
|
|
|
|
## Notes
|
|
|
|
- First run downloads model weights (~several GB) to the named volume
|
|
- Uses mini-turbo variant with --low_vram_mode for RTX 3080 (10GB VRAM)
|
|
- Outputs .glb with PBR textures for Blender import
|