Puda Edge

Help write Python edge services: thin hardware wrappers that connect to NATS and advertise machine commands.

Follow Integrating a New Machine for repo layout, main.py config, telemetry, and multi-machine PCs. Scaffold from edge-python-template. Name the repo puda-<machine_id>-edge.

Python only. For host/NATS/hardware commissioning, use puda-deployment. After commands work, install the CLI with puda.

Scaffold

1. Create the repo from the template. Resolve every TODO.
2. Set a unique lowercase hyphenated MACHINE_ID in .env with NATS_SERVERS.
3. Implement driver.py, then wire config and the driver into main.py.
4. Keep helpers private (_name). Only @command methods are advertised.

Verify with puda machine commands <machine_id> after the edge is connected.

Several instruments on one PC can share one uv workspace; each subdirectory gets its own MACHINE_ID, driver.py, and main.py. See the docs and PUDAP/ViPSA.