Does stagehand use paid AI services?

Can use OpenAI. Its settings have keys for this paid API. Its README says whether one is required.

Is stagehand still maintained?

Yes, active. Last change today. Latest release stagehand-server-v3/v3.7.7, 21 days ago.

How widely used is stagehand?

Widely used. 26k stars, 2 years old, by an organization. As with any download, get it from the official repo.

gitmanual

Reading the repo

Opening the box…

How to install stagehand on macOS (browserbase/stagehand) · gitmanual

How to install on macOS

browserbase/stagehand

The SDK to extract data and interact with any site on the web. Get started with Claude Code, Codex, Eve, Mastra, and more.

Node.jsVite#agents#ai#ai-agents#browser-agent

Before you start

Is it free?: YesOpen source (MIT).
Paid AI services?: Can use OpenAIIts settings have keys for this paid API. Its README says whether one is required.
Still maintained?: Yes, activeLast change today. Latest release stagehand-server-v3/v3.7.7, 21 days ago.
How widely used?: Widely used26k stars, 2 years old, by an organization. As with any download, get it from the official repo.

Difficulty: Moderate
Time: about 15 min
Stars: ★ 26,032
Activity: Updated this month

Saved setup from 6 h ago

Will it work on macOS?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Your system

macOS Windows Linux

Start here

Website ↗stagehand.devThe project's own site.

Heads-upBuilding it yourself? It also needs 3 settings in .env (3 secret).

Download for macOS

stagehand/server-v3 v3.7.7 · 10/23/2026 ↗

stagehand-server-v3-darwin-arm64

binary · Apple Silicon · 135.4 MB · 17 downloads · best match

Download

Raw binary — move it onto your PATH.

curl -LO "https://github.com/browserbase/stagehand/releases/download/stagehand-server-v3/v3.7.7/stagehand-server-v3-darwin-arm64"
chmod +x "stagehand-server-v3-darwin-arm64"

Other macOS downloads (1)

stagehand-server-v3-darwin-x64

binary · Intel · 138.6 MB · 17 downloads

Download

Raw binary — move it onto your PATH.

curl -LO "https://github.com/browserbase/stagehand/releases/download/stagehand-server-v3/v3.7.7/stagehand-server-v3-darwin-x64"
chmod +x "stagehand-server-v3-darwin-x64"

Install with a package manager

Alternative: pipNeeds Python 3

pip install stagehand

From the README, exactly as the maintainers wrote it.

Use it in your own project

This is a library: you add it to your code rather than opening an app.

For your own code: project

go get github.com/browserbase/stagehand/packages/sdk-go/v4@v4.0.0

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 14 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js >=22.18.0runtime
1×Python 3 tool
1×pnpm package manager

3× settings in .env

OPENAI_API_KEYsecret
BROWSERBASE_API_KEYsecret
ANTHROPIC_API_KEYsecret

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/browserbase/stagehand/badge.svg)](https://gitmanual.com/browserbase/stagehand)

Good to know

Monorepo (workspaces) — install from the repo root.
justfile found — run just --list to see available tasks.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: packages/cli/package.json, packages/docs/package.json, packages/evals/package.json, packages/examples/cookbooks/ai-sdk-research-agent/typescript/package.json and 11 more

Details

License: MIT
Open issues: 435
Branch: main

package.json scripts (13)

checkturbo run fmt:check lint typecheck
docspnpm --filter ./packages/docs dev
fmtoxfmt --write .
fmt:checkoxfmt --check .
lintoxlint .
testturbo run test:unit test:browser
test:unitvitest run rules scripts
test:integrationtsx scripts/test-integration.ts
typechecktsc --noEmit -p tsconfig.tooling.json
buildturbo run build
build:cliturbo run build:cli
generate:pythonuv --directory packages/sdk-python run --locked python scripts/generate.py
build:wheeluv --directory packages/sdk-python run --locked python scripts/build.py

Files we read (14)

.env.example

.github/workflows/ci.yml

.github/workflows/docs-preview.yml

.github/workflows/external-contributor-pr-approval-handoff.yml

.github/workflows/external-contributor-pr.yml

.github/workflows/publish-python.yml

.github/workflows/release.yml

CONTRIBUTING.md

README.md

justfile

package.json

packages/examples/.env.example

pnpm-workspace.yaml

pyproject.toml

1,737 files in the repo

Contact

browserbase/stagehand

Before you start

Your setup manual for stagehand

What's inside

Handy for

Yes, it installs on your macOS

Start here

Download for macOS

Install with a package manager

Use it in your own project

Did you get it running?

Still stuck? Get a written guide

Yes, it installs on your macOS

Start here

Download for macOS

Install with a package manager

Use it in your own project

Did you get it running?

Still stuck? Get a written guide

More like stagehand that run on macOS