Python twins - Arga

List twins

for twin in client.twins.list():
    print(twin.name, twin.label, twin.kind)

Provision

result = client.twins.provision(
    twins=["stripe", "slack"],
    ttl_minutes=60,
    scenario_id="scenario-id",  # optional
    public=True,
)

run_id = result["run_id"]

Poll until ready:

status = client.twins.get_status(run_id)
if status.status == "ready":
    for name, twin in status.twins.items():
        print(name, twin.base_url, twin.env_vars)

Generate seed data from a prompt

Generation mode options require arga-py-sdk 0.1.5 or later.

result = client.twins.provision(
    twins=["slack"],
    scenario_prompt="A support channel with linked escalation threads and consistent message authors",
    scenario_generation_mode="thorough",
)
run_id = result["run_id"]

Use scenario_generation_mode="fast" for everyday scenarios, or omit it to use the server’s Fast default. Thorough handles complex requirements with a longer wait. A scenario_id takes precedence and reuses saved seed data. These options work with both Arga and AsyncArga; await calls on the async client.

Reset, extend, and tear down

client.twins.reset(run_id)
client.twins.extend(run_id, ttl_minutes=90)
client.twins.teardown(run_id)

reset restores the baseline captured when the Twin Run was provisioned. teardown ends the run immediately.