stagehand README

The project's README from github.com/browserbase/stagehand. As one markdown file: README.md.

Stagehand is the SDK for browser agents.
Read the Docs

MIT License Discord Community

browserbase%2Fstagehand | Trendshift

Ask DeepWiki

What is Stagehand?

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.

Why Stagehand?

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.

1. Familiar APIs

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

2. Token efficiency as a priority

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

3. Faster in production

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

4. Self-healing primitives

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.

5. Features agents need

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

Getting Started

Check out our Quickstart Guide for more information:

Example

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

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

const { BROWSERBASE_API_KEY, OPENAI_API_KEY } = process.env;

const browser = await browserbase.launch({
  apiKey: BROWSERBASE_API_KEY,
});

const stagehand = await Stagehand.create({
  browser,
  model: {
    modelName: "openai/gpt-5.4-mini",
    apiKey: OPENAI_API_KEY,
  },
});

// Stagehand's CDP engine provides an optimized, low level interface to the browser built for automation
const [page] = await browser.context.pages();
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"),
  }),
);

See the Python and Go READMEs for equivalent examples.

The same browserbase facade also exposes Browserbase Search and Fetch without launching a browser:

const results = await browserbase.search({
  apiKey: BROWSERBASE_API_KEY,
  query: "browser agent frameworks",
  numResults: 5,
});
const fetchResult = await browserbase.fetch({
  apiKey: BROWSERBASE_API_KEY,
  url: results.results[0].url,
  format: "markdown",
});

Documentation

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

Build and Run from Source

Stagehand is a TypeScript, Python, and Go monorepo. We use just to drive pnpm, uv, and go together.

git clone https://github.com/browserbase/stagehand.git
cd stagehand
just install
just generate
just build

Stagehand is best when you have an API key for an LLM provider and Browserbase credentials. Export them so they're available on process.env:

export OPENAI_API_KEY="your-openai-api-key"
export BROWSERBASE_API_KEY="your-browserbase-api-key"

Then run any of the scripts in packages/sdk-ts/examples:

just example act # runs packages/sdk-ts/examples/act.ts

See CONTRIBUTING.md for the full TypeScript, Python, and Go setup.

Contributing

[!NOTE] We highly value contributions to Stagehand! For questions or support, please join our Discord community.

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.

Acknowledgements

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

License

Licensed under the MIT License.

Copyright 2026 Browserbase, Inc.

"Stagehand" is a trademark of Browserbase, Inc.

stagehand (browserbase/stagehand)

Searching Database…

25.7K ·GitHub
Stagehand
Что это такое?Stagehand — это SDK для создания браузерных агентов — программного кода или ИИ-агентов, которые управляют настоящим браузером, чтобы извлекать данные и взаимодействовать с любым сайтом. Есть SDK для TypeScript, Python и Go.
Чем это отличается от обычного Playwright?Playwright создавался для тестирования, а Stagehand — для агентов. Вы сохраняете методы в стиле Playwright (goto, click, locator, screenshot), но добавляете действия act, observe и extract на естественном языке, контекст страницы, оптимизированный для агентов, а также поддержку out-of-process iframe и закрытых Shadow DOM.
Как выглядит настройка для проекта на TypeScript?Следуйте руководству Quickstart на docs.stagehand.dev и установите SDK для своего языка (на стороне TypeScript нужен Node >= 22.18.0). Экспортируйте API-ключ LLM-провайдера и учётные данные Browserbase, затем запустите примеры скриптов в packages/sdk-ts/examples.
Что будет с моей автоматизацией, если сайт изменится?Stagehand заметит изменение и автоматически обновит способ выполнения действий, так что ваш агент восстановится, а не молча сломается.
Это для QA-инженеров, тестирующих сайты, или для разработчиков, создающих агентов?Для разработчиков, которые создают браузерных агентов и продакшн-автоматизацию веба. Stagehand позиционирует себя как «агентное» дополнение к Playwright, который сосредоточен на тестировании, и рассматривает надёжность, наблюдаемость и стоимость как задачи продакшна.
Где на самом деле работает Stagehand?Это код в виде SDK, а не устанавливаемое приложение: TypeScript SDK работает на Node.js 22.18.0 и новее, а также есть SDK для Python и Go — для их обычных сред выполнения.
Stagehand бесплатный и с открытым исходным кодом?Да — он распространяется по лицензии MIT, разработан компанией Browserbase, Inc.
Не будет ли мой агент тратить токены на чтение целых страниц?Экономия токенов — заявленный приоритет: гибридное сокращение дерева доступности (accessibility tree) в Stagehand даёт агентам ровно тот контекст страницы, который нужен — и ничего лишнего.
Каждой задаче нужна полноценная браузерная сессия?Нет — тот же фасад browserbase открывает доступ к Browserbase Search и Fetch без запуска браузера, так что простые запросы могут обойтись вообще без автоматизации страниц.
Могу ли я подключить кодинг-агентов вроде Claude Code или Codex?Да — в описании проекта среди поддерживаемых способов начать работу перечислены Claude Code, Codex, Eve и Mastra.
Какие продакшн-возможности в него встроены?Поддержка WebMCP, поддержка буфера обмена, пакетные команды, глубокие локаторы для вложенных iframe и поддержка OpenTelemetry (OTel). По словам команды, её приоритеты — надёжность, расширяемость, скорость и стоимость, именно в таком порядке.
What are similar projects?browser-use, browser-harness, scout, nanobrowser, invisible_playwright_mcp, moli, maxun, webcmd
Which topics is it in?cloud-browser, browser-agent, headless-chrome, web-automation, cdp, data-extraction, dom, agentic, playwright, web-scraping, browser-automation, sdk
Creator
browserbase
Size
199.8 MB
Stars
25.7K
Updated
CommitOct 15Release@browserbasehq/[email protected]Aug 28
Age
2y
Commits · 90 Days