Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
better cloud docs + optimized docs images
Gregor Žuničfd31e90abc40
diff --git a/docs/cloud/pricing.mdx b/docs/cloud/pricing.mdxnew file mode 100644index 000000000..afbb56481--- /dev/null+++ b/docs/cloud/pricing.mdx@@ -0,0 +1,45 @@+---+title: "Pricing"+description: "Browser Use Cloud API pricing structure and cost breakdown"+icon: "dollar-sign"+---++The Browser Use Cloud API pricing consists of two components:++1. **Task Initialization Cost**: $0.01 per started task+2. **Task Step Cost**: Additional cost based on the specific model used for each step++## LLM Model Step Pricing++The following table shows the total cost per step for each available LLM model:++| Model | Cost per Step |+| -------------------------------- | ------------- |+| GPT-4o | $0.03 |+| GPT-4o mini | $0.01 |+| GPT-4.1 | $0.03 |+| GPT-4.1 mini | $0.01 |+| O4 mini | $0.02 |+| O3 | $0.03 |+| Gemini 2.0 Flash | $0.01 |+| Gemini 2.0 Flash Lite | $0.01 |+| Gemini 2.5 Flash Preview (04/17) | $0.01 |+| Gemini 2.5 Flash | $0.01 |+| Gemini 2.5 Pro | $0.03 |+| Claude 3.7 Sonnet (2025-02-19) | $0.03 |+| Claude Sonnet 4 (2025-05-14) | $0.03 |+| Llama 4 Maverick 17B Instruct | $0.01 |++## Example Cost Calculation++For example, using GPT-4.1 for a 10 step task:++- Task initialization: $0.01+- 10 steps × $0.03 per step = $0.30+- **Total cost: $0.31**++<Note>+ You need an active subscription and an API key from+ [cloud.browser-use.com/billing](https://cloud.browser-use.com/billing) to get+ started.+</Note>diff --git a/docs/cloud/quickstart.mdx b/docs/cloud/quickstart.mdxindex 4e0148311..e1cf89506 100644--- a/docs/cloud/quickstart.mdx+++ b/docs/cloud/quickstart.mdx@@ -4,54 +4,26 @@ description: "Learn how to get started with the Browser Use Cloud API"icon: "cloud"----The Browser Use Cloud API lets you create and manage browser automation agents programmatically. Each agent can execute tasks and provide real-time feedback through a live preview URL.--## Prerequisites+<img+ className="block dark:hidden rounded-2xl"+ src="/images/cloud-banner.png"+ alt="Browser Use Cloud Banner"+/>+<img+ className="hidden dark:block rounded-2xl"+ src="/images/cloud-banner-dark.png"+ alt="Browser Use Cloud Banner"+/><Note>You need an active subscription and an API key from- [cloud.browser-use.com/billing](https://cloud.browser-use.com/billing)+ [cloud.browser-use.com/billing](https://cloud.browser-use.com/billing). For+ detailed pricing information, see our [pricing page](/cloud/pricing).</Note>-## Pricing--The Browser Use Cloud API pricing consists of two components:--1. **Task Initialization Cost**: $0.01 per started task-2. **Task Step Cost**: Additional cost based on the specific model used for each step--### LLM Model Step Pricing--The following table shows the total cost per step for each available LLM model:--| Model | Cost per Step |-| -------------------------------- | ------------- |-| GPT-4o | $0.03 |-| GPT-4o mini | $0.01 |-| GPT-4.1 | $0.03 |-| GPT-4.1 mini | $0.01 |-| O4 mini | $0.02 |-| O3 | $0.03 |-| Gemini 2.0 Flash | $0.01 |-| Gemini 2.0 Flash Lite | $0.01 |-| Gemini 2.5 Flash Preview (04/17) | $0.01 |-| Gemini 2.5 Flash | $0.01 |-| Gemini 2.5 Pro | $0.03 |-| Claude 3.7 Sonnet (2025-02-19) | $0.03 |-| Claude Sonnet 4 (2025-05-14) | $0.03 |-| Llama 4 Maverick 17B Instruct | $0.01 |--### Example Cost Calculation--For example, using GPT-4.1 for a 10 step task:--- Task initialization: $0.01-- 10 steps × $0.03 per step-- Total cost: $0.31-## Creating Your First Agent-Create a new browser automation task by providing instructions in natural language:+To understand how the API works visit the [Run Task](/api-reference/run-task?playground=open) page.```bashcurl -X POST https://api.browser-use.com/api/v1/run-task \@@ -62,32 +34,11 @@ curl -X POST https://api.browser-use.com/api/v1/run-task \}'```-The API returns a task ID that you can use to manage the task and check the live preview URL.+`run-task` API returns a task ID, which you can query to get the task status, live preview URL, and the result output.<Note>- The task response includes a `live_url` that you can embed in an iframe to- watch and control the agent in real-time.+ To play around with the API, you can use the [Browser Use Cloud+ Playground](https://cloud.browser-use.com/playground).</Note>-## Managing Tasks--Control running tasks with these operations:--<AccordionGroup>- <Accordion title="Pause/Resume Tasks">- Temporarily pause task execution with [`/api/v1/pause-task`](/cloud/api-v1/pause-task) and resume with- [`/api/v1/resume-task`](/cloud/api-v1/resume-task). Useful for manual inspection or intervention.- </Accordion>-- <Accordion title="Stop Tasks">- Permanently stop a task using [`/api/v1/stop-task`](/cloud/api-v1/stop-task). The task cannot be- resumed after being stopped.- </Accordion>-</AccordionGroup>--For detailed API documentation, see the tabs on the left, which include the full coverage of the API.--<Note>- Need help? Contact our support team at [email protected] or join our- [Discord community](https://link.browser-use.com/discord)-</Note>+For the full implementation guide see the [Implementation](/cloud/implementation) page.diff --git a/docs/docs.json b/docs/docs.jsonindex d5122888a..6ccf72372 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -18,7 +18,7 @@"navigation": {"tabs": [{- "tab": "Documentation",+ "tab": "Library","groups": [{"group": "Get Started",@@ -57,10 +57,12 @@"tab": "Cloud API","groups": [{- "group": "Cloud API v1",+ "group": "Get Started",+ "pages": ["cloud/quickstart", "cloud/search", "cloud/pricing"]+ },+ {+ "group": "Guides","pages": [- "cloud/quickstart",- "cloud/search","cloud/implementation","cloud/custom-sdk","cloud/webhooks",diff --git a/docs/images/browser-use-banner-dark.png b/docs/images/browser-use-banner-dark.pngindex e70008638..5e49537d8 100644Binary files a/docs/images/browser-use-banner-dark.png and b/docs/images/browser-use-banner-dark.png differdiff --git a/docs/images/browser-use-banner.png b/docs/images/browser-use-banner.pngindex 5355757ce..d2f48a9ef 100644Binary files a/docs/images/browser-use-banner.png and b/docs/images/browser-use-banner.png differdiff --git a/docs/images/checks-passed.png b/docs/images/checks-passed.pngindex 3303c7736..bc4d9ea71 100644Binary files a/docs/images/checks-passed.png and b/docs/images/checks-passed.png differdiff --git a/docs/images/cloud-banner-dark.png b/docs/images/cloud-banner-dark.pngnew file mode 100644index 000000000..276c5326cBinary files /dev/null and b/docs/images/cloud-banner-dark.png differdiff --git a/docs/images/cloud-banner.png b/docs/images/cloud-banner.pngnew file mode 100644index 000000000..78bf5e12fBinary files /dev/null and b/docs/images/cloud-banner.png differdiff --git a/docs/images/laminar.png b/docs/images/laminar.pngindex ded8ee403..abea110b3 100644Binary files a/docs/images/laminar.png and b/docs/images/laminar.png differ