hunyuan3d-sunnie/README.md

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

# 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