工具开源

cuRobo

NVIDIA美国

GitHub 仓库 NVlabs/curobo

又称 cuRoboV2

类别
框架与工具 · 工具
开放程度
开源
发布时间
2023 年 10 月
开源协议
Apache-2.0
发布方所在地
美国

项目简介

NVIDIA 开源的 GPU 加速机器人运动生成库,基于 PyTorch、CUDA 和 Warp,提供并行的正逆运动学、碰撞检测、轨迹优化、几何规划和由深度图生成距离场的感知模块,可为单臂机械臂到高自由度人形机器人生成无碰撞、满足力矩限制的平滑轨迹。2026 年的 cuRoboV2 重写了接口,加入动力学感知轨迹优化和全身运动生成,依赖旧接口可固定到 v0.7.8。

cuRobo 安装要点

来源:installation.rst

依据官方资料的 v0.9.0 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。

  1. 克隆仓库来源:curobo.org

    依赖 v1 API 的项目要固定到 v0.7.8 tag

    git clone https://github.com/NVlabs/curobo.git
    cd curobo
  2. 创建虚拟环境

    官方推荐用 uv

    uv venv --python 3.11
    source .venv/bin/activate
  3. 查看驱动的 CUDA 版本

    nvidia-smi | grep CUDA
  4. 安装 cuRobo

    CUDA 12.x 用 .[cu12-torch];已有 PyTorch 见下表

    uv pip install .[cu13-torch]
  5. 验证安装

    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.md
KinematicsLoaderCfg() got multiple values for keyword argument 'num_envs'

原因Build Robot Model 步骤生成的 yml 和示例配置结构不同

解决更新到已合并修复的版本;提问者注释掉 yml 里的这两个参数也能运行

来源:Issue #619
CUDA error: misaligned address

原因Mapper 和规划跑在不同线程,CUDA 捕获冲突

解决把 Mapper 和规划放到同一线程,或设 use_cuda_graph=False

来源:Issue #662

获取方式

数据来源

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

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

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

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