browser-use-sdk
Official Python SDK for Browser Use Cloud.
Install
uv add browser-use-sdk
Quick Start
Get your API key at cloud.browser-use.com/settings.
export BROWSER_USE_API_KEY=your_key
from browser_use_sdk.v4 import BrowserUse
with BrowserUse() as client:
run = client.runs.create("Find the top 3 trending repos on GitHub today")
result = client.runs.wait_for_completion(run.id)
print(result.result)
This is the current Browser Use Agents interface. Browser Infrastructure's
browser-management resource currently lives in the explicit browser_use_sdk.v4
namespace; see the browser quickstart.
v3 Bring Your Own LLM Key
Add your provider API key in Browser Use project settings, then enable BYOK for v3 agent runs:
from browser_use_sdk.v3 import BrowserUse
client = BrowserUse(use_own_key=True)
result = client.run("Find the top 3 trending repos on GitHub today")
print(result.output)
Docs
License
MIT
V4 structured output
Pass a JSON Schema dictionary to runs.create(output_schema=...), then read the
parsed JSON value from runs.get(...).output or runs.wait_for_completion(...).output.
The async client supports the same parameters and fields. run.result remains the
text answer; run.output_schema echoes the requested schema. Omit output_schema
(or pass None) for an unstructured run.
from browser_use_sdk.v4 import BrowserUse
with BrowserUse() as client:
created = client.runs.create(
"Open https://example.com and return its page title.",
output_schema={
"type": "object",
"properties": {"title": {"type": "string"}},
"required": ["title"],
},
)
run = client.runs.wait_for_completion(created.id)
print(run.status, run.output)
For Pydantic, pass MyModel.model_json_schema() and validate the returned value
with MyModel.model_validate(run.output); model classes are not converted
automatically. See sync and async examples.
2 maintainers
Metadata
2 maintainers
Release files for browser-use-sdk 3.12.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| browser_use_sdk-3.12.1.tar.gz | 74.1 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| browser_use_sdk-3.12.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 174.3 kB
Release files / browser_use_sdk-3.12.1.tar.gz
| Download URL | browser_use_sdk-3.12.1.tar.gz |
|---|---|
| Size | 74.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
94c2a870e5ec5072b21661a6f4fecbf106dabe1c40e8790c6702081c52f39d2f
|
|
BLAKE2b-256 checksum How to use checksums |
eb3ff315f76246b0793cbb287c5373541eaec86736cd6b7a25410c8664d7564e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / browser_use_sdk-3.12.1-py3-none-any.whl
| Download URL | browser_use_sdk-3.12.1-py3-none-any.whl |
|---|---|
| Size | 100.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4b3be371f38b4103384b7288dacdfc90d1265d06912d56974f9d67fcbe605fd7
|
|
BLAKE2b-256 checksum How to use checksums |
0037691c9185d6736bf58995500fe019bef4fa818c29031b682dbe20bb3534a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for browser-use-sdk 3.12.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
