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, который позволяет ИИ-агенту писать живой JavaScript для управления настоящим браузером Chrome через сырой DevTools Protocol, вместо вызова фиксированного набора браузерных действий.
Это отдельное приложение или SDK, который я встраиваю в свой код?Это SDK, который вы добавляете в проект на TypeScript/JavaScript; отдельного приложения нет — вы пишете файл 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 всё равно требует Node для своего V8-воркера); локальный Chrome необязателен, поскольку по умолчанию используются облачные браузеры, но можно указать и на собственный Chrome.
Безопасно ли позволять агенту писать и запускать собственный JavaScript?Сгенерированный агентом код выполняется в завершаемом V8-воркере с доступом к файловой системе и сети, поэтому недоверенные задачи стоит изолировать на отдельной машине.
Он отправляет данные об использовании на сервер?Да, анонимные счётчики запусков включены по умолчанию; их можно отключить с помощью telemetry: false или переменной DONOTTRACK=1.
Что агент реально может, когда управляет Chrome?Он пишет и исполняет собственный JavaScript на живой странице через сырой CDP, создавая нужные вспомогательные функции на лету, вместо того чтобы полагаться на фиксированный 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