Stagehand

There’s a new way to automate the web: by prompting. But a single prompt fails on complicated scripts. Stagehand lets you prompt at multiple levels of granularity—from agents to single actions—and interweave Playwright or traditional frameworks when you need them. Use any major model provider. Get started in 5 minutes.

Discord

Community support

Docs

Full documentation

Templates

Ready-to-use examples

Quickstart

Get your API keys

Your API key and Project ID are displayed in the Dashboard Navigation row:

You’ll also need an LLM API key from your model provider (this quickstart uses Google by default, but you can swap in any supported provider like OpenAI, Anthropic, etc.).

Set environment variables

export BROWSERBASE_API_KEY="your-api-key"
export BROWSERBASE_PROJECT_ID="your-project-id"
export MODEL_API_KEY="your-llm-api-key"

Install and run

TypeScript
Python
Java
Go
Ruby

pnpm add @browserbasehq/stagehand
npm pkg set type=module

import { Stagehand } from "@browserbasehq/stagehand";

const stagehand = new Stagehand({
  env: "BROWSERBASE",
  model: {
    modelName: "google/gemini-3-flash-preview",
    apiKey: process.env.MODEL_API_KEY,
  }
});
await stagehand.init();

const page = stagehand.context.pages()[0];
await page.goto("https://news.ycombinator.com");

// Let AI click
await stagehand.act("click on the comments link for the top story");

// Extract structured data
const data = await stagehand.extract("extract the title and points of the top story");
console.log(data);

await stagehand.close();

Save as script.ts, then run:

pnpm dlx tsx script.ts

uv init
uv add stagehand

from stagehand import Stagehand

def main():
  client = Stagehand()

  response = client.sessions.start(model_name="google/gemini-3-flash-preview")
  session_id = response.data.session_id
  print(f"Session started: {session_id}")

  client.sessions.navigate(id=session_id, url="https://news.ycombinator.com")
  print("Navigated to Hacker News")

  # Let AI click
  act_result = client.sessions.act(id=session_id, input="click on the comments link for the top story")
  print(f"Act result: {act_result}")

  # Extract structured data
  result = client.sessions.extract(
      id=session_id,
      instruction="extract the title and points of the top story"
  )
  print(f"Extracted: {result}")

  client.sessions.end(id=session_id)

if __name__ == "__main__":
  main()

Save as script.py, then run:

uv run script.py

Debug in Session Inspector

See every AI decision in the Stagehand tab of your session at https://browserbase.com/sessions/{session_id}.

Introduction

Fundamentals

Features

Use Cases

Functions

Guides

Account

Integrations

Discord

Docs

Templates

Quickstart

Next Steps

Crash Course

npx create-browser-app

Introduction

Fundamentals

Features

Use Cases

Functions

Guides

Account

Integrations

Discord

Docs

Templates

​Quickstart

​Next Steps

Crash Course

npx create-browser-app

Quickstart

Next Steps