- 类别
- 框架与工具 · 工具
- 开放程度
- 开源
- 发布时间
- 2023 年 10 月
- 开源协议
- Apache-2.0
- 发布方所在地
- 美国
项目简介
NVIDIA 开源的 GPU 加速机器人运动生成库,基于 PyTorch、CUDA 和 Warp,提供并行的正逆运动学、碰撞检测、轨迹优化、几何规划和由深度图生成距离场的感知模块,可为单臂机械臂到高自由度人形机器人生成无碰撞、满足力矩限制的平滑轨迹。2026 年的 cuRoboV2 重写了接口,加入动力学感知轨迹优化和全身运动生成,依赖旧接口可固定到 v0.7.8。
cuRobo 安装要点
来源:installation.rst依据官方资料的 v0.9.0 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
克隆仓库来源:curobo.org
依赖 v1 API 的项目要固定到 v0.7.8 tag
git clone https://github.com/NVlabs/curobo.git cd curobo创建虚拟环境
官方推荐用 uv
uv venv --python 3.11 source .venv/bin/activate查看驱动的 CUDA 版本
nvidia-smi | grep CUDA安装 cuRobo
CUDA 12.x 用 .[cu12-torch];已有 PyTorch 见下表
uv pip install .[cu13-torch]验证安装
python -c "import curobo; print(curobo.__version__)" pytest --pyargs curobo.tests
环境要求
来源:installation.rst- 系统
- Ubuntu 20.04 及以上,其他 Linux 可能可用
- GPU
- 比 Turing 更新的 NVIDIA GPU
- 显存
- 至少 4 GB
- NVIDIA 驱动
- 580.65.06 及以上,至少支持 CUDA 12
- Python
- 3.10 及以上,高于 3.13 未验证
- PyTorch来源:pyproject.toml
- cu13-torch 要 2.9 及以上,cu12-torch 要 2.5 及以上
适配矩阵
来源:installation.rst按驱动的 CUDA 版本选择安装目标
| 名称 | 全新安装(含 PyTorch) | 已装 PyTorch |
|---|---|---|
| CUDA 13.x | .[cu13-torch] | .[cu13] |
| CUDA 12.x | .[cu12-torch] | .[cu12] |
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
ModuleNotFoundError: No module named 'curobo.types'原因cuRoboV2 的公开 API 和 v1 不同,下游代码还在用 v1 的模块路径
解决依赖 v1 API 的项目把 cuRobo 固定到 v0.7.8 tag
来源:README.mdKinematicsLoaderCfg() got multiple values for keyword argument 'num_envs'原因Build Robot Model 步骤生成的 yml 和示例配置结构不同
解决更新到已合并修复的版本;提问者注释掉 yml 里的这两个参数也能运行
来源:Issue #619CUDA error: misaligned address原因Mapper 和规划跑在不同线程,CUDA 捕获冲突
解决把 Mapper 和规划放到同一线程,或设 use_cuda_graph=False
来源:Issue #662