ComfyUI-Unique3D 项目安装与使用指南

1. 项目目录结构及介绍

ComfyUI-Unique3D/
├── ckpt/
│   ├── controlnet-tile/
│   ├── image2normal/
│   ├── img2mvimg/
│   ├── realesrgan-x4.onnx
│   └── v1-inference.yaml
├── custom_3d_diffusion/
├── docs/
├── mesh_reconstruction/
├── scripts/
├── workflow/
├── .gitignore
├── LICENSE
├── README.md
├── __init__.py
├── gradio_app.py
├── install_windows_portable_win_py311_cu121.bat
├── pyproject.toml
├── requirements.txt
├── requirements_post_win_py311_cu121.txt
└── run.py

目录结构说明

• ckpt/: 存放模型权重文件的目录。

  • controlnet-tile/: 控制网络的权重文件。
  • image2normal/: 图像到法线的权重文件。
  • img2mvimg/: 图像到多视图图像的权重文件。
  • realesrgan-x4.onnx: 超分辨率模型的ONNX文件。
  • v1-inference.yaml: 推理配置文件。

• custom_3d_diffusion/: 自定义3D扩散模型的相关文件。

• docs/: 项目文档文件夹。

• mesh_reconstruction/: 网格重建的相关文件。

• scripts/: 项目脚本文件夹。

• workflow/: 工作流配置文件夹。

• .gitignore: Git忽略文件配置。

• LICENSE: 项目许可证文件。

• README.md: 项目说明文件。

• init.py: Python包初始化文件。

• gradio_app.py: Gradio应用启动文件。

• install_windows_portable_win_py311_cu121.bat: Windows下的安装脚本。

• pyproject.toml: Python项目配置文件。

• requirements.txt: 项目依赖文件。

• requirements_post_win_py311_cu121.txt: Windows下的额外依赖文件。

• run.py: 项目启动文件。

2. 项目启动文件介绍

run.py

run.py 是项目的启动文件，负责初始化并启动ComfyUI-Unique3D应用。该文件包含了主要的逻辑代码，用于加载模型、配置环境并启动Gradio界面。

gradio_app.py

gradio_app.py 是Gradio应用的启动文件，负责定义和启动Gradio界面，用户可以通过该界面与ComfyUI-Unique3D进行交互。

3. 项目的配置文件介绍

pyproject.toml

pyproject.toml 是Python项目的配置文件，包含了项目的元数据、依赖管理、构建系统等信息。

requirements.txt

requirements.txt 列出了项目运行所需的所有Python依赖包及其版本。

requirements_post_win_py311_cu121.txt

requirements_post_win_py311_cu121.txt 是Windows系统下额外的依赖文件，包含了特定于Windows和CUDA 12.1的依赖包。

v1-inference.yaml

v1-inference.yaml 是推理配置文件，定义了模型推理时的参数和配置。

install_windows_portable_win_py311_cu121.bat

install_windows_portable_win_py311_cu121.bat 是Windows系统下的安装脚本，用于安装项目所需的依赖和配置环境。

通过以上介绍，您可以更好地理解和使用ComfyUI-Unique3D项目。