Local Setup

​

Prerequisites

Browser Use requires Python 3.11 or higher. We recommend using uv for Python environment management.

​

Clone the Repository

First, clone the Browser Use repository:

git clone https://github.com/browser-use/browser-use
cd browser-use

​

Environment Setup

1. Create a virtual environment:

uv venv --python 3.11

2. Install dependencies:

# Install all dependencies including dev packages
uv pip install . ."[dev]"

​

Configuration

Set up your environment variables:

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

Or manually create a .env file with your API keys:

OPENAI_API_KEY=
ANTHROPIC_API_KEY=

​

Development

After setup, you can:

• Run tests with pytest
• Build the package with hatch build
• Try the examples in the examples/ directory

​

Getting Help

If you run into any issues:

1. Check our GitHub Issues
2. Join our Discord community for support