vuong69/pixal3d-models

Pixal3D & MoGe Models for ComfyUI

This repository contains the pre-downloaded and compiled model weights required to run Pixal3D-ComfyUI on a Windows/Linux system (including Docker environments). Using these pre-downloaded files prevents runtime downloads and allows offline or air-gapped deployments.

---

📁 Repository Folder Structure / Cấu trúc thư mục

To run Pixal3D correctly, place the files in this repository into your ComfyUI models directory as follows:

ComfyUI/
└── models/
    ├── Pixal3D/
    │   ├── TencentARC_Pixal3D/                    # Shape & Texture SLat checkpoints
    │   ├── briaai_RMBG-2.0/                       # Background removal model
    │   ├── camenduru_dinov3-vitl16-pretrain-lvd... # DINOv3 ViT pretrain weights
    │   └── torch_hub/                             # Neighborhood Attention Flow (NAF) upsampler weights
    │       └── hub/
    │           └── checkpoints/
    │               └── naf_release.pth
    │
    └── geometry_estimation/                       # MoGe Camera & Normal estimation models
        ├── moge_1_vitl_fp16.safetensors
        └── moge_2_vitl_normal_fp16.safetensors

---

🚀 How to Download and Setup / Hướng dẫn cài đặt

Option 1: Direct Download (Manual) / Tải thủ công

1. Download the Pixal3D and geometry_estimation folders from this repository.
2. Move them directly to your ComfyUI models/ directory:
   • Copy Pixal3D/ folder to ComfyUI/models/Pixal3D/
   • Copy geometry_estimation/ folder to ComfyUI/models/geometry_estimation/

---

Option 2: Using Hugging Face CLI / Sử dụng dòng lệnh

If you want to pull these models on a new server or another machine via the terminal, use the following commands:

# Install Hugging Face Hub library
pip install huggingface_hub

# Download Pixal3D models
hf download vuong69/pixal3d-models --local-dir ./models --local-dir-use-symlinks False

---

⚙️ Model Loader Settings in ComfyUI

To ensure ComfyUI uses these local models and does not try to download anything from the internet at runtime, set the following option in your Pixal3D Model Loader node:

• download_if_missing = false (since all weights are already locally present in the correct path).