Make-It-Animatable项目安装与配置指南

1. 项目基础介绍

Make-It-Animatable是一个高效创建动画就绪3D角色的框架。此项目旨在为用户提供一种便捷的方法，通过训练神经网络模型来自动化生成3D角色的动画。该项目主要使用Python编程语言开发。

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

• Blender: 一个开源的3D创作套件，用于在训练过程中处理和生成3D数据。
• PyTorch: 一个流行的开源机器学习库，用于构建和训练神经网络。
• FBX2glTF: 一个FBX到glTF转换工具，用于在演示中转换模型格式。
• 3DGS Render Blender Addon: 由KIRI Engine提供的Blender插件，用于渲染。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的计算机满足以下条件：

• 安装有Python环境（建议使用Anaconda以方便管理虚拟环境）。
• 安装有Git版本控制系统。
• 确保您的计算机有足够的存储空间和内存来处理3D数据和训练神经网络。

安装步骤

克隆项目

首先，您需要克隆项目到本地环境：

git clone https://github.com/jasongzy/Make-It-Animatable.git --recursive --single-branch
cd Make-It-Animatable

设置虚拟环境

项目使用conda来管理虚拟环境，分别用于训练和演示。首先创建并激活训练环境：

conda create -n mia python=3.10
conda activate mia

然后安装项目所需的依赖：

pip install -r requirements.txt

接下来，创建并激活演示环境（注意，演示环境和训练环境使用不同版本的Python）：

conda create -n mia-demo python=3.11
conda activate mia-demo

安装演示环境所需的依赖：

pip install -r requirements-demo.txt

数据准备

项目需要下载特定数据集，可以使用以下命令：

git lfs install
GIT_LFS_SKIP_SMUDGE=1 git -C data clone https://huggingface.co/datasets/jasongzy/Mixamo
git -C data/Mixamo submodule update --init

根据您是进行训练还是演示，下载相应的数据：

• 训练数据：

git -C data/Mixamo lfs pull -I 'bones*.fbx,animation,animation_extra,character_refined,character_rabit_refined'

• 演示数据：

git -C /tmp/hf-data lfs pull -I output/best/new
mkdir -p output/best
cp -r /tmp/hf-data/output/best/new output/best/
git -C /tmp/hf-data lfs pull -I data
cp -r /tmp/hf-data/data/ data/

此外，还需要下载FBX2glTF工具并赋予执行权限：

wget https://github.com/facebookincubator/FBX2glTF/releases/download/v0.9.7/FBX2glTF-linux-x64 -O util/FBX2glTF
chmod +x util/FBX2glTF

开始训练或演示

• 启动演示：

conda activate mia-demo
python app.py

• 启动训练：

conda activate mia
bash train.sh

请注意，根据您的硬件配置，可能需要调整train.sh脚本中的参数，以适应您的GPU内存大小。

以上步骤即为Make-It-Animatable项目的详细安装和配置指南。按照这些步骤操作后，您应该能够顺利运行该项目。