Local Development Setup (0.x) - Browser Use

This page is for browser-use 0.x. Current docs: Introduction. Upgrading: Migrating to 1.0. To stay on 0.x, pin it: pip install 'browser-use<1'.

Welcome to Browser Use Development!

git clone --branch 0.13.14 https://github.com/browser-use/browser-use
cd browser-use
uv sync --all-extras --dev
# or pip install -U git+https://github.com/browser-use/browser-use.git@0.13.14

Configuration

Set up your environment variables:

# Copy the example environment file
cp .env.example .env

# set logging level
# BROWSER_USE_LOGGING_LEVEL=debug

Helper Scripts

For common development tasks

# 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

uv run examples/simple.py

⌘I