Browserbase onboarding interactive doc

How did you hear about Browserbase?

Give your agents the whole web — real browsers in the cloud, ready in seconds.

Get started

Or copy your API key to get started right away.

View docs
BROWSERBASE_API_KEY=bb_live_***************************

Set up your project

Get started with Browserbase

< 5 mins

Everything you need to go from zero to a live browser session.

Pick your favorite library. Choose Stagehand for AI-powered interactions (recommended), or Playwright for simple scripts.

npx create-browser-app@latest --template stagehand browserbase-app

Move into your new project folder and install its dependencies.

cd browserbase-app && npm install

Add your API key to your .env file.

BROWSERBASE_API_KEY=bb_live_***************************

Copy and run the start command. A Browserbase browser will appear and show the live session.

npm start

Pick your favorite library. Choose Stagehand for AI-powered interactions (recommended), or Playwright if you want full manual control.

mkdir browserbase-app && cd browserbase-app && pip install stagehand

Add your API key to your .env file.

BROWSERBASE_API_KEY=bb_live_***************************

Copy and run the start command. A Browserbase browser will appear and show the live session.

python main.py

Browserbase exposes a REST API — call the HTTP endpoints directly from any stack. The request below creates your first session.

curl --request POST \ --url https://api.browserbase.com/v1/sessions \ --header 'Content-Type: application/json' \ --header 'x-bb-api-key: bb_live_***' \ --data '{}'
zsh — browserbase-app

Install Stagehand to build browser automations with code.

npm install @browserbasehq/stagehand

Add your API key to your .env file.

BROWSERBASE_API_KEY=bb_live_***************************

Install Stagehand to build browser automations with code.

pip install stagehand

Add your API key to your .env file.

BROWSERBASE_API_KEY=bb_live_***************************

No SDK required — call the Browserbase API directly to start a session.

curl --request POST --url https://api.browserbase.com/v1/sessions …

Start building

Start with our prompt or build your own


              

Or copy your API key to get started right away.

BROWSERBASE_API_KEY=bb_live_***************************
Waiting for session…

Browser preview

Run the prompt and watch your session here

Playground
1234567891011121314151617181920212223242526
// AI-POWERED FORM FILLING AUTOMATION
// Trip details to be used for form filling
const tripDetails = `I'm planning a Summer in Japan. We're going to Tokyo, Kyoto, and Osaka (Japan)`
async function main() {
  // Initialize Stagehand with Browserbase for cloud-based browser automation.
  const stagehand = new Stagehand({
    env: "BROWSERBASE",
    verbose: 0,
  });
  try {
    // Initialize browser session to start automation.
    await stagehand.init();
    console.log(`Stagehand Session Started`);
    console.log(
      `Watch live: https://browserbase.com/sessions/${stagehand.browserbaseSessionId}`,
    );
    const page = stagehand.context.pages()[0];
    // Navigate to the trip example form.
    console.log("Navigating to form...");
    await page.goto("https://forms.gle/DVX84XynAJwUWNu26");
    // Create agent with custom system prompt for intelligent form filling.
    // The agent will use semantic matching to select appropriate form options.
    const agent = stagehand.agent({
      cua: false,
      model: "google/gemini-2.5-pro", // Routed through Model Gateway
      systemPrompt: `You are filling out a trip planning form.

Onboarding evolution

How post-signup Browserbase onboarding changed in apps/core. Dates are America/Los_Angeles (PT) from git history. Mocks prioritize real past copy and structure over marketing fiction.

How did you hear about Browserbase?

Twitter / X LinkedIn GitHub Friend or coworker Other
Continue

Inside sign-up / auth shell — not a dedicated product onboarding tree yet.

“We spun up cloud browsers in minutes.”

How would you like to get started?

Choose your preferred way to start using Browserbase

☁
Get started with the APIAPI credentials and code examples for your app.
▣
Use the PlaygroundInteractive playground with example scripts.
Continue

Preceded by the same attribution survey. Quick-start flag often off → survey then Playground.

How did you hear about Browserbase?

Podcast Search engine AI coding agent
Continue

Get started

</>
I am writing codeGet SDK setup instructions and code snippets
✦
My AI writes codeHand off a prompt to your coding agent

Start with our prompt or build your own

# Browserbase Onboarding BROWSERBASE_API_KEY=bb_live_*** Install browse CLI → verify → build with Stagehand…
Copy prompt
Waiting for session…
Live browser appears when the agent starts a session

Get started

</>
I am writing codePlaywright · Puppeteer · Selenium
✦
My AI writes code < 5 min setupClaude · Cursor · OpenAI
bb_live_•••••••• Reveal · Copy

Sources: git history under apps/core/src/app/orgs/[slug]/onboarding/**, legacy (get-started), components/accounts/onboarding-*, DASH-1215 / 1712 / 1975 / 2191–2203 / 2473. Switch to Current flow for the interactive end-to-end mock.

Copied