chaser-sdk 0.2.1

Official Python SDK for Chaser

chaser-sdk

Official Python SDK for Chaser.

This package is the Python SDK for the core public Chaser surface:

• sessions
• workspaces
• exec
• command lifecycle
• files
• runtime self-tests and preview URLs
• browser CDP helpers
• accounts and organizations
• service accounts and keys
• billing
• lifecycle webhooks
• audit
• jobs

Installation

pip install chaser-sdk

Optional CDP websocket support:

pip install 'chaser-sdk[cdp]'

Quickstart

from chaser_sdk import ChaserClient

client = ChaserClient(api_key="sk_...", account="personal")

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

session = client.sessions.create(
    workspace=workspace["name"],
    session_type="sandbox",
)

client.sessions.wait_until_ready(session["id"])
result = client.exec.in_session(
    session["id"],
    command="node -v && pwd",
    cwd="/workspace",
)

print(result.get("output"))

All write helpers accept keyword arguments, and the legacy payload-dict form still works for backward compatibility.

Proxy selection

session = client.sessions.create(
    session_type="sandbox",
    ephemeral=True,
    proxy="socks5h://user:[e-mail]:1080",
)

Use the root-level proxy field for the public API contract.

Stateless exec

result = client.exec.run(
    ephemeral=True,
    image="node:20-bookworm",
    command="python3 -c 'print(42)'",
)

Files and previews

client.files.upload_text(session["id"], "/workspace/hello.txt", "hello from sdk")
text = client.files.download_text(session["id"], "/workspace/hello.txt")
preview = client.sessions.forward_url(session["id"], 3000)

Runtime self-test

diagnostics = client.sessions.self_test(session["id"])
print(diagnostics["runtime"]["tools"].get("node"))

Browser CDP helper

browser = client.sessions.create(session_type="browser", ephemeral=True)
ws_url = client.browser.cdp_websocket_url(browser["id"])
print(ws_url)

If you install the optional cdp extra, you can also open a lightweight websocket client:

cdp = client.browser.connect(browser["id"])
print(cdp.send("Browser.getVersion"))
cdp.close()

Organization automation

org_client = client.with_account("Acme Engineering")
service_account = org_client.accounts.service_accounts.create("ci-bot")
key = org_client.accounts.service_accounts.keys.create(
    service_account["id"],
    name="ci-key",
    scopes=["sessions.read", "workspaces.write", "exec.write", "files.read", "webhooks.write"],
)
print(key["key"])