Open-RUA/uni-robot-agent

选用指南

AI 根据 README 整理 · 2026/11/3 18:37:27

使用方式

通过命令行运行任务，或使用 Python SDK 进行自定义策略开发，支持本地仪表盘监控。

查看 README 依据

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 ``` Open the printed dashboard URL; results are saved under `./runs`. [More options](https://github.com/Open-RUA/uni-robot-agent/blob/main/docs/getting-started.md). <a id="python-sdk"></a> ## Python SDK Run the agent against an already running environment. This uses the same API key

as the CLI; replace the model and provider placeholders with your settings: ```python 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) ``` `agent_finished` records agent completion; `task_success` is the environment's

reported outcome, or `None` when unavailable. Use `Session.tools` to implement a custom strategy, `RunRecord` to read saved runs, and `setup()` / `deploy()` to own local services explicitly. See the [SDK guide](https://github.com/Open-RUA/uni-robot-agent/blob/main/docs/sdk.md) and [Python examples](https://github.com/Open-RUA/uni-robot-agent/tree/main/examples/sdk/). <a id="dashboard"></a> ## Dashboard Add `--monitor` to a CLI run to view camera streams, tool calls, execution timing and available task outcomes. The monitor prints a local URL; no frontend build or upload is required.

部署要求

需要 Python 3.11 虚拟环境，并建议在 Linux GPU 主机上运行。

查看 README 依据

and [observation settings](https://github.com/Open-RUA/uni-robot-agent/blob/main/docs/integrations.md#realistic-observation-settings). <a id="quick-start"></a> ## Quick start **1. Install and prepare RoboDojo.** Use a Python 3.11 virtual environment on a [Linux GPU host](https://github.com/Open-RUA/uni-robot-agent/blob/main/docs/deployment.md#host-prerequisites-and-runtime-storage). ```bash pip install uni-robot-agent # or: uv pip install uni-robot-agent uni-robot-agent setup --integration robodojo ``` **2. Run a task.** Set your vision model and Responses-compatible endpoint: ```bash

已知限制

当前版本不包含物理机器人连接工作流，真实机器人集成即将推出。

查看 README 依据

| **RoboLab** | Single-DROID tasks in a separately prepared Isaac Sim / Isaac Lab runtime | [Integration](https://github.com/Open-RUA/uni-robot-agent/blob/main/docs/robolab.md) | ### Real robots | Platform | Public release status | |---|---| | **ARX One** | Coming soon | | **Franka** | Coming soon | Real-robot integrations and deployment guides are coming soon. The public package does not yet include a supported physical-robot connection workflow. <a id="how-it-works"></a> ## How it works <p align="center">