PhyAgentOS
PhyAgentOS is an agent framework for embodied tasks that separates execution, evidence, and verification. It solves the problem of ensuring user-visible goals are actually achieved by physical agents, using a Forge Gateway contract and task-level verification. It is for developers building simulation or real-robot agents.
✨ Key features
- One versioned Forge Gateway contract for all robot actions
- Evidence capture before/after actions with validation and metadata
- Action-agnostic verification with modes: off, audit, enforce, recovery
- Crash-safe SQLite persistence for tasks, plans, and invocations
- Planner-owned recovery with bounded plan revisions
- Scoped experience: skills and lessons from verified tasks
🎯 Use cases
- Building embodied agents that manipulate objects in simulation or real robots
- Implementing task verification with visual evidence and success criteria
- Managing recoverable task execution with bounded replanning
- Installing and running Forge Skills for robot control
- Integrating with Dora pipelines for robot/simulator communication
📦 Installation
🧰 Requirements: Python 3.11 or 3.12; optional Dora CLI v0.4.1 for managed skill profiles; API key for model provider (e.g., OpenRouter).
git clone https://github.com/PhyAgentOS/PhyAgentOS-core.git
cd PhyAgentOS-core
python -m pip install -e .python -m pip install -e ".[dev]"Python 3.11 or 3.12 is recommended. Concrete Forge Skills and their Runtime artifacts are distributed separately.
Dora is not required for the general Agent or for paos skill install. It is required on PATH when paos skill start launches a managed Forge Skill profile. PhyAgentOS 1.0.0 uses Dora CLI v0.4.1 with dora-message v0.7.0 as its Forge Skill compatibility baseline. On Linux or macOS, install that exact release:
curl --proto '=https' --tlsv1.2 -LsSf \
https://github.com/dora-rs/dora/releases/download/v0.4.1/dora-cli-installer.sh | sh
dora --version
# dora-cli 0.4.1
# dora-message: 0.7.0
🚀 Usage
paos onboardpaos agentpaos agent -m "Inspect Forge capabilities, then place the object in the target area and verify the visible result."❓ FAQ
What Python versions are supported?
Python 3.11 or 3.12 is recommended.
Is Dora required?
Dora is not required for the general Agent or for paos skill install, but it is required on PATH when paos skill start launches a managed Forge Skill profile.
How do I install a Forge Skill?
Use paos skill install <skill-name> --version <version> or install a local bundle with paos skill install /path/to/<skill-name>-<version>.tar.gz --local.
What are the verification modes?
The modes are off, audit, enforce, and recovery. off never recovers, audit records verdicts but does not control success, enforce fails closed on missing evidence or errors, and recovery adds planner-owned recovery with bounded plan revisions.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.