# OpenPI random-observation policy client

Send synthetic ALOHA, ALOHA_SIM, DROID or LIBERO observation-shaped data to an OpenPI WebSocket policy server and report inference timing. This client generates random inputs; it does not read robot cameras, run a robot controller or move physical hardware.

ID: `openpi-simple-client`

Record version: `source-3f4445762376cfa25ce0812ecaacc225f4ddc7d2ab66d219563d6150803c6767`

Hub commit: `3a81abb601c3b4b8fcb9a8bed5ca270e546f5f1a`

## Access

Inspect the exact pinned upstream artifact and setup instructions. This record has no Hub runtime adapter.

Hub preparation adapter: **false**. Runtime verification: **not_run**.

Upstream setup: https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/examples/simple_client/README.md

## Source and license

- Repository: https://github.com/Physical-Intelligence/openpi
- Pinned source: https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/examples/simple_client/main.py
- Revision: `215abfb217dbac7d5f1273282331b9b1866c0479`
- Path: `examples/simple_client/main.py`
- Source SHA256: `3f4445762376cfa25ce0812ecaacc225f4ddc7d2ab66d219563d6150803c6767`
- Source bytes: 6281
- Original authors: Physical Intelligence contributors
- License: [Apache-2.0](https://github.com/Physical-Intelligence/openpi/blob/215abfb217dbac7d5f1273282331b9b1866c0479/LICENSE)
- License scope: The pinned repository license covers this example source code. Preserve upstream notices and attribution. Model weights, datasets, external policy servers and third-party dependencies retain their own applicable licenses.

## Artifact

```json
{
  "format": "Python CLI / WebSocket policy client",
  "kind": "tool"
}
```

## Requirements

```json
{
  "hardware": [
    "CPU client; no physical robot is required",
    "Policy-server compute and model requirements are configured separately"
  ],
  "notes": "Source inspection only. Random RGB-shaped arrays and synthetic numeric state are sent to the configured server; the returned data is used for timing statistics. The upstream full workspace documents Ubuntu 22.04 and Python >=3.11. Client-only platform portability, installation, policy inference and robot execution were not tested. The server and model/checkpoint setup are separate.",
  "packages": [
    "openpi-client==0.1.0 from the pinned packages/openpi-client source",
    "numpy>=1.22.4,<2.0.0",
    "polars>=1.30.0",
    "rich>=14.0.0",
    "tyro>=0.9.5",
    "tqdm (imported by this example; follow the upstream environment)"
  ],
  "python": ">=3.11 for the pinned upstream workspace; the example also uses Python 3.10 union annotations",
  "system": [
    "Network access to an operator-configured OpenPI WebSocket policy server",
    "Pinned upstream checkout and its configured uv environment"
  ]
}
```

## Invocation

```json
{
  "entrypoint": "uv run examples/simple_client/main.py --env ALOHA_SIM --host 127.0.0.1 --port 8000 --num-steps 20",
  "notes": "Run from the pinned checkout only after configuring the upstream environment and a compatible policy server. Supported --env values in the source are ALOHA, ALOHA_SIM, DROID and LIBERO. Optional timing-file output writes a Parquet file. Credentials, if required by the chosen server, must be configured locally. This documented command has not been executed."
}
```

## Compatibility

```json
[
  {
    "runtime": "openpi-client",
    "runtime_version": "0.1.0",
    "robot": "none",
    "controller": "none",
    "observation": "synthetic_aloha",
    "os": "unknown",
    "status": "contributor_reported"
  },
  {
    "runtime": "openpi-client",
    "runtime_version": "0.1.0",
    "robot": "none",
    "controller": "none",
    "observation": "synthetic_droid",
    "os": "unknown",
    "status": "contributor_reported"
  },
  {
    "runtime": "openpi-client",
    "runtime_version": "0.1.0",
    "robot": "none",
    "controller": "none",
    "observation": "synthetic_libero",
    "os": "unknown",
    "status": "contributor_reported"
  }
]
```

Missing environment fields remain unknown. Source discovery labels do not establish robot compatibility.

## Evidence

Level: **contributor_reported**. Runtime verification: **not_run**.

Data-only intake structure checked. Source content, checksum, license and runtime claims require maintainer review; no submitted code was executed.

Source review and contributor reports do not establish task completion. Preserve upstream attribution and licenses.