physicalai-runtime-running-policy-on-robot
Runs exported policies on hardware with PolicyRuntime, execution modes, and physicalai run. Use when wiring PolicyRuntime, SyncExecution or RTC execution, runtime YAML configs, action queues, runtime callbacks, or docs/how-to/runtime run-policy-on-robot and execution modes.
How do I install this agent skill?
npx skills add https://github.com/openvinotoolkit/physicalai --skill physicalai-runtime-running-policy-on-robotIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides instructions and code examples for deploying and running AI policies on robotic hardware using the physicalai framework. It covers configuration via Python and YAML, execution modes, and basic testing procedures.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Running a Policy on a Robot
PolicyRuntime (src/physicalai/runtime/runtime.py) owns the control loop; InferenceModel owns policy math. Execution strategy lives under src/physicalai/runtime/execution.py and src/physicalai/runtime/rtc_execution.py. CLI: physicalai run in src/physicalai/cli/run.py instantiates from YAML via jsonargparse.
Workflow
-
Choose API vs config: Python for notebooks/tests; YAML +
physicalai runfor reproducible deployment.- Done when: entry point matches the user's task.
-
Python minimal loop (see
docs/how-to/runtime/run-policy-on-robot.md):from physicalai.runtime import PolicyRuntime, SyncExecution from physicalai.inference import InferenceModel from physicalai.robot import SO101 from physicalai.capture import UVCCamera runtime = PolicyRuntime( fps=30, robot=SO101(port="/dev/ttyACM0"), model=InferenceModel("./exports/act_policy"), cameras={"wrist": UVCCamera(device="/dev/video0", width=640, height=480)}, execution=SyncExecution(), ) with runtime: runtime.run(duration_s=60)- Done when: components connect and the loop runs in a test or dry-run with fakes.
-
YAML config — nest
class_path/init_argsfor robot, model, cameras, execution; run:physicalai run --config runtime.yaml --run.duration_s=60 -
Execution mode — pick sync vs RTC per
docs/how-to/runtime/use-execution-modes.md; do not build ad-hoc timing aroundInferenceModel.select_actionwhenPolicyRuntimeshould own the queue. -
Callbacks — register via runtime callback APIs (
docs/how-to/runtime/add-runtime-callbacks.md) for telemetry/latency, not inside inference adapters.
Validation loop
uv run pytest tests/unit/runtime/ -q
Use fake robots/cameras from runtime tests when hardware is unavailable.
Required checks
fpsand camera read rates are consistent.- Action dimensions match robot
send_actionexpectations. - Config
class_pathtargets are importable without training packages. - Document breaking changes to runtime config schema in
docs/reference/config-schema.md.
References
docs/how-to/runtime/run-policy-on-robot.mddocs/how-to/config/write-runtime-config.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/openvinotoolkit/physicalai/physicalai-runtime-running-policy-on-robot">View physicalai-runtime-running-policy-on-robot on skillZs</a>