Config Schema Reference

Preview: The config system and PolicyRuntime are planned APIs. The schemas below document the target design.

Config files use class_path and init_args to describe explicit component construction.

ComponentSpec

Direct class mode:

class_path: package.module.ClassName
init_args:
  key: value

Registry mode:

type: registered_name
key: value

The ComponentSpec fields are listed below.

Field	Type	Description
class_path	string	Fully qualified import path
init_args	object	Constructor keyword arguments
type	string	Registered short name
extra fields	any	Flat constructor args for registry mode

The core rules are straightforward.

• A component spec must include either class_path or type.

• If both fields are present, class_path takes precedence.

• Nested component specs are instantiated recursively.

RuntimeConfig

runtime:
  class_path: physicalai.runtime.PolicyRuntime
  init_args:
    fps: 30
    robot:
      class_path: physicalai.robot.so101.SO101
      init_args:
        port: /dev/ttyACM0
    model:
      class_path: physicalai.inference.InferenceModel
      init_args:
        export_dir: ./exports/act_policy
    execution:
      class_path: physicalai.runtime.SyncExecution
      init_args:
        mode: chunk

The most common runtime fields are listed below.

Field	Type	Description
runtime	ComponentSpec	Runtime orchestrator
runtime.init_args.fps	number	Control loop frequency
runtime.init_args.robot	ComponentSpec	Robot implementation
runtime.init_args.model	ComponentSpec	Inference model
runtime.init_args.execution	ComponentSpec	Execution strategy
runtime.init_args.cameras	mapping	Optional camera components
runtime.init_args.callbacks	list	Optional runtime callbacks

InferenceConfig

model:
  class_path: physicalai.inference.InferenceModel
  init_args:
    export_dir: ./exports/act_policy
    backend: openvino
    device: CPU

The most common inference fields are listed below.

Field	Type	Description
model	ComponentSpec	Inference model component
model.init_args.export_dir	string	Exported package directory
model.init_args.backend	string	Backend name or auto
model.init_args.device	string	Backend device or auto

Config vs Manifest

Schema	Use
Workflow config	A workflow config describes a workflow before execution.
Manifest	A manifest describes an exported package after export.