工具开源

ROSA

NASA JPL美国

GitHub 仓库 nasa-jpl/rosa

又称 ROS Agent、jpl-rosa

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

项目简介

NASA 喷气推进实验室(JPL)开源的 ROS 智能体,基于 LangChain,让用户用自然语言查询 ROS 1 / ROS 2 系统的话题、节点等信息并下发控制指令,降低机器人开发和调试门槛。可通过继承或自定义工具、提示词适配不同机器人,附带 TurtleSim 仿真演示,并在 JPL 火星场地的 NeBula-Spot 四足机器人上做过演示,可通过 pip 安装 jpl-rosa。

ROSA 安装要点

来源:README.md

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

  1. 安装 ROSA

    pip3 install jpl-rosa
  2. 创建 agent 并发送查询

    ROS 2 把 ros_version 设为 2;LLM 配置见 Wiki

    from rosa import ROSA
    llm = get_your_llm_here()
    agent = ROSA(ros_version=1, llm=llm)
    agent.invoke("Show me a list of topics that have publishers but no subscribers")
  3. 运行 TurtleSim 演示来源:Guide:-TurtleSim-Demo

    可选,步骤来自 Wiki;start 在容器内运行,仅支持 ROS1

    git clone https://github.com/nasa-jpl/rosa.git
    cd rosa
    ./demo.sh
    start

环境要求

来源:README.md
Python
3.9 及以上
ROS
Noetic 或更高
Noetic 环境来源:Issue #63
官方 Dockerfile 的做法是另装 Python 3.9 来安装和运行 ROSA
LLM来源:Model-Configuration
需要自备,支持 OpenAI API 和 Azure OpenAI,Ollama 为实验性
TurtleSim 演示
需要 Docker 和 X11 服务

适配矩阵

来源:README.md

README 徽章列出的 ROS 版本,以及初始化时要传的 ros_version

名称支持ros_version
ROS 1 Noetic✓1
ROS 2 Humble✓2
ROS 2 Iron✓2
ROS 2 Jazzy✓2
ROS 2 Galactic维护者在 issue #63 说明来源:Issue #63不支持—

✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。

常见报错

解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。

Error: X11 forwarding is not working. Please check your X11 server and try again.

原因WSL 的 /etc/hosts 里没有 host.docker.internal

解决WSL2 下把 DISPLAY 改成 :0。官方说明 ROSA 未在 Windows 和 WSL2 上测试

export DISPLAY=:0
来源:Issue #38
`ChatOpenAI` is not fully defined; you should define `BaseCache`, then call `ChatOpenAI.model_rebuild()`.

原因依赖拉到的 langchain 版本偏旧

解决升级 langchain,官方已在 #62 修复版本约束

pip install langchain --upgrade
来源:Issue #61
Cannot uninstall PyYAML 5.3.1

原因构建 TurtleSim Docker 镜像时 pip 无法卸载 distutils 装的 PyYAML

解决更新到 main 分支最新代码后重新构建

来源:Issue #68

适配机器人

  • NeBula-Spot

获取方式

数据来源

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

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

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

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