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

# Local Setup

> We're excited to have you join our community of contributors. 

## Welcome to OpenBrowser Development!

```bash theme={null}
git clone https://github.com/billy-enrizky/openbrowser-ai
cd openbrowser-ai
uv sync --all-extras --dev
# or pip install -U git+https://github.com/billy-enrizky/openbrowser-ai.git
```

## Configuration

Set up your environment variables:

```bash theme={null}
# Copy the example environment file
cp .env.example .env

# set logging level
# OPENBROWSER_LOGGING_LEVEL=debug
```

## Helper Scripts

For common development tasks

```bash theme={null}
# Complete setup script - installs uv, creates a venv, and installs dependencies
./bin/setup.sh

# Run all pre-commit hooks (formatting, linting, type checking)
./bin/lint.sh

# Run the core test suite that's executed in CI
./bin/test.sh
```

## Run examples

```bash theme={null}
uv run examples/simple.py
```