rosa

环境要求

• Python 3.9 或更高版本
• ROS Noetic 或更高版本（ROS1/ROS2 环境）
• 一个可用的 LLM（具体接入方式见官方 Wiki 的 Model Configuration 页面）

安装与启动步骤

1. 1检查基础环境

   确认本机 Python 版本满足 3.9+，并已安装 ROS Noetic 或更高版本的 ROS 环境。

   python3 --version

   复制

2. 2安装 ROSA

   通过 pip 安装官方发布的 jpl-rosa 包，README 只给出这一种安装方式。建议在虚拟环境中安装。

   pip3 install jpl-rosa

   复制

3. 3配置语言模型

   README 未给出 LLM 的具体配置代码，只指向官方 Wiki 的 Model Configuration 页面，请先按该页面准备好模型实例。

4. 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")

   复制

关键配置

如何确认成功

脚本运行后 agent.invoke 返回话题列表等机器人状态信息，说明 ROSA 已能读取 ROS 数据并正常对话。

常见问题

注意事项

• README 明确要求 Python 3.9+ 与 ROS Noetic 或更高版本，版本不符可能无法运行。
• README 示例中的 get_your_llm_here() 是占位函数，必须替换为真实模型实例，否则脚本会报错。
• README 未提供端口、路径等额外配置，任何未在 Wiki 中确认的参数都不建议自行添加。