NormalCrafter开源项目安装与配置指南

1. 项目基础介绍

NormalCrafter 是一个开源项目，旨在从开放世界的视频中生成具有细粒度细节的时序一致性法线序列。该项目由 Yanrui Bin 等人开发，利用视频扩散先验技术，可以处理任意长度的视频，并生成高质量的法线序列。

主要编程语言：Python

2. 项目使用的关键技术和框架

• 视频扩散先验：项目核心算法，用于生成时序一致性的法线序列。
• PyTorch：深度学习框架，用于模型的训练和推理。
• Gradio：用于创建Web界面，方便用户在线演示项目功能。

3. 项目安装和配置的准备工作与详细步骤

准备工作

• 确保你的系统中已经安装了 Python（推荐版本 3.6 及以上）。
• 安装 Git 以克隆项目仓库。
• 准备一个具有适当内存的 GPU，以便进行高性能的推理计算。

安装步骤

1. 克隆项目仓库到本地

   打开终端（或命令提示符），输入以下命令：

   git clone [e-mail]:Binyr/NormalCrafter.git
   

2. 安装项目依赖

   进入项目目录，使用 pip 安装 requirements.txt 文件中列出的依赖：

   cd NormalCrafter
   pip install -r requirements.txt
   

3. 运行示例

   为了快速体验项目，你可以运行一个本地演示。在项目目录中，执行以下命令来启动 Gradio 服务：

   python app.py
   

   在浏览器中打开 http://localhost:7860，你应该能看到 NormalCrafter 的在线演示界面。

4. 进行推理

   如果你想对视频文件进行法线序列生成，可以使用项目提供的推理脚本。根据你 GPU 的内存大小，选择适当的分辨率进行推理。

   • 对于 ~20GB 内存的高分辨率推理（1024x576）：

     python run.py --video-path examples/example_01.mp4
     

   • 对于 ~6GB 内存的低分辨率推理（512x256）：

     python run.py --video-path examples/example_01.mp4 --max-res 512
     

确保按照上述步骤操作，你将能够成功安装和配置 NormalCrafter 项目，并开始生成时序一致的法线序列。