---
id: browserbase
version: "1.16.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# browserbase — The official Python library for the Browserbase API

License: permissive · Maintenance: active · Downloads: 5.6M/mo

## What it is and what it does

Browserbase is the official Python SDK for the Browserbase API, a service for managing remote browser sessions. It wraps the REST API with full type hints and provides both sync and async clients powered by httpx. The library is generated with Stainless and includes TypedDict request parameters and Pydantic response models, enabling IDE autocomplete and type checking.

Typical usage involves creating a client with an API key, then creating or managing browser sessions that can be controlled via Playwright. The library handles connection errors, rate limiting, and timeouts automatically, with configurable retries and timeout behavior. It supports file uploads, nested parameters, and detailed error handling with specific exception types for different HTTP status codes.

Use it for:

- Automate web scraping or testing by creating remote browser sessions and controlling them via Playwright.
- Build browser automation workflows that integrate with Browserbase's managed infrastructure instead of local browsers.
- Implement asynchronous browser control in concurrent applications using the AsyncBrowserbase client.
- Handle certificate management and browser settings configuration through the API.
- Integrate browser session management into CI/CD pipelines or cloud-based testing frameworks.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Browserbase is a Python client library for the Browserbase REST API, providing typed access to remote browser session management and control with both synchronous and asynchronous interfaces.

Yes, if you need to control remote browser sessions via the Browserbase service. The package is actively maintained, has low install friction, carries a permissive license, and provides full type coverage. Install with caution if you are unsure whether you have valid Browserbase credentials and project setup, as the library requires API keys and project IDs to function.

## Install

pip install browserbase
uv add browserbase
poetry add browserbase

## Installing browserbase

Before you install: Low install friction with a pure-Python wheel and six common dependencies (anyio, distro, httpx, pydantic, sniffio, typing-extensions). The package is actively maintained with a release 2 days old and 91 repository stars.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.

Quickstart:

pip install --pre browserbase

import os
from browserbase import Browserbase

client = Browserbase(api_key=os.environ.get("BROWSERBASE_API_KEY"))
session = client.sessions.create(project_id=os.environ.get("BROWSERBASE_PROJECT_ID"))

Requires BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID environment variables; Python 3.9 or later.

Verify before relying:

- Whether the '--pre' flag in the installation example indicates the package is still in pre-release or if stable releases are available.
- Actual performance characteristics when using aiohttp backend versus default httpx.
- Whether Playwright is a required dependency or only needed for specific use cases shown in examples.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 5.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

browserbase python api client, remote browser session management, playwright integration library, headless browser api wrapper, browser automation sdk python, browser-automation, api-client, async-support

[View on SkillFed](https://skillfed.io/packages/browserbase) · [View on PyPI](https://pypi.org/project/browserbase/)