- 类别
- 框架与工具 · 工具
- 开放程度
- 开源
- 发布时间
- 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。版本更新后命令可能变化,以官方文档为准。
安装 ROSA
pip3 install jpl-rosa创建 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")运行 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.mdREADME 徽章列出的 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 上测试
来源:Issue #38export DISPLAY=:0`ChatOpenAI` is not fully defined; you should define `BaseCache`, then call `ChatOpenAI.model_rebuild()`.原因依赖拉到的 langchain 版本偏旧
解决升级 langchain,官方已在 #62 修复版本约束
来源:Issue #61pip install langchain --upgradeCannot uninstall PyYAML 5.3.1原因构建 TurtleSim Docker 镜像时 pip 无法卸载 distutils 装的 PyYAML
解决更新到 main 分支最新代码后重新构建
来源:Issue #68
适配机器人
- NeBula-Spot