InstantMesh 项目使用教程

1. 项目的目录结构及介绍

InstantMesh 项目的目录结构如下：

InstantMesh/
├── assets/
├── configs/
├── docker/
├── examples/
├── src/
├── zero123plus/
├── .gitignore
├── LICENSE
├── README.md
├── app.py
├── requirements.txt
├── run.py
└── train.py

目录介绍

• assets/: 存放项目所需的静态资源文件。
• configs/: 存放项目的配置文件。
• docker/: 存放 Docker 相关的文件和配置。
• examples/: 存放示例图像和数据。
• src/: 存放项目的源代码。
• zero123plus/: 可能是项目的一个子模块或特定功能的实现。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目的许可证文件。
• README.md: 项目的说明文档。
• app.py: 项目的启动文件。
• requirements.txt: 项目依赖的 Python 包列表。
• run.py: 用于运行项目的脚本。
• train.py: 用于训练模型的脚本。

2. 项目的启动文件介绍

app.py

app.py 是 InstantMesh 项目的启动文件，用于启动一个本地的 Gradio 演示应用。以下是启动文件的基本介绍：

# app.py
# 启动 Gradio 演示应用
python app.py

如果您的机器上有多个 GPU，默认情况下应用会在两个 GPU 上运行以节省内存。您也可以强制它在一个 GPU 上运行：

CUDA_VISIBLE_DEVICES=0 python app.py

3. 项目的配置文件介绍

configs/

configs/ 目录下存放了项目的配置文件，例如 zero123plus-finetune.yaml。以下是一个示例配置文件的基本介绍：

# configs/zero123plus-finetune.yaml
# 配置文件示例
gpus: [0, 1, 2, 3, 4, 5, 6, 7]
num_nodes: 1

配置文件使用

在运行项目时，可以通过命令行指定配置文件：

python run.py configs/instant-mesh-large.yaml examples/hatsune_miku.png --save_video

如果输入图像已经包含 alpha 遮罩，可以指定 no_rembg 标志：

python run.py configs/instant-mesh-large.yaml examples/hatsune_miku.png --save_video --no_rembg

以上是 InstantMesh 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助！