browserget

Standalone CLI to install browsers and drivers without any framework.

Chrome for Testing, Firefox, Edge, ChromeDriver, GeckoDriver, EdgeDriver — all from a single tool. Python 3.11+, zero heavy dependencies.

Why?

playwright install ties you to Playwright. puppeteer install ties you to Puppeteer. browserget installs browsers for any use — automation, scraping, testing, CDP, BiDi, whatever.

Features

• 6 targets — Chrome, Firefox, Edge + ChromeDriver, GeckoDriver, EdgeDriver
• Concurrent installs — multiple targets install in parallel
• Driver matching — --for chrome auto-matches ChromeDriver to your Chrome
• Checksum verification — SHA-256/SHA-512 when upstream provides checksums
• Registry tracking — JSON registry tracks every installed artifact
• JSON output — every command supports --json for CI/CD integration
• Retry with backoff — HTTP client retries failed requests automatically
• Disk space checks — verifies sufficient space before downloading
• Platform detection — auto-detects OS and architecture

Installation

pip install browserget

Quick start

# Install latest stable Chrome
browserget install chrome

# Install matching ChromeDriver
browserget install chromedriver --for chrome

# Ensure browsers are installed (idempotent — skips if present)
browserget ensure chrome chromedriver

# Verify system health
browserget doctor

Usage

# Install specific version
browserget install chrome --version 131.0.6778.87

# Install by milestone (latest patch in 131)
browserget install chrome --version 131

# Install Firefox and Edge
browserget install firefox edge

# Install EdgeDriver
browserget install edgedriver --for edge

# List installed browsers
browserget list

# Get path to installed browser
browserget path chrome

# Remove a browser
browserget remove chrome

# Remove all versions of a target
browserget remove chrome --all

# List available versions for a target
browserget versions chrome

# Check system health
browserget doctor

# JSON output for CI/CD
browserget install chrome --json

Examples

CI pipeline (idempotent)

pip install browserget
browserget ensure chrome chromedriver
CHROME_PATH=$(browserget path chrome)

Install a browser and its matching driver

browserget install chrome
browserget install chromedriver --for chrome

Pin a specific version

browserget install firefox --version 131.0
browserget install geckodriver --for firefox

List and clean up

browserget list
browserget remove chrome --version 130.0.6723.69
browserget doctor

JSON output

browserget list --json

Output:

[
  {"name": "chrome", "version": "131.0.6778.87", "path": "/home/user/.browserget/chrome/131.0.6778.87/chrome"},
  {"name": "chromedriver", "version": "131.0.6778.87", "path": "/home/user/.browserget/chromedriver/131.0.6778.87/chromedriver"}
]

Supported targets

Requirements

• Python 3.11, 3.12, or 3.13
• typer (installed automatically)
• Internet access to download browser binaries

Documentation

Full documentation is available at https://mathiaspaulenko.github.io/browserget/.

• Install command — detailed usage and examples
• Ensure command — idempotent installs for CI pipelines
• Cache management — cache location, cleanup, and configuration
• CLI reference — complete command and flag documentation
• Architecture — module diagram and design decisions

Contributing

Contributions are welcome! See CONTRIBUTING.md for development setup, testing, and pull request guidelines.

License

MIT — see LICENSE.