# OmniSocketGo deployment bundle — 2026-08-08

This delivery bundle contains two independent source archives.

## Archive roles

### `OmniSocketGo_robot-20260808.tar.gz`

Transfer this archive to the physical robot. It contains:

- `b_side_omnid` source code;
- head/waist camera switching;
- serial-number based `/dev/video*` discovery;
- camera occupancy reporting and known-service release logic;
- direct-LAN and robot-side startup scripts;
- robot-side `requirements.txt` and installation notes.

Build it on the robot. Do not copy x86_64 host binaries to an ARM64 robot.

### `OmniSocketGo_host-20260808.tar.gz`

Install this archive on the operator/control computer. It contains:

- `OmniSocketGo_add_camera` for the local/public KCP transport;
- `robot-command-center` Django backend;
- `robot-command-center` Vue frontend, including camera switching and waist
  image rotation;
- host-side `requirements.txt` and installation notes.

This archive can also supply the source needed to build `bin/kcpserver` on a
future public relay server. The public server only needs the KCP Hub binary and
does not need `robot-command-center`.

## Verify downloads

Run from the directory containing this README:

```bash
sha256sum -c SHA256SUMS
```

## Extract

Robot:

```bash
tar -xzf OmniSocketGo_robot-20260808.tar.gz
cd OmniSocketGo_robot-20260808
```

Control host:

```bash
tar -xzf OmniSocketGo_host-20260808.tar.gz
cd OmniSocketGo_host-20260808
```

Read each archive's `README_PACKAGE.md` and `requirements.txt` before building.

## Important configuration boundary

```text
Physical robot:
  OmniSocketGo_robot only

Control host:
  OmniSocketGo_add_camera
  robot-command-center

Future public KCP Hub:
  build and run bin/kcpserver from OmniSocketGo_add_camera source
```

Git does not automatically copy local uncommitted changes to the robot. These
archives capture the current working files, including the local camera and
frontend improvements, while excluding Git metadata, logs, virtual environments,
compiled binaries, frontend `node_modules` and generated frontend `dist` files.