PUDA context

PUDA, the Physical Unified Device Architecture, is a hardware-agnostic and LLM-agnostic runtime for Physical AI. It gives AI agents and software systems a unified, verifiable control plane for physical machines by separating high-level agent logic from low-level machine execution.

At a high level, PUDA uses a message-driven architecture built around NATS, a CLI-first interface for agents and humans, declarative protocols for experiment or workflow execution, edge services that translate commands into native machine driver calls, and project records that preserve command/data provenance. Treat PUDA as the agent-native bridge between planning, machine control, execution logs, and generated reports.

For more information on PUDA, setup, or any other questions, refer to https://docs.puda.co/llms.txt.

Setup puda

Install CLI: Ensure puda is installed and on your PATH so it can be invoked globally. If missing, download the binary for your platform from the Puda releases page, install it, and add it to PATH.
Ensure dependencies: Ensure python3, pip, and npx are available; install them first if missing.
Login: Ask the user for their username if not already known — do not assume. Log in with puda login -u <username>.
Setup NATS servers: Run puda config list to see the current nats_servers value. If not set or the user wants to change it, ask for the comma-separated NATS server URLs — do not assume. Set with puda config set nats_servers <comma-separated-urls>.
Install skills: Run puda skills install to install agent skills for puda.

Setup project

Run puda init (e.g. puda init . or puda init <folder_name>).