Python SDK

1
from chaser_sdk import ChaserClient
2
3
client = ChaserClient(api_key="sk_...", account="personal")

1
# Create a sandbox session
2
session = client.sessions.create(
3
    session_type="sandbox",
4
    workspace="my-project",
5
)
6
7
client.sessions.wait_until_ready(session["id"])
8
9
# Create a browser session
10
browser = client.sessions.create(
11
    session_type="browser",
12
    ephemeral=True,
13
)

1
# Run in an existing session
2
result = client.exec.in_session(
3
    session["id"],
4
    command="npm ci && npm test",
5
    cwd="/workspace",
6
)
7
8
# Auto-provisioned ephemeral sandbox
9
result = client.exec.run(
10
    ephemeral=True,
11
    image="node:20-bookworm",
12
    command="python3 -c 'print(42)'",
13
)

1
workspace = client.workspaces.create(
2
    name="frontend-app",
3
    session_type="sandbox",
4
    image="ghcr.io/example/dev:latest",
5
)

1
session = client.sessions.create(
2
    session_type="sandbox",
3
    ephemeral=True,
4
    proxy="socks5h://user:pass@proxy.example.com:1080",
5
)

1
client.files.upload_text(session["id"], "/workspace/hello.txt", "hello")
2
text = client.files.download_text(session["id"], "/workspace/hello.txt")

1
# Get the WebSocket URL
2
ws_url = client.browser.cdp_websocket_url(browser["id"])
3
4
# With the cdp extra: open a connection
5
cdp = client.browser.connect(browser["id"])
6
print(cdp.send("Browser.getVersion"))
7
cdp.close()

1
org_client = client.with_account("Acme Engineering")
2
workspaces = org_client.workspaces.list()