Skip to content

Physical AI

Package Value
Distribution archetype-physical-ai
Import package archetype.physical_ai

Recommended API. Run or recover complete Modal-hosted episode batches through a World.

PhysicalAI 

PhysicalAI(world)

Expose Physical-AI workflows for one world.

Construct this adapter directly or through world.library("physical-ai"). The wrapped world remains the owner of lazy activation and operation admission; this adapter contributes only Physical-AI behavior.

run_hosted_episode async 

run_hosted_episode(requests, *, provider, activity_id=None)

Run or recover one complete Modal-hosted episode batch.

HostedEpisodeRequest dataclass 

HostedEpisodeRequest(
    trial_id,
    suite,
    task_id,
    seed,
    instruction,
    max_transitions,
    environment_id,
    policy_id,
    config_json="{}",
)

One deterministic episode in a hosted provider request batch.

Field Type Default
trial_id int required
suite str required
task_id int required
seed int required
instruction str required
max_transitions int required
environment_id str required
policy_id str required
config_json str '{}'

HostedEpisodeObservation

Committed factual binding to one complete, durable hosted result.

Field Type Default
activity_id str required
operation_id str required
request_ref str required
request_digest str required
result_ref str required
result_digest str required
trajectory_ref str required
trajectory_digest str required
episode_results_ref str required
episode_results_digest str required
manifest_ref str required
manifest_digest str required
episode_count int required
trajectory_row_count int required
transition_count int required
success_count int required

ModalHostedEpisodeConfig dataclass 

ModalHostedEpisodeConfig(
    workspace_name,
    environment_name,
    app_name,
    function_name,
    result_dict_name,
    result_volume_name,
    protocol_epoch=MODAL_HOSTED_EPISODE_PROTOCOL_EPOCH,
    call_timeout_seconds=900,
    create_if_missing=False,
)

Exact persistent Modal namespace used by one hosted provider adapter.

Field Type Default
workspace_name str required
environment_name str required
app_name str required
function_name str required
result_dict_name str required
result_volume_name str required
protocol_epoch int 1
call_timeout_seconds int 900
create_if_missing bool False