- 类别
- 仿真与评测 · 仿真器
- 开放程度
- 开源
- 发布时间
- 2024 年 12 月
- 开源协议
- Apache-2.0
- 发布方所在地
- 美国
项目简介
面向机器人与物理 AI 的仿真平台,原名 Genesis。统一多物理引擎覆盖刚体、FEM、MPM、PBD、SPH、IPC 等求解器并可相互耦合,配自研渲染器 Nyx 和可编译到 CUDA、ROCm、Metal 等后端的编译器 Quadrants。可导入 URDF、MJCF、USD 资产,支持并行与异构环境和相机、IMU、激光雷达、触觉等传感器,用于强化学习和数据生成。
Genesis World 安装要点
来源:genesis-world.readthedocs.io依据官方资料的 v1.4.5 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
安装 PyTorch
按 PyTorch 官方说明选平台和 CUDA 版本
安装 Genesis World
包名是 genesis-world;uv 装法见 README
pip install genesis-world在代码里初始化
后端和精度的选择见官方文档
gs.init()
环境要求
来源:README.md- Python
- 3.12 到 3.14(>=3.12,<3.15)
- PyTorch
- 要先按官方说明安装
适配矩阵
来源:genesis-world.readthedocs.io各操作系统和 GPU 组合支持的功能
| 名称 | GPU 仿真 | CPU 仿真 | 交互查看器 | 无头渲染 |
|---|---|---|---|---|
| Linux + Nvidia | ✓ | ✓ | ✓ | ✓ |
| Linux + AMD | ✓ | ✓ | ✓ | ✓ |
| Linux + Intel | 不支持 | ✓ | ✓ | ✓ |
| Windows + Nvidia | ✓ | ✓ | ✓ | ✓ |
| Windows + AMD | ✓ | ✓ | ✓ | ✓ |
| Windows + Intel | 不支持 | ✓ | ✓ | ✓ |
| macOS + Apple Silicon | ✓ | ✓ | ✓ | ✓ |
✓ 官方资料写明支持,— 资料没写。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
genesis.GenesisException: Genesis hasn't been initialized. Did you call `gs.init()`?原因在 gs.init() 之前导入了引擎子模块
解决先调用 gs.init(),再导入引擎子模块
来源:genesis-world.readthedocs.ioCircular import error原因当前目录是 Genesis World 源码目录,而包是非 editable 安装
解决换到源码目录之外运行,或卸载后在源码目录里改用 editable 安装
来源:genesis-world.readthedocs.iopip install -e ".[render]"libcuda.so lib not found原因WSL2 里 CUDA 库不在库搜索路径上,Quadrants 退回 CPU 或 Vulkan
解决确认 /usr/lib/wsl/lib/ 下有这些库,再加进 LD_LIBRARY_PATH
来源:genesis-world.readthedocs.ioexport LD_LIBRARY_PATH=/usr/lib/wsl/lib:$LD_LIBRARY_PATHNo module named 'LuisaRenderPy'原因LuisaRender 光线追踪渲染器不随 pip 包提供,要从源码构建
解决按官方 Rendering 文档构建;新工作官方建议改用 Nyx 渲染器
来源:Issue #76OpenGL.error.Error: Attempt to retrieve context when no valid context解决提问者把 PYOPENGL_PLATFORM 改成 osmesa 解决;其他用户环境里要换别的值
来源:Issue #10PYOPENGL_PLATFORM=osmesa python test_gs.py
适配机器人
- Franka
- Go2
- Shadow Hand