项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1683
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 3.9 或更高版本
- ROS Noetic 或更高版本(ROS1/ROS2 环境)
- 一个可用的 LLM(具体接入方式见官方 Wiki 的 Model Configuration 页面)
安装与启动步骤
-
1检查基础环境
确认本机 Python 版本满足 3.9+,并已安装 ROS Noetic 或更高版本的 ROS 环境。
python3 --version -
2安装 ROSA
通过 pip 安装官方发布的 jpl-rosa 包,README 只给出这一种安装方式。建议在虚拟环境中安装。
pip3 install jpl-rosa -
3配置语言模型
README 未给出 LLM 的具体配置代码,只指向官方 Wiki 的 Model Configuration 页面,请先按该页面准备好模型实例。
-
4编写并运行示例脚本
按 README 示例创建 ROSA 实例并发起自然语言查询;其中 get_your_llm_here() 是占位,需换成上一步配置好的模型。
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")
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
llm | 是 | 传入的语言模型实例,需自行按 Wiki 配置 | get_your_llm_here() |
ros_version | 是 | 指定 ROS 版本,README 示例中 1 代表 ROS1 | 1 |
如何确认成功
脚本运行后 agent.invoke 返回话题列表等机器人状态信息,说明 ROSA 已能读取 ROS 数据并正常对话。
常见问题
Q:怎么配置 ROSA 使用的 LLM?
A:README 没有给出具体代码,只指向官方 Wiki 的 Model Configuration 页面(https://github.com/nasa-jpl/rosa/wiki/Model-Configuration),请以该页面为准。
Q:支持 ROS2 吗?
A:支持。README 说明 ROSA 面向 ROS1 和 ROS2 系统,示例中通过 ros_version 参数区分,示例值 1 对应 ROS1。
Q:安装命令一直失败怎么办?
A:先确认 Python 版本为 3.9+,再检查网络与 pip 源;可尝试 pip3 install --upgrade pip 后重试,或使用虚拟环境安装。
Q:运行时提示连不上 ROS 怎么办?
A:ROSA 需要可用的 ROS 环境(Noetic 或更高),请在已经 source 对应 ROS 发行版环境变量的终端中运行脚本。
注意事项
- README 明确要求 Python 3.9+ 与 ROS Noetic 或更高版本,版本不符可能无法运行。
- README 示例中的 get_your_llm_here() 是占位函数,必须替换为真实模型实例,否则脚本会报错。
- README 未提供端口、路径等额外配置,任何未在 Wiki 中确认的参数都不建议自行添加。
核心亮点
- 直接支持 ROS1 和 ROS2,覆盖主流机器人开发框架
- 自然语言交互,无需记忆复杂命令,降低调试门槛
- 能执行状态查询、话题订阅、服务调用等核心操作,实用性强
不足之处
- 文档/社区待观察
- 依赖 LLM API,可能产生额外成本且响应延迟
适用场景
- 机器人开发调试:快速定位传感器或节点问题
- 教学演示:用自然语言展示 ROS 系统工作原理
- 运维监控:日常巡检机器人状态并执行简单操作
替代项目
ROSGPT、ROScribe、RoboGPT
上一篇:docs-mcp-server
下一篇:ai-agent-papers
同类项目推荐
notion-mcp
开源
让 AI 通过 Markdown 轻松读写 Notion,快速集成智能体工作流
Notion mcp to connect AI agents to notion through markdown | Read and write notion m···
open-science
开源
本地优先的AI科研工作台,跨平台替代Claude Science
Open Science Desktop — local-first, model-agnostic AI research workbench for macOS,···
Awwwards-mcp
开源
让 AI 写前端时随手翻获奖网站找灵感
Free, open-source MCP server that gives AI coding agents (Claude Code, Codex, Cursor···
awesome-deepseek-harness
开源
一站式发现 DeepSeek 智能体插件与工具,省去大海捞针。
DeepSeek Harness (DSH) ecosystem: curated plugins, tools, and infrastructure from ds···
opencode-see-image
开源
给你的文本模型装上眼睛,图片理解无缝接入
give non-vision models the ability to see images by routing images to a vision capab···
dsh-desktop
开源
本地桌面 AI 工作台,让智能体直接读写项目、查网页、出 Office 文档
DeepSeek Harness Desktop App: a local AI desktop workspace for DSH Sessions, project···
AMPO
开源
让AI智能体在社会互动中自适应学习,决策更聪明
[ICLR 2026] Adaptive Social Learning via Mode Policy Optimization for Language Agent···
xpert
开源
搭智能体平台,建好就能跑还能持续进化
XpertAI is an open-source platform for building, running, and evolving ai agents, pr···
aeon
开源
配置一次,让 AI 智能体全自主干活,彻底告别人工审批和盯梢。
The most autonomous AI agent framework: runs unattended on GitHub Actions, self-heal···
