> ## Documentation Index
> Fetch the complete documentation index at: https://browseruse-0aece648-codex-clarify-browser-infrastructure.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Run browser automation in the cloud

Sandboxes package agents, browsers, persistence, authentication, cookies, and
LLMs into a managed runtime.

<Note>
  Get your API key at [cloud.browser-use.com/new-api-key](https://cloud.browser-use.com/new-api-key).
  See [pricing](https://browser-use.com/pricing) for current plans and credits.
</Note>

## Basic Example

Wrap your function with `@sandbox()`:

```python theme={null}
from browser_use import Browser, sandbox, ChatBrowserUse
from browser_use.agent.service import Agent

@sandbox()
async def my_task(browser: Browser):
    agent = Agent(task="Find the top HN post", browser=browser, llm=ChatBrowserUse())
    await agent.run()

await my_task()
```

## With Cloud Parameters

```python theme={null}
@sandbox(
    cloud_profile_id='your-profile-id',      # Use saved cookies/auth
    cloud_proxy_country_code='us',           # Route traffic through a supported location
    cloud_timeout=60,                        # Max session time (minutes)
)
async def task(browser: Browser, url: str):
    agent = Agent(task=f"Visit {url}", browser=browser, llm=ChatBrowserUse())
    await agent.run()

await task(url="https://example.com")
```

**What each does:**

* `cloud_profile_id` - Use saved cookies/authentication from your cloud profile
* `cloud_proxy_country_code` - Route traffic through a supported proxy location
* `cloud_timeout` - Maximum time browser stays open in minutes

***

For more parameters and events, see the other tabs in this section.