Skip to content

Installation

BrowserControl is a single Python package with one optional browser binary download on first run.

Requirements

  • Python 3.11+
  • Operating system: Linux, macOS, or Windows
  • Disk space: ~300 MB once Chromium is downloaded
  • No other system dependencies — Chromium bundles its own runtime

Install with your tool of choice

uv add browsercontrol

If you don't have uv yet:

curl -LsSf https://astral.sh/uv/install.sh | sh

pip install browsercontrol

pipx install browsercontrol

git clone https://github.com/adityasasidhar/browsercontrol
cd browsercontrol
uv sync

Chromium auto-install

On first run, BrowserControl installs a private Chromium build into ~/.cache/ms-playwright/. If the auto-install fails for any reason, run it manually:

python -m playwright install chromium

On Linux you may also want system deps:

python -m playwright install chromium --with-deps

Verify the install

# Show the CLI help
browsercontrol --help

# Run the server (will block waiting for an MCP client)
browsercontrol

If you see a BrowserControl MCP server initialized with all tools log line, you're ready to connect your AI.

Optional: install for a specific Python

pyenv install 3.12
pyenv shell 3.12
pip install browsercontrol

conda create -n browsercontrol python=3.12
conda activate browsercontrol
pip install browsercontrol

Next