# 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