Openbrowser

OpenBrowser


[](LICENSE) [](pyproject.toml) [](docs/browser-routing.md) [](docs/openbrowser-api.md)

OpenBrowser is browser infrastructure for AI agents: real Chrome sessions, persistent profiles, human login handoff, a remote API, and MCP tools.

It lets Claude, Codex, Cursor, browser-use, OpenBrowser-style agents, and custom workers share real browsers without fighting over one CDP port. Agents lease a browser, use a named profile when account state is needed, hand login challenges to a human, and leave behind telemetry plus issue reports that can be audited later. Identities can also pin proxy, locale, and timezone settings when an account requires consistent routing.


flowchart LR
  Agent["Agent\nClaude / Codex / Cursor / worker"] --> Client["MCP or API client"]
  Client --> Broker["OpenBrowser Broker"]
  Broker --> Lease["Lease manager"]
  Broker --> Profiles["Profile + identity manager"]
  Broker --> Proxy["Proxy router"]
  Broker --> Observability["Telemetry + feedback + audit"]
  Lease --> Pool["Chrome pool"]
  Profiles --> Pool
  Proxy --> Pool
  Pool --> Slots["pool-a ... pool-h\nisolated CDP sessions"]

Why

Most browser agents break in the same ways:

• several agents connect to the same Chrome instance and block each other
• logged-in sessions are tied to one fragile browser profile
• passwords and 2FA prompts become unsafe chat messages
• rich-text apps such as Slack, Discord, Notion, Linear, and X ignore DOM fill calls
• failures vanish into logs, so the next agent repeats the same mistake

OpenBrowser gives agents one operating c