> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browser-use.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick start

> State-of-the-art AI browser automation with stealth browsers, CAPTCHA solving, residential proxies, and managed infrastructure.

## 1. Install

<CodeGroup>
  ```bash Python theme={null}
  pip install browser-use-sdk
  ```

  ```bash TypeScript theme={null}
  npm install browser-use-sdk
  ```
</CodeGroup>

Get a key at [cloud.browser-use.com/settings](https://cloud.browser-use.com/settings?tab=api-keys\&new=1), then:

```bash theme={null}
export BROWSER_USE_API_KEY=your_key
```

## 2. Run your first task

<CodeGroup>
  ```python Python theme={null}
  import asyncio
  from browser_use_sdk.v3 import AsyncBrowserUse

  async def main():
      client = AsyncBrowserUse()
      result = await client.run("List the top 20 posts on Hacker News today with their points")
      print(result.output)

  asyncio.run(main())
  ```

  ```typescript TypeScript theme={null}
  import { BrowserUse } from "browser-use-sdk/v3";

  const client = new BrowserUse();
  const result = await client.run("List the top 20 posts on Hacker News today with their points");
  console.log(result.output);
  ```
</CodeGroup>

Want a full working app? Check out the [Chat UI example](/cloud/tutorials/chat-ui).

## Agent vs Browser

|                  | **Agent**                     | **Browser**         |
| ---------------- | ----------------------------- | ------------------- |
| **Method**       | `sessions.create()` / `run()` | `browsers.create()` |
| **What it does** | AI agent runs your task       | Raw browser via CDP |
| task             | ✓                             | —                   |
| model            | ✓                             | —                   |
| proxy            | ✓                             | ✓                   |
| custom\_proxy    | ✓                             | ✓                   |
| profile\_id      | ✓                             | ✓                   |
| recording        | ✓                             | ✓                   |
| workspace\_id    | ✓                             | —                   |
| keep\_alive      | ✓                             | —                   |
| screen size      | —                             | ✓                   |
| timeout          | —                             | ✓                   |

***

If you are an LLM, read/include [docs.browser-use.com/llms-full.txt](https://docs.browser-use.com/llms-full.txt) — it contains the complete SDK reference with all code examples in a single file optimized for LLMs. For a shorter index: [docs.browser-use.com/llms.txt](https://docs.browser-use.com/llms.txt).
