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>.
Select a NATS profile: Inspect puda profile list and puda profile current. Use an existing intended profile with puda profile switch <name>. For a new profile, get the name and broker URLs from the user or deployment configuration; do not assume the lab. Plaintext: puda profile add <name> --servers <nats-urls>. Encrypted: puda profile add <name> --servers <tls-urls> --ca <local-ca-path> --key <local-key-path>. Both files are required for an encrypted CLI profile. The first profile is activated automatically if none is selected; otherwise explicitly switch to the intended profile. Read CLI profiles and telemetry when configuring or migrating connections.
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>).