browser-use-pi README

The project's README from github.com/browser-use/browser-use-pi. As one markdown file: README.md.

A white arch above the clouds

Browser Use Pi

Browser Use, built on Pi Mono. In TypeScript.

Pi Mono + a persistent V8 REPL + raw CDP. The agent writes JavaScript, controls Chrome, and builds the helpers it needs as it goes.

Your task → Pi Mono → persistent V8 REPL → raw CDP → Chrome
                ↑                                    │
                └──────── AX tree + screenshots ──────┘

The programmability of Browser Harness, with sessions, saved logins, streaming and typed results. One SDK you can put in your app.

Start

npm install @browser_use/pi
# or: pnpm add @browser_use/pi
# or: bun add @browser_use/pi
export OPENROUTER_API_KEY=...
export BROWSER_USE_API_KEY=...

import { Browser, BrowserUse } from '@browser_use/pi';

const agent = await BrowserUse.create({
  model: 'openrouter/openai/gpt-5.6-luna',
  reasoning: 'xhigh',
  browser: Browser.cloud({ apiKey: process.env.BROWSER_USE_API_KEY! }),
  workspace: './work',
});

try {
  const result = await agent.run('Find the top story on Hacker News.');
  console.log(result.status, result.text);
  await agent.followUp('Summarize the comments.');
} finally {
  await agent.close();
}

Save as agent.ts. Run with node agent.ts or bun agent.ts. Uses Browser Use Cloud; no local Chrome installation needed.

Node 22.19+ · Bun 1.3.14+. Bun also needs Node for the V8 worker.

Keep building

Quickstart · Browser primitives · Python · Historical benchmarks

JavaScript runs in a killable worker with filesystem and network access. Use an isolated machine for untrusted tasks. Anonymous run counters are enabled; disable with telemetry: false or DO_NOT_TRACK=1. Telemetry

Develop

npm test
npm run check
npm run docs:build
npm run test:python

browser-use-pi (browser-use/browser-use-pi)

Searching Database…

431 ·GitHub
Browser-use-pi
这是什么?Browser Use Pi 是一个小巧的 TypeScript SDK,让 AI 代理编写实时 JavaScript,通过原始 DevTools 协议驱动真实的 Chrome 浏览器,而不是调用一组固定的浏览器操作。
这是独立应用,还是嵌进我代码里的 SDK?它是你添加到 TypeScript/JavaScript 项目里的 SDK;没有独立应用,你写一个导入它的 agent.ts 文件,然后运行它就行。
怎么让它跑起来?把脚本保存为 agent.ts,用 node agent.ts 或 bun agent.ts 运行;默认它使用 Browser Use Cloud,所以本地不需要装 Chrome。
我需要 Node 或 Bun,还要本地装 Chrome 吗?你需要 Node 22.19+ 或 Bun 1.3.14+(Bun 的 V8 worker 仍然需要 Node);本地装 Chrome 是可选的,因为它默认用云浏览器,不过你也可以让它指向自己的 Chrome。
让代理自己写并运行 JavaScript 安全吗?代理生成的代码运行在一个可终止的 V8 worker 里,拥有文件系统和网络访问权限,所以不可信的任务应该隔离到单独的机器上。
它会上报使用数据吗?会,匿名的运行计数默认开启;你可以用 telemetry: false 或设置 DONOTTRACK=1 关掉。
代理控制 Chrome 之后,实际能做什么?它通过原始 CDP 针对实时页面编写并运行自己的 JavaScript,按需即时构建所需的辅助函数,而不是依赖固定的操作 API。
多次运行之间能保持登录会话吗?能,会话支持保存的登录状态、持久化工作区和后续运行,云浏览器和你自己的 Chrome 实例都适用。
我能控制代理运行的时间长短或花费多少吗?Control 功能让你可以给步数、时间或成本设上限,流式查看输出,使用钩子,拿到类型化的结果,并在运行提前停止时保留已完成的部分工作。
我能查看或分享代理在运行期间做了什么吗?能,它可以生成交互亮点、录像和 GIF 导出,方便你事后展示这些工作。
What are similar projects?scout, moli, stagehand, browser-harness, Endoplexity, Baize, macos-harness, bb-browser
Which topics is it in?v8, session, cdp, telemetry, hooks, chrome, sandbox, browser-automation, streaming, sdk, browser, benchmark
Creator
browser-use
Size
2.6 MB
Stars
431
Updated
CommitOct 06
Age
1mo
Commits · 90 Days