| --- |
| license: apache-2.0 |
| tags: |
| - comfyui |
| - pixal3d |
| - 3d-generation |
| - moge |
| - rmbg |
| --- |
| |
| # 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: |
|
|
| ```bash |
| # 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). |
|
|
