{
  "id": "openpi-examples-aloha-real-main-py",
  "name": "OpenPI: ALOHA real robot policy client",
  "summary": "Run the upstream ALOHA real-robot environment through an OpenPI policy server and action-chunk runtime. Inspect the pinned source and setup before use.",
  "framework": "openpi",
  "kind": "official_example",
  "source_registry": "official-robot-workflows-v1",
  "capabilities": [
    "policy-deployment",
    "robot-workflow"
  ],
  "robot_types": [
    "arm"
  ],
  "robot_scope": "The pinned source names ALOHA for this workflow. Hardware and observation/action configuration must match its upstream setup; source labels do not establish compatibility.",
  "source": {
    "repository": "https://github.com/Physical-Intelligence/openpi",
    "commit": "215abfb217dbac7d5f1273282331b9b1866c0479",
    "tag": "main",
    "path": "examples/aloha_real/main.py",
    "url": "https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/examples/aloha_real/main.py",
    "raw_url": "https://raw.githubusercontent.com/Physical-Intelligence/openpi/215abfb217dbac7d5f1273282331b9b1866c0479/examples/aloha_real/main.py",
    "sha256": "a6195287f804015d928793bcbfab427e21933745ce1d53224671c9e501182d14",
    "bytes": 1408,
    "authors": [
      "Physical Intelligence team"
    ]
  },
  "license": {
    "spdx": "Apache-2.0",
    "url": "https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/LICENSE",
    "sha256": "43070e2d4e532684de521b885f385d0841030efa2b1a20bafb76133a5e1379c1",
    "scope": "Selected first-party workflow Python source only; preserve all upstream copyright, author and per-file notices. This does not relicense model weights, datasets, Gemma or other third-party model code, robot firmware, simulator binaries, meshes, dependencies or external services; their separate terms and access requirements remain applicable.",
    "bytes": 11356
  },
  "access": {
    "mode": "source_reference",
    "hub_prepare": false,
    "instructions": "Fetch the pinned repository, verify this source checksum, and use upstream installation and invocation. This record does not install or execute code.",
    "setup_url": "https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/README.md",
    "setup_evidence": [
      {
        "path": "README.md",
        "url": "https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/README.md",
        "sha256": "567fc57766bd736664f50126cab8145af4071ca16cc5e238f2b11e369169c3b5",
        "bytes": 23254,
        "purpose": "upstream author and setup"
      },
      {
        "path": "pyproject.toml",
        "url": "https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/pyproject.toml",
        "sha256": "e1f457bd81622a47a4c4de17b92815977ac5fcd40116bec92398eb400bf76483",
        "bytes": 3110,
        "purpose": "Python/package declaration"
      },
      {
        "path": "examples/aloha_real/README.md",
        "url": "https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/examples/aloha_real/README.md",
        "sha256": "cd56d8224ee9500837fd83a00ffe7cc1c96008558a4a81fabaf96cdccf9a9a24",
        "bytes": 6440,
        "purpose": "ALOHA hardware setup"
      },
      {
        "path": "examples/aloha_sim/README.md",
        "url": "https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/examples/aloha_sim/README.md",
        "sha256": "3e25e00b1fb746176cfab0b74e8edad4a2c182f6fe1145f57d68bb67b38e5609",
        "bytes": 732,
        "purpose": "ALOHA simulation setup"
      },
      {
        "path": "examples/droid/README.md",
        "url": "https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/examples/droid/README.md",
        "sha256": "6f64c246a78a5c203b4b032db9b6b6daea33e98d91ecdac1a3da30a9863290d0",
        "bytes": 6870,
        "purpose": "DROID hardware setup"
      },
      {
        "path": "examples/libero/README.md",
        "url": "https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/examples/libero/README.md",
        "sha256": "a2caaf5459c4b01837b73aa93a6f69e8cdf10385b39c34eba36afa85f83fafe9",
        "bytes": 2551,
        "purpose": "LIBERO evaluation setup"
      }
    ]
  },
  "requirements": {
    "python": "Python >=3.11 as declared by the pinned pyproject.toml",
    "packages": [
      "Pinned OpenPI checkout and openpi-client",
      "Upstream uv environment; JAX/CUDA or PyTorch backend as selected",
      "Environment-specific ALOHA, DROID or LIBERO dependencies when selected"
    ],
    "display": "Upstream supports Ubuntu 22.04. Policy inference/training requires suitable NVIDIA GPU memory and separately obtained checkpoints/data; real robot clients additionally require the exact upstream robot setup and a configured policy server.",
    "execution_domain": "hardware",
    "source_imports": [
      "dataclasses",
      "examples.aloha_real",
      "logging",
      "openpi_client",
      "openpi_client.runtime",
      "openpi_client.runtime.agents",
      "tyro"
    ]
  },
  "invocation": {
    "entrypoint": "uv run examples/aloha_real/main.py",
    "notes": "Use the pinned upstream environment and CLI configuration, dataset/checkpoint paths and platform-specific README. Some upstream workflows can download assets or publish datasets; inspect flags before use. No checkpoint licensing, robot compatibility or runtime success is established by this source reference."
  },
  "popularity": {
    "metric": "github_stars",
    "repository_stars": 14274,
    "checked_at": "2026-10-18",
    "meaning": "Dated repository interest, not robot-skill usage, compatibility or runtime success."
  },
  "evidence": {
    "level": "source_reviewed",
    "runtime_verification": "not_run",
    "checked_at": "2026-10-18",
    "inspection": "Verified exact source, applicable license and author/setup document bytes at a full Git commit; parsed the Python AST and reviewed this guarded operational entrypoint and its explicit license notices. No upstream code, installation, robot command, dataset, mesh or checkpoint was executed or loaded.",
    "entrypoint_kind": "python_main",
    "inspection_method": "automated_static",
    "robot_discovery": {
      "scope": "Pinned setup names ALOHA for this real-robot client. Discovery only; camera/action/calibration and runtime prerequisites remain unverified.",
      "method": "reviewed_pinned_text_declaration",
      "compatibility_inferred": false,
      "evidence": [
        {
          "url": "https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/examples/aloha_real/README.md",
          "sha256": "cd56d8224ee9500837fd83a00ffe7cc1c96008558a4a81fabaf96cdccf9a9a24",
          "bytes": 6440,
          "quote": "# Run Aloha (Real Robot)",
          "labels": [
            "aloha"
          ],
          "match_in": "text"
        }
      ]
    }
  },
  "robots": [
    "aloha"
  ],
  "artifact": {
    "kind": "workflow",
    "format": "python",
    "workflow_role": "policy-deployment"
  }
}