Instantiate Components

Preview: The config system (physicalai.config) is a planned API. The examples below document the target design. Currently, ComponentSpec lives in physicalai.inference.manifest.

A component spec describes one instantiable object.

The most explicit form uses a class path.

class_path: physicalai.capture.UVCCamera
init_args:
  device: /dev/video0
  width: 640
  height: 480

The shorter form uses a registry name.

type: uvc
device: /dev/video0
width: 640
height: 480

You can construct and instantiate the same spec from Python.

from physicalai.inference.manifest import ComponentSpec
from physicalai.inference.component_factory import instantiate_component

spec = ComponentSpec(
    class_path="physicalai.capture.UVCCamera",
    init_args={"device": "/dev/video0", "width": 640, "height": 480},
)

camera = instantiate_component(spec)

Nested component specs are instantiated recursively.

class_path: physicalai.runtime.PolicyRuntime
init_args:
  robot:
    class_path: physicalai.robot.so101.SO101
    init_args:
      port: /dev/ttyACM0
  cameras:
    wrist:
      class_path: physicalai.capture.UVCCamera
      init_args:
        device: /dev/video0

ComponentSpec describes what should be built. Instantiation is the separate step that creates the live object.