Sign inSign up

iotuelich/hunyuan3d-t23d

By iotuelich

•Updated 10 months ago

Hunyuan3D Text-to-3D Gradio (GPU/CUDA) with persistent cache/output and sentencepiece.

Image
Machine learning & AI
0

2.6K

iotuelich/hunyuan3d-t23d repository overview

⁠Overview

This image runs Hunyuan3D with Text-to-3D enabled (--enable_t23d) and includes the required dependency sentencepiece (needed by T5Tokenizer).
Designed for NVIDIA GPU hosts with persistent storage for:

  • Model & HuggingFace cache
  • Generated outputs

⁠Requirements

  • Linux host with NVIDIA GPU
  • NVIDIA driver installed
  • Docker + Docker Compose v2
  • NVIDIA Container Toolkit installed

⁠Quick Install (Docker Run)

⁠1) Create persistent folders
sudo mkdir -p /opt/hunyuan3d/cache /opt/hunyuan3d/output
⁠2) Pull the image
sudo docker pull iotuelich/hunyuan3d-t23d:latest
⁠3) Run the container
sudo docker run -d \
  --name hunyuan3d \
  --gpus all \
  --restart unless-stopped \
  -p 7870:7860 \
  -e HF_HOME=/app/cache/huggingface \
  -e HUGGINGFACE_HUB_CACHE=/app/cache/huggingface/hub \
  -e TRANSFORMERS_CACHE=/app/cache/huggingface/transformers \
  -v /opt/hunyuan3d/cache:/app/cache \
  -v /opt/hunyuan3d/output:/app/output \
  iotuelich/hunyuan3d-t23d:latest \
  bash -lc "source .venv/bin/activate && python /app/gradio_app.py --enable_t23d --host 0.0.0.0 --port 7860 --cache-path /app/cache"

⁠4) Open in browser
http://<SERVER-IP>:7870/
⁠5) Stop / start / remove
sudo docker stop hunyuan3d
sudo docker start hunyuan3d
sudo docker rm -f hunyuan3d

⁠Quick Install (Docker Compose)

⁠1) Create folders
sudo mkdir -p /opt/hunyuan3d/cache /opt/hunyuan3d/output
cd /opt/hunyuan3d

⁠2) Create docker-compose.yaml
services:
  hunyuan3d:
    image: iotuelich/hunyuan3d-t23d:latest
    container_name: hunyuan3d
    restart: unless-stopped

    ports:
      - "7870:7860"

    environment:
      HF_HOME: /app/cache/huggingface
      HUGGINGFACE_HUB_CACHE: /app/cache/huggingface/hub
      TRANSFORMERS_CACHE: /app/cache/huggingface/transformers

    volumes:
      - /opt/hunyuan3d/cache:/app/cache
      - /opt/hunyuan3d/output:/app/output

    gpus: all

    command: >
      bash -lc "source .venv/bin/activate &&
      python /app/gradio_app.py --enable_t23d
      --host 0.0.0.0 --port 7860 --cache-path /app/cache"
⁠3) Start
sudo docker compose up -d
sudo docker compose logs -f --tail 200
⁠4) Update to latest
sudo docker compose down
sudo docker compose pull
sudo docker compose up -d

⁠Ports

  • Host 7870 → Container 7860

⁠Volumes

  • /opt/hunyuan3d/cache → /app/cache (HuggingFace + model cache)
  • /opt/hunyuan3d/output → /app/output (generated outputs / exports)

Tag summary

Content type

Image

Digest

sha256:83c15b177…

Size

16.3 GB

Last updated

10 months ago

docker pull iotuelich/hunyuan3d-t23d