Python SDK

The Python SDK mirrors the same ACP platform model as the JavaScript SDK. It works well for data systems, internal tooling, scheduled operations, and service backends that already standardize on Python.

Python SDK

Use Python for ACP automation, research systems, background jobs, and backend control of threads, computers, resources, and data.

Install and initialize

The Python SDK uses the same product model and API semantics as the JavaScript SDK. Start with one client and then decide whether you want the convenience run() flow or explicit control over threads and resources.

Use COMPUTER_AGENTS_API_KEY or pass api_key explicitly.

Use run() when you want high-level execution quickly.

Switch to resource managers for lifecycle control and automation.

Install the Python SDK

Initialize the Python client

Core execution managers

Python exposes the same platform primitives: threads, computers, agents, files, resources, databases, and automation managers. That keeps service behavior consistent across SDK languages.

Use client.threads for stateful thread execution and streaming callbacks.

Use client.computers for persistent execution state and runtime management.

Use client.agents for reusable execution profiles.

Use client.files to work with environment file state directly.

Run ACP from Python

Product-shaped managers in Python

Python also now exposes first-class product managers rather than forcing every app surface through one generic resources object. That keeps day-to-day usage clearer and closer to the ACP product model.

Use client.web_apps for deployed app surfaces.

Use client.functions for backend functions.

Use client.auth for auth modules and user operations.

Use client.databases for database, collection, and document operations.

Create app resources in Python

Automation and platform operations

The Python SDK is especially useful when ACP needs to live inside recurring jobs or backend operations. Skills, schedules, triggers, orchestrations, billing, and git helpers all stay available from one client.

Use Python for cron-like operations that also need ACP schedules and triggers.

Use the billing and budget surfaces to monitor CT usage programmatically.

Use the git and files helpers to automate repository-aware execution flows.