仿真器开源

Genesis World

Genesis AI、Carnegie Mellon University美国

GitHub 仓库 Genesis-Embodied-AI/genesis-world

又称 Genesis

类别
仿真与评测 · 仿真器
开放程度
开源
发布时间
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。版本更新后命令可能变化,以官方文档为准。

  1. 安装 PyTorch

    按 PyTorch 官方说明选平台和 CUDA 版本

  2. 安装 Genesis World

    包名是 genesis-world;uv 装法见 README

    pip install genesis-world
  3. 在代码里初始化

    后端和精度的选择见官方文档

    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.io
Circular import error

原因当前目录是 Genesis World 源码目录,而包是非 editable 安装

解决换到源码目录之外运行,或卸载后在源码目录里改用 editable 安装

pip install -e ".[render]"
来源:genesis-world.readthedocs.io
libcuda.so lib not found

原因WSL2 里 CUDA 库不在库搜索路径上,Quadrants 退回 CPU 或 Vulkan

解决确认 /usr/lib/wsl/lib/ 下有这些库,再加进 LD_LIBRARY_PATH

export LD_LIBRARY_PATH=/usr/lib/wsl/lib:$LD_LIBRARY_PATH
来源:genesis-world.readthedocs.io
No module named 'LuisaRenderPy'

原因LuisaRender 光线追踪渲染器不随 pip 包提供,要从源码构建

解决按官方 Rendering 文档构建;新工作官方建议改用 Nyx 渲染器

来源:Issue #76
OpenGL.error.Error: Attempt to retrieve context when no valid context

解决提问者把 PYOPENGL_PLATFORM 改成 osmesa 解决;其他用户环境里要换别的值

PYOPENGL_PLATFORM=osmesa python test_gs.py
来源:Issue #10

适配机器人

  • Franka
  • Go2
  • Shadow Hand

获取方式

数据来源

本页信息均整理自以下公开资料。

6 条来源核验于 2026-10-01

星标、下载量等指标定期自动更新。

Genesis World:安装步骤、环境要求与常见报错 | 具身集