---
id: browser-use-sdk
version: "3.11.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# browser-use-sdk — Python SDK for the Browser Use cloud API

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

## What it is and what it does

browser-use-sdk is an official Python client for Browser Use Cloud, a service that lets you automate browser interactions through code. You instantiate a client, call its run() method with a natural-language task description, and receive structured output from the browser's actions. The SDK handles communication with the cloud backend, which executes the actual browser automation.

The package supports two modes: standard mode (where Browser Use manages the LLM) and v3 BYOK mode (where you supply your own LLM provider key). It depends on httpx for HTTP requests, pydantic for data validation, and idna for domain name handling. The SDK is designed for tasks like web scraping, data extraction, form filling, and automated testing—anything you'd normally do by hand in a browser.

Use it for:

- Extract trending repositories or real-time data from websites that require JavaScript rendering
- Automate repetitive web tasks like form submission or account management across multiple sites
- Build agents that navigate multi-step workflows without writing page-specific selectors
- Test web applications by simulating user interactions and verifying page state changes
- Gather competitive intelligence or monitor web content by automating periodic data collection

## Worth the install?

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

Python SDK for controlling browsers programmatically through the Browser Use Cloud API, enabling automated web interaction and data extraction tasks.

Yes, if you need browser automation and are comfortable with a cloud-dependent service. The SDK is actively maintained, has low install friction, and uses a permissive license. Verify whether the cloud service's pricing, rate limits, and connectivity requirements fit your use case before committing.

## Install

pip install browser-use-sdk
uv add browser-use-sdk
poetry add browser-use-sdk

## Installing browser-use-sdk

Before you install: Low install friction with a pure Python wheel. Actively maintained—released 3 days ago with recent commit history. Supports current Python versions (3.9+).

License in practice: MIT license permits unrestricted use, modification, and distribution in both open-source and commercial projects.

Quickstart:

pip install browser-use-sdk

from browser_use_sdk import AsyncBrowserUse

client = AsyncBrowserUse()
result = await client.run("Find the top 3 trending repos on GitHub today")
print(result.output)

Requires API key from Browser Use Cloud (cloud.browser-use.com/settings) set as BROWSER_USE_API_KEY environment variable; requires Python 3.9+

Verify before relying:

- Whether the SDK works offline or requires continuous cloud connectivity to Browser Use Cloud
- Rate limits, quotas, or pricing model for the cloud API beyond the SDK itself
- Whether BYOK (Bring Your Own Key) mode in v3 requires a paid Browser Use account

## Package facts

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

## Tags

browser automation python sdk, web scraping api client, automated browser control, headless browser python, web task automation, browser-automation, web-scraping, cloud-api

[View on SkillFed](https://skillfed.io/packages/browser-use-sdk) · [View on PyPI](https://pypi.org/project/browser-use-sdk/)