ntegrals /openbrowser

Let AI agents browse the web. An autonomous toolkit for browser-based AI agents.

★ 9,590⑂ 867👁 248⑃ 35● 0▤ 0
TypeScriptMITCreated 2019-04-11
+1
日增长
9,590
stars
867
forks
248
watchers
35
prs
0
issues
0
releases

README

Open Browser


  AI-powered autonomous web browsing framework for TypeScript.



  
  




---

Give an AI agent a browser. It clicks, types, navigates, and extracts data — autonomously completing tasks on any website. Built on Playwright with first-class support for OpenAI, Anthropic, and Google models.

 Production-ready since v1.0. Contributions welcome.

 Why Open Browser?

- Autonomous agents: Describe a task in natural language, and an AI agent navigates the web to complete it — clicking, typing, scrolling, and extracting data without manual scripting
- Multi-model support: Works with OpenAI, Anthropic, and Google out of the box via the Vercel AI SDK — swap models with a single flag
- Interactive REPL: Drop into a live browser session and issue commands interactively — great for debugging, prototyping, and exploration
- Sandboxed execution: Run agents in resource-limited environments with CPU/memory monitoring, timeouts, and domain restrictions
- Production-ready: Stall detection, cost tracking, session management, replay recording, and comprehensive error handling
- Open source: MIT licensed, fully extensible, bring your own API keys

 Quick Start

bash
 Install dependencies
bun install

 Set up your API keys
cp .env.example .env
 Edit .env with your API keys

 Run an agent
bun run open-browser run "Find the top story on Hacker News and summarize it"

 Or open a browser interactively
bun run open-browser interactive


 Architecture

Open Browser is a monorepo with three packages:

| Package                     | Description                                                                |
| --------------------------- | -------------------------------------------------------------------------- |
| open-browser          | Core library — agent logic, browser control, DOM analysis, LLM integration |
| @open-browser/cli     | Command-line interface for running agents and browser commands             |
| @open-browser/sandbox | Sandboxed execution with resource limits and monitoring                    |

 CLI Commands

 Run an AI Agent

bash
open-browser run  [options]


Describe what you want done. The agent figures out the rest.

bash
 Search and extract information
open-browser run "Find the price of the MacBook Pro on apple.com"

 Fill out forms
open-browser run "Sign up for the newsletter on example.com with [email protected]"

 Multi-step workflows
open-browser run "Go to GitHub, find the open-browser repo, and star it"


| Option                       | Description                               |
| ---------------------------- | ----------------------------------------- |
| -m, --model         | Model to use (default: gpt-4o)          |
| -p, --provider   | Provider: openai, anthropic, google |
| --headless / --no-headless | Show or hide the browser window           |
| --max-steps             | Max agent steps (default: 25)           |
| -v, --verbose              | Show detailed step info                   |
| --no-cost                  | 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON