Quickstart

Start building with Computer Agents.

Create an API key, install the SDK, get a persistent computer, start a thread, and stream the work as agents execute inside a real workspace.

Start now

Authenticate once

Create an API key, export it locally, and use the same credentials from SDKs or HTTP.

Get a computer

Create a persistent cloud computer where agents can browse, run code, and manage files.

Start execution

Run a thread, send a task, or attach work to a project ticket with shared context.

Stream progress

Listen to execution events, logs, file changes, status updates, and final summaries.

What you can build

The SDK is the same control surface behind the Computer Agents platform. Use it from apps, scripts, services, notebooks, CI jobs, and internal tools.

Agentic product workspaces

Plan releases, create tasks, start task-linked threads, review work, and keep context connected.

Persistent cloud computers

Give agents files, packages, Git state, browser access, terminal access, and a workspace that survives sessions.

Hosted product resources

Deploy web apps, functions, databases, auth, agent runtimes, and secret vaults from the same workspace.

Automated research and operations

Run Metronome workflows, queue Batch jobs, schedule recurring work, trigger agents from events, and build your own control planes.

Measured autonomous delivery

Combine Tests, Evaluations, assurance, optimization campaigns, and release control into auditable delivery systems.

Core concepts

Start with these primitives. Most workflows combine a computer, a thread, and optionally a project task or deployed resource.

Concept

What it means

Threads

Multi-turn agent sessions with messages, logs, reasoning, diffs, feedback, and resumable state.

Computers

Persistent cloud workspaces where agents browse, run code, edit files, install packages, and keep state.

Projects

Shared workspaces for strategy, releases, tasks, comments, resources, reviews, and task-linked threads.

Agents

Reusable agent profiles with model, instructions, skills, reasoning effort, and analytics.

Metronomes and Batches

Versioned workflows plus a durable, reorderable queue for capacity-aware and deferred execution.

Tests and Evaluations

Deterministic engineering evidence and versioned behavioral evaluation runs for measurable quality.

Resources

Deployable product surfaces: Web Apps, Functions, Databases, Auth, Agent Runtimes, and Secrets.

Skills

Reusable capabilities agents can invoke, such as research, image generation, app deployment, and task management.

Create and export an API key

Create an API key in Computer Agents, then export it so the SDK and direct HTTP requests can authenticate automatically.

Export your key

Choose a cloud or appliance deployment

The same client targets Computer Agents Cloud and local appliances. Pass a deployment origin or an already-versioned /v1URL, then optionally scope all calls to one organization.

Configure deployment and organization

SDK URL normalization applies to regular requests, event streams, downloads, and multipart uploads. Direct HTTP calls always use the canonical /v1 prefix.

Install the SDK and run one task

The fastest path is run(). It creates the needed execution context, streams progress, and returns the final result.

Install

Run a task and stream progress

Create a persistent computer and thread

Use this path when you want explicit control over the workspace. The same computer keeps files, installed packages, Git state, and runtime context across multiple thread turns.

Create a computer, start a thread, and continue later

Use projects when work needs team context

Projects give agents the surrounding plan: strategy, releases, backlog, comments, dependencies, resources, and review policy.

Create a project, release, task, comment, and task-linked thread

Deployable resources

Resources let humans and agents ship software from the same workspace where the work is planned and built.

Manager

Resource

Typical use

client.webApps

Web Apps

Dashboards, internal tools, portals, AI chat apps, and prototypes.

client.functions

Functions

APIs, webhooks, scheduled jobs, data transforms, and backend actions.

client.databases

Databases

Collections and JSON documents for apps, functions, auth flows, and agents.

client.auth

Auth

Sign-up, sign-in, sessions, user administration, and protected product flows.

client.runtimes

Agent Runtimes

Always-on agent APIs, embedded assistants, and operational copilots.

client.secrets

Secrets

Secret vaults for API keys, tokens, credentials, and private runtime configuration.

Create, deploy, and invoke a Function

Automate recurring and event-driven work

Use schedules, triggers, and orchestrations when agents should run without a person opening a chat.

Schedule work, trigger agents, and orchestrate multi-step goals

SDK surface

After the quickstart, these managers are the main surfaces you will use to build real products and automation on top of Computer Agents.

Area

Scope

Threads

Messages, streaming, logs, diffs, feedback, permission requests, and lifecycle.

Computers

Persistent files, runtimes, packages, snapshots, GUI, analytics, Git, and local sync.

Projects and tasks

Projects, releases, task comments, sprints, task-linked threads, and review flows.

Knowledge and automation

Prompts, skills, Knowledge, Metronomes, Batches, schedules, triggers, and orchestrations.

Quality and release

Guardrails, Evaluations, Tests, assurance, fine-tuning, optimization, and release control.

Resources and data

Create, deploy, invoke, bind, monitor, roll back, and operate product resources and databases.

Security and evidence

Repository security scanning, findings, remediation runs, and controlled scientific evidence review.

Platform operations

Organizations, teams, authorization, identity, billing, notifications, reports, health, and local appliances.