MagicDrive

环境要求

• Python 环境（README 未指定具体版本，需可安装 PyTorch 1.10.2）
• Pytorch==1.10.2 + cuda 10.2（官方在 V100 服务器上测试通过）
• git（需支持 --recursive 拉取子模块）
• 充足的磁盘空间与可写目录，默认日志目录 ${ROOT}/magicdrive-log

安装与启动步骤

1. 1克隆仓库

   必须带 --recursive，否则 third_party 子模块不会被拉取，后续第三方包无法安装。

   git clone --recursive https://github.com/cure-lab/MagicDrive.git

   复制

2. 2选择安装依赖

   只跑 GUI 用 gui.txt；要跑完整测试 demo（并顺带验证环境）用 dev.txt，二选一执行。

   cd /your/path/MagicDrive
   pip install -r requirements/dev.txt

   复制

3. 3安装第三方源码包

   README 要求以源码方式安装 third_party 下的 bevfusion（基于 db75150）和 diffusers（基于 v0.17.1）。

   cd /your/path/MagicDrive/third_party/bevfusion && pip -vvv install .
   cd /your/path/MagicDrive/third_party/diffusers && pip -vvv install .

   复制

4. 4可选安装 xformers

   xformers（基于 v0.0.19）为可选项，遇到问题先看 doc/xformers.md 说明。

   cd /your/path/MagicDrive/third_party/xformers && pip -vvv install .

   复制

5. 5配置 accelerate

   执行交互式配置命令，按提示设置默认配置；默认日志目录为 ${ROOT}/magicdrive-log，请提前预留空间。

   accelerate config

   复制

如何确认成功

用 dev.txt 方式安装后跑一遍完整测试 demo（README 称其可在训练前验证环境），能正常跑通即环境配置成功。

常见问题

注意事项

• 克隆仓库必须加 --recursive，否则缺少 bevfusion/diffusers/xformers 等子模块。
• 官方在 V100 服务器上以 Pytorch==1.10.2、cuda 10.2 测试，环境差异可能导致失败。
• bevfusion、diffusers 需以源码方式安装；xformers 为可选依赖。
• 默认日志目录为 ${ROOT}/magicdrive-log，运行前请确认磁盘空间与写入权限。