Developer quickstart

Take your first steps with the Agentic Compute Platform. This flow covers the exact ACP path most teams use: authenticate, install the SDK, get a computer, create a thread, and stream execution.

Create and export an API key

Create an ACP API key in your dashboard, then export it as an environment variable so the SDK and direct HTTP requests can authenticate automatically.

Export an environment variable on macOS or Linux systems

Install the SDK and run an API call

Install the ACP SDK, then use the high-level run() entry point for the fastest path to a working result.

Install the ACP SDK with npm

Run a task

Get a computer

When you want more control than a one-shot run, create a project and computer explicitly. ACP uses the raw API term environment, but in the product this is the same thing as a computer.

Quick setup

Create a thread

Threads are the main execution primitive in ACP. They bind together the computer, agent, conversation history, execution steps, and file changes.

Create and execute

Stream progress

ACP emits streaming events during execution. Use them to render logs, file updates, status changes, and assistant deltas as the thread progresses.

Streaming example