4DAnyone

环境要求

• Linux 环境（README 命令基于 bash，含 conda）
• 已安装 Git，可克隆仓库与子模块
• 已安装 Conda，可创建 Python 3.11 环境
• NVIDIA GPU，峰值显存需低于 24 GB（RTX 4090 可运行）

安装与启动步骤

1. 1克隆项目仓库

   从 GitHub 拉取 4DAnyone 源码，README 建议定期 git pull 获取最新改进。

   git clone https://github.com/ant-research/4DAnyone.git

   复制

2. 2初始化子模块

   进入项目目录并初始化 third_party/GVHMR 子模块，跳过会导致后续代码缺失。

   cd 4DAnyone
   git submodule update --init third_party/GVHMR

   复制

3. 3创建 conda 环境

   按 README 要求创建名为 4danyone 的环境，Python 版本必须为 3.11。

   conda create -n 4danyone python=3.11 -y

   复制

4. 4激活环境

   后续所有 pip 安装与脚本运行都需在该环境中执行。

   conda activate 4danyone

   复制

5. 5安装 Python 依赖

   按 requirements.txt 安装全部依赖，若需更快的推理可另装注意力后端。

   pip install -r requirements.txt

   复制

6. 6下载模型与示例

   首次使用会自动下载缺失模型；也可用脚本手动下载 SMPL-X、模型与示例数据。

   python scripts/download_smplx.py
   python scripts/download_model.py
   python scripts/download_example.py

   复制

如何确认成功

README 未给出推理启动命令；可确认 conda 环境已激活、pip 安装无报错，且三个下载脚本能成功拉取模型与示例。

常见问题

注意事项

• README 只提供了安装步骤，未给出推理或训练的具体命令，需参考官方项目页与论文。
• git submodule update --init third_party/GVHMR 不可省略，否则缺少 GVHMR 子模块代码。
• 可选安装 FlashAttention-3 或 SageAttention 以加快推理，已安装的后端会被自动启用。
• 项目仍在迭代，README 建议定期执行 git pull 获取最新改进。