Madrona 项目下载及安装教程

1. 项目介绍

Madrona 是一个用于创建高吞吐量、GPU 加速模拟器的原型游戏引擎。它能够在单个 GPU 上运行数千个虚拟环境实例，并生成每秒数百万次的聚合模拟步骤。这种效率对于高性能 AI 代理训练（例如通过强化学习）或任何需要高性能环境模拟器紧密集成在更广泛应用中的任务非常有用。

2. 项目下载位置

要下载 Madrona 项目，请使用以下命令：

git clone https://github.com/shacklettbp/madrona.git

3. 项目安装环境配置

3.1 支持的平台

• Linux: Ubuntu 18.04 或更新版本
• MacOS: 13.x Ventura 或更新版本（需要完整 Xcode 14 安装）
• Windows: Windows 11（需要 Visual Studio 16.4 或更新版本）

3.2 依赖项

• CMake: 3.24 或更新版本
• Python: 3.9 或更新版本
• GPU 后端依赖项:
  • NVIDIA Volta 或更新版本 GPU
  • CUDA 12.1 或更新版本（需要相应的 NVIDIA 驱动程序）

3.3 环境配置示例

4. 项目安装方式

4.1 Linux 和 MacOS 安装步骤

1. 克隆 Madrona 项目：

   git clone --recursive https://github.com/shacklettbp/madrona.git
   cd madrona
   

2. 安装 Python 依赖项：

   pip install -e .
   

3. 创建并进入构建目录：

   mkdir build
   cd build
   

4. 运行 CMake 配置和构建：

   cmake ..
   make -j # 使用多个核心进行构建
   

4.2 Windows 安装步骤

1. 克隆 Madrona 项目：

   git clone --recursive https://github.com/shacklettbp/madrona.git
   cd madrona
   

2. 使用 Visual Studio 打开项目根目录，并使用集成 CMake 支持进行构建。

3. 修改 pip 安装命令以指定 C++ Python 扩展的位置：

   pip install -e . -Cpackages/madrona_escape_room/ext-out-dir=out/build/Release-x64
   

5. 项目处理脚本

Madrona 项目包含多个处理脚本，用于构建、测试和运行模拟器。以下是一些常用的脚本：

• build.sh: 用于在 Linux 和 MacOS 上构建项目。
• run_simulator.py: 用于运行模拟器并生成输出。
• test_simulator.py: 用于测试模拟器的功能和性能。

通过这些脚本，您可以轻松地管理和运行 Madrona 项目。