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

# launch_local_browser

Launch a local Chromium browser with CDP enabled. Only available in embedded mode (`Skyvern.local()`).

Install the local extra and Playwright's Chromium browser before launching:

```bash theme={null}
pip install "skyvern[local]"
python -m playwright install chromium
```

```python theme={null}
skyvern = Skyvern.local()
browser = await skyvern.launch_local_browser(headless=False)
page = await browser.get_working_page()
```

## Parameters

| Parameter       | Type        | Required | Default | Description                                 |
| --------------- | ----------- | -------- | ------- | ------------------------------------------- |
| `headless`      | `bool`      | No       | `False` | Run browser without a visible window.       |
| `port`          | `int`       | No       | `9222`  | CDP port.                                   |
| `args`          | `list[str]` | No       | `None`  | Additional Chromium launch arguments.       |
| `user_data_dir` | `str`       | No       | `None`  | Custom user data directory for the browser. |

## Returns `SkyvernBrowser`

<Note>
  `launch_local_browser` only works in embedded mode because a remote server cannot reach localhost. TypeScript SDK does not support local mode.
</Note>