Python SDK

pip install clousd
export CLOUSD_API_KEY=cl_live_…

from clousd import Clousd

c = Clousd()                                   # key from CLOUSD_API_KEY
run = c.run("Open Settings and tell me the Android version", device="c3f9a41d2", wait=True)
print(run.status, run.answer)                  # completed  Android 15

# the same task on several phones at once
run = c.run("Open the app and tell me what the first screen shows", devices=["c3f9a41d2", "c81d07e5a"], wait=True)
for r in run.children:
    print(r.device, r.status, r.answer)

login = c.credentials("com.example.shop")[0]  # names only; the values never leave Clousd
run = c.run("Sign in and tell me how many orders there are", device="c3f9a41d2", credentials=[login], mode="ask",
            output_schema={"type": "object", "properties": {"orders": {"type": "integer"}}})
for ev in run.events():                        # live: status, plan, step, card, answer, end
    if ev["event"] == "step":
        print(ev["data"]["n"], ev["data"]["tool"], ev["data"]["result"])
    if ev["event"] == "card":
        run.reply(allow=True)                  # or run.reply("the first one")
print(run.refresh().structured_output)         # {"orders": 3}

phone = c.device("c3f9a41d2")
phone.open_app("com.android.chrome")           # act
phone.tap_text("Search")
phone.type("weather in Berlin")
phone.key("enter")
phone.wait_text("Berlin", timeout=30)          # check
png = phone.screenshot(width=540)              # look