Stagehand is the SDK for browser agents.
Read the Docs

Stagehand is the SDK for browser agents. Playwright was built for testing, Stagehand is built for agents. Use familiar APIs, self-healing actions, and network-level security across TypeScript, Python, and Go.

Stagehand gives browser agents an interface built for how they actually work. It combines familiar Playwright-style APIs with self-healing actions, agent-optimized page context, and native support for complex DOM structures like out-of-process iframes and closed Shadow DOMs.

Agents use fewer tokens, recover when websites change, and complete tasks more reliably. With a complete browser driver across TypeScript, Python, and Go, Stagehand delivers the flexibility of AI without sacrificing the speed, control, determinism, reliability, and observability required in production.

The Playwright-style methods you and your agents already know and love (goto, click, locator, screenshot).

Stagehand's hybrid accessibility tree trimming gives your agents exactly what they need to understand the page and nothing more.

Stagehand runs as an extension next to the browser, closing the distance and reducing round-trip latency for all actions on the page.

Use act, observe, and extract with natural language to automate pages. When sites change, Stagehand detects it and refreshes how the actions happen on the page automatically.

WebMCP, clipboard support, self-healing actions, batch commands, deep locators for nested iframes, and OTel support.

Check out our Quickstart Guide for more information:

Here's how to build a sample browser automation with Stagehand:

import { browserbase, Stagehand } from "@browserbasehq/stagehand";
import { z } from "zod/v4";

const browser = await browserbase.launch();
const stagehand = await Stagehand.create({ browser });

// Stagehand's CDP engine provides an optimized, low level interface to the browser built for automation
const page = await browser.context.pages()[0];
await page.goto("https://github.com/browserbase");

// Use act() to execute individual actions
await stagehand.act("click on the stagehand repo");

// Use observe() to see what's actionable on the page
const { data: actions } = await stagehand.observe("find the latest PR");

// Use locators for deterministic Playwright-style actions
await page.locator(actions[0].selector).click();

// Use extract() to get structured data from the page
const {
  data: { author, title },
} = await stagehand.extract(
  "extract the author and title of the PR",
  z.object({
    author: z.string().describe("The username of the PR author"),
    title: z.string().describe("The title of the PR"),
  }),
);

Visit docs.stagehand.dev to view the full documentation.

git clone https://github.com/browserbase/stagehand.git
cd stagehand
pnpm install
pnpm run build
pnpm run example # run the blank script at ./examples/example.ts

Stagehand is best when you have an API key for an LLM provider and Browserbase credentials. To add these to your project, run:

cp .env.example .env
nano .env # Edit the .env file to add API keys

To install Stagehand directly from a GitHub branch, install the core package subdirectory:

pnpm add "github:browserbase/stagehand#<branchName>&path:/packages/core"

Or set it in your project's package.json:

"@browserbasehq/stagehand": "github:browserbase/stagehand#<branchName>&path:/packages/core"

We're focused on improving reliability, extensibility, speed, and cost in that order of priority. If you're interested in contributing, bug fixes and small improvements are the best way to get started. For more involved features, we strongly recommend reaching out to Miguel Gonzalez or Paul Klein in our Discord community before starting to ensure that your contribution aligns with our goals.

We'd like to thank the following people for their major contributions to Stagehand:

• Paul Klein
• Sean McGuire
• Miguel Gonzalez
• Sameel Arif
• Thomas Katwan
• Filip Michalsky
• Anirudh Kamath
• Jeremy Press
• Navid Pour
• Nick Sweeting
• Sam Finton
• Shrey Pandya
• Shriya Lolabattu
• Alyssa Maruyama

Licensed under the MIT License.

Copyright 2026 Browserbase, Inc.

"Stagehand" is a trademark of Browserbase, Inc.