Open-RUA/uni-robot-agent

项目介绍

uni-robot-agent 是一个面向机器人使用智能体的 Python 运行框架：由视觉/语言模型产出工具调用，框架负责调度、执行和记录针对机器人环境的操作。它提供命令行、Python SDK、本地 Web 面板，并集成了 RoboDojo、RoboUse、RoboLab 等仿真环境；支持 Codex 与 Claude Code 运行时，并通过明确接口替换智能体运行时、模型提供方、工具、环境或模型服务。

该项目配套论文《Democratizing Robot-Use Agents: A Unified Harness with Open Models》，实现了论文中的 RGB-only 观测设定（可关闭深度），并提供混合模式调用 Pi0.5 等动作模型。目标用户是研究或开发仿真机器人操作智能体的研究人员与工程师。

快速使用

准备 Linux GPU 主机上的 Python 3.11 虚拟环境，从 PyPI 安装并初始化 RoboDojo 集成：

pip install uni-robot-agent
uni-robot-agent setup --integration robodojo

配置兼容 Responses 接口的模型地址与密钥，然后运行任务：

export UNI_ROBOT_AGENT_API_KEY='YOUR_API_KEY'
export UNI_ROBOT_AGENT_PROVIDER_URL='https://provider.example/v1'

uni-robot-agent run --integration robodojo --deploy local \
  --task stack_bowls --model YOUR_MODEL_ID \
  --action-profile direct --no-sam3 --output-dir ./runs --monitor

命令会打印面板地址，结果写入 ./runs。之后可用 uni-robot-agent monitor --run-dir ./runs 回放保存的 episode。

需要编程控制时，SDK 可以连接已运行的环境（例如 http://127.0.0.1:18760），并返回包含 agent_finished 与 task_success 的结果：

from uni_robot_agent import AgentConfig, SessionConfig, run

result = run(SessionConfig(
    integration="robodojo",
    env_url="http://127.0.0.1:18760",
    no_sam3=True,
    agent=AgentConfig(model="YOUR_MODEL_ID", provider_url="https://provider.example/v1"),
    output_dir="runs",
))
print(result.agent_finished, result.task_success, result.session_dir)

环境与硬件

仿真集成包括 RoboDojo 双臂操作（Direct 工具或 Hybrid Pi0.5 控制）、RoboUse 中来自 LIBERO、RoboCasa、MetaWorld、RoboSuite、ManiSkill、Tabletop、Fetch、Kitchen 等任务，以及需要单独准备 Isaac Sim / Isaac Lab 运行时的 RoboLab 单 DROID 任务。ARX One 与 Franka 的真实机器人支持标注为「即将推出」，当前公开包尚不包含受支持的实体机器人连接流程。

使用约束

• 安装与运行面向 Linux GPU 主机和 Python 3.11，README 未说明其他平台。
• 智能体的视觉模型需要 API Key 和兼容的模型端点，示例中的占位值必须替换。
• RoboLab 依赖独立的 Isaac Sim / Isaac Lab 环境，使用前应先查看对应集成文档。
• RoboDojo 默认启用深度；如需论文的 RGB-only 设定，使用 --no-depth，同时保留相机标定。
• 项目采用 MIT 许可证，上游代码、字体及外部资源/模型保留各自许可证。

HotRepo 点评

该项目于 2026-11-03 进入 HotRepo 新项目榜，首次记录到 100 star、6 fork，增量全部发生在 2026-11-02 起算的增长窗口内。这只是一个早期快照，说明项目获得了初步关注，但不足以判断趋势。与常见的智能体演示不同，它同时提供打包好的命令行、SDK、面板和具名仿真集成，并有配套论文；不过当前实际范围仍以仿真为主，实体机器人的能力需要按「即将推出」的状态来看待。

项目源码与说明