Quickstart - 🤘 Stagehand (original) (raw)

🐍 Looking for Stagehand in Python?Switch to v2 →

If this is your first time using Stagehand, you should try Director first. It’s an agent that allows you to build Stagehand workflows using natural language. You can also try Stagehand using our MCP server . Otherwise, the quickest way to start with Stagehand is with our CLI. It scaffolds a ready‑to‑run Stagehand app with sensible defaults, and an example script.

1) Create a sample project

2) Run it

Follow the CLI prompts to enter the project directory and add your API keys. Then run the example script.

3) Use Stagehand (act, extract, observe)

The scaffold includes an index.ts file that contains the example script. Here’s what it looks like:

Next steps

Learn about the Stagehand primitives: act, extract, observe, and agent.