> ## Documentation Index
> Fetch the complete documentation index at: https://browseruse-0aece648-codex-api-v4-agent-docs.mintlify.site/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.v4 import AsyncBrowserUse

  async def main():
      client = AsyncBrowserUse()
      created = await client.runs.create("List the top 20 Hacker News posts and their points")
      run = await client.runs.wait_for_completion(created.id)
      print(run.result)

  asyncio.run(main())
  ```

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

  const client = new BrowserUse();
  const created = await client.runs.create({
    task: "List the top 20 Hacker News posts and their points",
  });
  const run = await client.runs.waitForCompletion(created.id);
  console.log(run.result);
  ```
</CodeGroup>

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

## Agent vs Browser

|                        | **Agent**               | **Browser**         |
| ---------------------- | ----------------------- | ------------------- |
| **Method**             | `runs.create()`         | `browsers.create()` |
| **What it does**       | AI agent runs your task | Raw browser via CDP |
| task                   | ✓                       | —                   |
| model                  | ✓                       | —                   |
| proxy                  | `browserSettings`       | ✓                   |
| custom proxy           | `browserSettings`       | ✓                   |
| profile                | `browserSettings`       | ✓                   |
| recording              | `browserSettings`       | ✓                   |
| workspace & files      | ✓                       | —                   |
| follow-up conversation | ✓                       | —                   |
| screen size            | `browserSettings`       | ✓                   |
| 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).