***

title: Getting Started
description: 'Install the SDK, authenticate, and launch your first browser runtime.'
------------------------------------------------------------------------------------

The primary package is `@bctrl/sdk`.

## Install

```bash
npm install @bctrl/sdk
```

## Create a client

```ts
import { Bctrl } from "@bctrl/sdk";

const client = new Bctrl({
  apiKey: process.env.BCTRL_API_KEY!,
  baseUrl: "https://api.bctrl.ai",
});
```

## Create a workspace

```ts
const workspace = await client.workspaces.create({
  name: "my-workspace",
});
```

## Launch a browser runtime

```ts
const runtime = await workspace.runtimes.browser("main").playwright({
  launch: {
    mode: "ephemeral",
  },
});
```

## Automate it

```ts
await runtime.page.goto("https://example.com");
const title = await runtime.page.title();
await runtime.stop();
```

Use `workspace.execute(...)` when you want raw structured HTTP-equivalent execution, and use the runtime client when you want fluent Playwright, Puppeteer, Stagehand, or Selenium-style APIs.