alpasim

环境要求

• 支持 Docker 与 Docker Compose 的单机环境（Linux 或 macOS）
• Python 环境（项目基于 Python 构建）
• git 用于克隆仓库
• 如需视频模型渲染后端，需要能访问 NVIDIA FlashDreams / OmniDreams 相关依赖
• 集群部署需要 SLURM 环境

安装与启动步骤

1. 1克隆仓库

   把 AlpaSim 源码拉到本地。README 未给出 pip install 或 docker run 的直接命令，后续以官方 Tutorial 为准。

   git clone https://github.com/NVlabs/alpasim.git
   cd alpasim

   复制

2. 2查看本地部署教程

   README 指向 docs/TUTORIAL.md，这是单机 Docker Compose 运行仿真的默认路径。打开它了解具体启动命令。

   cat docs/TUTORIAL.md

   复制

3. 3按教程启动仿真

   按 TUTORIAL.md 中的 Docker Compose 步骤在单机上运行闭环仿真。默认渲染后端为 NuRec。

4. 4切换视频模型渲染

   若要用 OmniDreams 作为渲染后端，请参考 VIDEO_MODEL.md，其中说明通过 FlashDreams 接入的方式。

   cat docs/VIDEO_MODEL.md

   复制

5. 5集群部署

   如需在 SLURM 集群上部署，参考 src/tools/run-on-slurm 中的工具与说明。

   ls src/tools/run-on-slurm

   复制

关键配置

如何确认成功

按 TUTORIAL.md 启动后，容器与仿真进程正常运行、终端无报错，并能看到渲染服务和仿真环境初始化日志。

常见问题

注意事项

• README 未提供 pip 包名、端口、配置文件路径等细节，务必以 docs/TUTORIAL.md 为准。
• 默认教程路径使用 NuRec；切换 OmniDreams 需要额外参考 VIDEO_MODEL.md。
• SLURM 集群部署与单机 Docker Compose 部署是两套不同路径。
• 视频模型渲染对 GPU 与 NVIDIA 相关组件可能有额外要求，README 未给出具体版本。