Skip to content
AgentsIndex

Stagehand

Open source browser automation with deterministic and agentic flows.

Best for
Developers who need reliable browser automation with both precision and agentic flexibility.
GitHub stars
25.7k

What we checked

Pages last read
Facts checked
5 facts

From 6 sources

AI answers
Too few read

58 buyer-question answers read, November 2026

At a glance

Tags
BYOK, Open source

Code

Last push
15 October 2026

For developers

Works with
OpenAI, Anthropic, Google Gemini, Vercel AI SDK

Stagehand in our research

All research

Study

AI Tool Pricing Index, November 2026

Pricing

Free only

29 of the 361 tools we checked are free with no paid plan.

Edition price, checked 15 November 2026.

Pricing pages of the AI tools, November 2026 editionas of n = 361 tools checked

What is Stagehand?

Stagehand is an open source browser automation framework for developers that combines deterministic primitives with AI-guided flexibility. Its act(), extract(), and observe() flows handle clicking, filling, navigation, page reading, and multi-step workflows, while supporting OpenAI, Anthropic, and Google Gemini through the Vercel AI SDK. It runs locally with any Chromium browser, can use Browserbase for production deployment, and is fully open source under the MIT license.

A browser driver for agents, with AI steps where you want them

Stagehand is an SDK that drives Chrome, and its pitch is that "Playwright was built for testing, Stagehand is built for agents". It gives you two layers in one script. Three AI primitives, act, extract and observe, take natural-language instructions, and Playwright-style page methods (goto, click, type, locator, screenshot) run with no inference at all. The docs say you can "mix both in the same script and decide how much AI each step uses". extract checks its output against a schema you define, and metrics() reports token usage and inference timing for each method.

The runtime sits in a browser extension next to the page. The homepage says this cuts round-trip latency for every action, and it lists closed Shadow DOM, out-of-process iframes, WebMCP, clipboard access, a domain allowlist and blocklist, and built-in OTel tracing as things Stagehand has and Playwright lacks. The TypeScript, Python and Go SDKs are documented as matching method for method.

agent() is gone, and you now write the control loop

The current major version dropped the built-in orchestrator. The v3 to v4 migration guide is blunt about it: "agent() is gone. Nothing in v4 replaces it one-for-one." Browserbase recommends two approaches in its place. In "code mode" a coding assistant writes a Stagehand script once and you run it with no per-step inference. In "tool calling" you expose the SDK's methods to a model as narrow tools, with page.snapshot() returning an accessibility tree and an XPath map for the model to read.

The guide also says construction, page access and result shapes changed. Anyone coming from older tutorials, or from model output trained on them, will hit code that no longer runs. The docs ship AI rules to keep generated code on the v4 API for exactly this reason.

The SDK is free; Browserbase is where the bill comes from

Stagehand is MIT-licensed on GitHub and installs from npm, pip or Go. Run it against local Chrome and the only spend is your model provider's tokens. The docs nonetheless steer you to the hosted service: "Browserbase recommends running Stagehand on Browserbase. A hosted browser is what enables server-side caching and the Model Gateway."

Browserbase's pricing page lists four plans as of November 2026:

The page says every plan "scales past its included usage, so no caps or throttling", so overage replaces a hard stop.

Model choice is open, with Gateway tied to hosted browsers

The models page lists five first-class providers: Google, Anthropic, OpenAI, Groq and Cerebras. Anything else, including Amazon Bedrock, Azure OpenAI or a self-hosted model, goes through a bring-your-own-LLM callback that runs in your process. Stagehand validates model names against a list it ships, so a newly released model needs an SDK upgrade before it can be named.

Model Gateway is the convenience layer. Leave the model out and Browserbase picks one per call, billed through your Browserbase key, and the page claims "Market-price tokens: Browserbase charges the same price as going direct to the provider. No markup." The limit is stated plainly: "Model Gateway requires Browserbase-hosted browsers. It does not work with local browsers." Gateway also rejects stopSequences, so a pinned model with its own key is needed for those.

Agent framework and MCP hookups are experimental and build from source

Most connect over a stdio MCP adapter that exposes three tools: run, snapshot and screenshot. The CLI agents page says "These integrations are experimental and run from the Stagehand repository. The shared adapter is not published as a standalone package." Setup means cloning the repo and building it with Node.js 24 or newer and pnpm.

The same page warns that run executes agent-authored JavaScript in the extension's service worker and "can control the browser and access data available in that session", and advises using Browserbase for untrusted browser tasks. Separately, Browserbase promotes a hosted MCP server that needs a Browserbase API key.

Where it fits, and where it does not

Stagehand suits developers who already write Playwright and want AI only on the steps that break, with code they can review and diff. It is a library with no no-code interface. A team that wanted a ready-made autonomous browsing agent will find the orchestrator removed and the loop left to them.

The speed claims on the homepage, "2x faster than playwright" and "80% more token efficient", are Browserbase's own measurements of its own product, and no independent test sits beside them.

Stagehand price and terms

Terms

Free plan
YesYesOpen-source SDK, free to self-run with local Chrome
The terms in full

LLM provider usage and optional Browserbase hosted browsers are paid separately.

For AI agents

Developer docs

Where these prices come from

github.com/browserbase/stagehand, checked

All plans and limits

PlanPriceMain limits
StagehandFreeNone stated

Read from github.com/browserbase/stagehand.

What we checked on Stagehand

YesPartlyNo

What it costs to startYes

What the price counts

The SDK itself carries no meter or fee because it is MIT-licensed code; spend comes from the model provider you configure and, optionally, Browserbase hosted browsers.

Licensed under the MIT License.

github.com/browserbase/stagehandChecked

What it costs to startYes

Free to use

The SDK installs from npm and is MIT-licensed, so it can be used with a local browser without contacting sales or buying a plan.

$ npm install @browserbasehq/stagehand

stagehand.devChecked

How you build with itYes

Public API

Stagehand is itself a programmatic SDK with documented methods (act, extract, observe, page, locator) and matching TypeScript, Python and Go SDKs; it is a library API, not a hosted REST service.

First-class TypeScript, Python, and Go SDKs: Every method and option matches across supported languages.

docs.stagehand.dev/v4/first-steps/intro…Checked

Stagehand alternatives

Questions about Stagehand

How much does Stagehand cost?
Stagehand is free to use. From github.com/browserbase/stagehand, checked 15 November 2026.
Does Stagehand have an API or an MCP server?
Stagehand has an API. From docs.stagehand.dev/v4/first-steps/introduction, checked 15 November 2026. Stagehand has an MCP server. We checked the Official MCP Registry ourselves on 15 November 2026.
Is Stagehand open source, and can you host it yourself?
Stagehand is open source. We checked github.com/browserbase/stagehand/blob/main/LICENSE ourselves on 15 November 2026.
What have we checked on Stagehand?
5 facts, under these headings: What it costs to start, how you build with it.
How do we check Stagehand?
We hold 5 facts on Stagehand, quoted from 6 pages. Facts and price last checked 15 November 2026, when we also found the last change.

How we check every listing

Repository

Licence
MIT
Stars
25,687
Last push
15 October 2026

Stagehand price history

We have read the price once so far, on 15 November 2026: free.

PricePlanFirst seenLast seenReadingsSource
Free15 November 202615 November 20261Pricing page, read 15 November 2026

From our research on 15 November 2026. A date is when we read the page, not when the price changed.

Similar to Stagehand

Is Stagehand yours?

Free, and the page then carries the verified owner mark. You confirm it with an email at stagehand.dev. Claim this listing

Report an error if a fact is wrong.