Metadata-Version: 2.4
Name: uni-robot-agent
Version: 0.1.0
Summary: A unified harness for robot-use agents, with CLI, Python SDK, and live monitoring
License-Expression: MIT
Project-URL: Documentation, https://uni-robot-agent.com/docs
Project-URL: Homepage, https://uni-robot-agent.com/
Keywords: robotics,agents,mcp,embodied-ai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0.0
Requires-Dist: huggingface-hub<2,>=0.28
Requires-Dist: numpy>=1.24
Requires-Dist: pillow>=10
Requires-Dist: pydantic<3,>=2
Requires-Dist: jsonschema>=4.18
Requires-Dist: httpx<1,>=0.28
Requires-Dist: fastapi<1,>=0.115
Requires-Dist: uvicorn<1,>=0.30
Requires-Dist: openai-codex==0.147.0
Requires-Dist: claude-agent-sdk==0.2.165
Requires-Dist: textual>=0.70.0
Provides-Extra: tui
Provides-Extra: codex
Provides-Extra: claude
Provides-Extra: dev
Requires-Dist: build>=1; extra == "dev"
Requires-Dist: twine>=6; extra == "dev"
Provides-Extra: robolab
Requires-Dist: scipy>=1.10; extra == "robolab"
Requires-Dist: trimesh<5,>=4; extra == "robolab"
Requires-Dist: python-fcl<0.8,>=0.7; extra == "robolab"
Provides-Extra: robodojo
Requires-Dist: trimesh<5,>=4; extra == "robodojo"
Requires-Dist: imageio>=2.0; extra == "robodojo"
Requires-Dist: scipy>=1.10; extra == "robodojo"
Requires-Dist: imageio-ffmpeg>=0.4; extra == "robodojo"
Dynamic: license-file

# uni-robot-agent

A unified harness for robot-use agents, with Codex and Claude Code runtimes,
a Python SDK, shared robot tools, and a local monitoring dashboard.

[Documentation](https://uni-robot-agent.com/docs) · [Project website](https://uni-robot-agent.com/)

## Install

Use Python 3.11+ in a virtual environment:

```bash
pip install uni-robot-agent
# or: uv pip install uni-robot-agent
uni-robot-agent --version
```

For an isolated CLI, use `uv tool install uni-robot-agent`. For the SDK in a uv
project, use `uv add uni-robot-agent`.

## Run a task

On a Linux GPU host with Python 3.11, prepare RoboDojo once, then run a task:

```bash
uni-robot-agent setup --integration robodojo

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
```

Set your vision model and Responses-compatible endpoint. Open the printed
dashboard URL to follow execution, or replay results later with
`uni-robot-agent monitor --run-dir ./runs`.

## Python SDK

Connect to an already running environment service using the same credentials:

```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)
```

The package includes prompts, skills, deployment recipes and dashboard assets.
Simulator runtimes, assets, GPU drivers and model weights are prepared separately;
see the documentation for host requirements. macOS supports the CLI and SDK with
remote environment services and local replay. Physical-robot workflows are not
part of this initial release.

Released under the MIT License. Bundled upstream components and external assets
retain their respective licenses.
