# Stagehand: AI Browser Automation Framework

> Stagehand lets developers and AI agents **reliably automate the web** using natural language and deterministic code. By combining Playwright with AI-native capabilities like self-healing selectors and natural-language extraction, Stagehand makes browser automation flexible and maintainable. Created and maintained by Browserbase.

> An AI friendly alternative to Playwright, Selenium, and Puppeteer.

---

## Documentation

- [Introduction](https://docs.stagehand.dev/first-steps/introduction.md) — Canonical overview of Stagehand.  
- [Quickstart Guide](https://docs.stagehand.dev/first-steps/quickstart)  
- [Stagehand Website](https://www.stagehand.dev/)  
- [Stagehand GitHub Repo](https://github.com/browserbase/stagehand)  

---

## SDKs & Libraries

- [TypeScript SDK](https://github.com/browserbase/stagehand)  
- [Python SDK](https://github.com/browserbase/browserbase-python)  

---

## The Problem with Browser Automation

Traditional frameworks like Playwright and Puppeteer are brittle.  
Pure AI agents are unpredictable.  
**Stagehand solves both** with four primitives.  

---

## Key Features

- **Act** — Execute actions using natural language.  
- **Extract** — Pull structured data with schemas.  
- **Observe** — Discover available actions on a page.  
- **Agent** — Automate entire workflows autonomously.  

**TypeScript Example**
```typescript
await page.act("click the login button");
const { price } = await page.extract({ schema: z.object({ price: z.number() }) });
```

**Python Example**
```python
await page.act("click the login button")
result = await page.extract(schema={"price": float})
```

- **Deterministic + Adaptive** — Repeatable with AI fallback.  
- **Playwright-Compatible** — Use any Playwright API alongside Stagehand.  
- **Model Hot-Swap** — Swap LLMs easily.  
- **Open Source** — Built and maintained in the open.  

---

## Example Use Cases

- Automating repetitive tasks more reliably than Selenium.  
- Data extraction from dynamic sites.  
- Building research or task agents.  
- Running authenticated sessions.  

---

## Blog & Resources

- *Scalable Automation Starts Here: Meet Stagehand + MongoDB Atlas* — [MongoDB Blog](https://www.mongodb.com/company/blog/technical/scalable-automation-starts-here-meet-stagehand-atlas)  

---

## Media, Tutorials & Community

- *Stagehand V2: Fully Free Browser Use AI Agent!* — [World of AI](https://www.youtube.com/watch?v=Qb1YrN0fZfM)  
- *React JS Project — Next.js, Gemini AI & Stagehand Tutorial* — [Roadside Coder](https://www.youtube.com/watch?v=9Bvz_HJESV4)  
- *Give your AI a Browser with Stagehand* — [Elie Steinbock](https://www.youtube.com/watch?v=zGR6TDKTeGo)  

---

## Project Info

- [Homepage](https://www.stagehand.dev/)  
- [Docs](https://docs.stagehand.dev/)  
- [GitHub](https://github.com/browserbase/stagehand)  

---

## See Also

- [Browserbase: Headless Browser Infrastructure for AI Agents](https://www.browserbase.com/) — Scalable, secure cloud browsers for AI agents and automation.  
- [Director: Natural Language Web Automation](https://www.director.ai/) — No-code tool that turns plain English into Stagehand scripts.