---
id: seleniumbase
version: "4.51.12"
license: MIT
license_treatment: permissive
maintenance: active
---

# seleniumbase — SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.

License: permissive · Maintenance: active · Downloads: 3.1M/mo

## What it is and what it does

SeleniumBase is a Python framework built on Selenium WebDriver that simplifies browser automation for testing, web scraping, and crawling. It integrates with pytest and other test runners to provide structured test execution, command-line configuration, and a higher-level API than raw Selenium. The framework includes CDP (Chrome DevTools Protocol) mode, which bypasses bot-detection systems by using Chromium directly, and Stealthy Playwright mode, which extends that stealth to Playwright-based scripts.

The package handles common automation tasks—navigation, element selection, form filling, assertions, screenshot capture, PDF export, and CAPTCHA solving—through a simplified method interface. It supports multiple Chromium-based browsers (Chrome, Chromium, Edge, Brave) and provides tools for demo mode (slowed execution with visual highlights), dashboard reporting, and locale configuration. With 60 runtime dependencies, it bundles substantial functionality but requires careful consideration of your actual use case to avoid unnecessary bloat.

Use it for:

- End-to-end testing of web applications with pytest, including multi-step workflows like login, cart checkout, and form submission
- Web scraping and data extraction from JavaScript-heavy sites that require a real browser and bot-detection bypass
- Automated testing of sites protected by Cloudflare, bot-detection systems, or CAPTCHA challenges using CDP mode
- Generating test reports, screenshots, and PDFs from automated browser sessions for documentation and debugging
- Headless browser automation in CI/CD pipelines with command-line control over browser selection and test execution

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

SeleniumBase is a browser automation framework that combines Selenium WebDriver with pytest integration, CDP mode for bot-detection bypass, and tools for web testing, scraping, and crawling.

Yes, if you need a comprehensive browser automation framework with bot-detection bypass and pytest integration. The low install friction, active maintenance, permissive license, and zero known vulnerabilities make it a solid choice. However, the 60 runtime dependencies are substantial—evaluate whether you need the full feature set or if a lighter alternative suits your use case. Ideal for teams building test suites or scraping sites that require stealth; less suitable for simple one-off scripts.

## Install

pip install seleniumbase
uv add seleniumbase
poetry add seleniumbase

## Installing seleniumbase

Before you install: Low install friction with a wheel distribution. Active maintenance—released 4 days ago with 12925 GitHub stars. Supports Python 3.9 through 3.15. Carries 60 runtime dependencies, which is substantial but typical for a full-featured automation framework.

License in practice: MIT license permits commercial and private use with minimal restrictions. You may use, modify, and distribute SeleniumBase freely as long as you include the license notice.

Quickstart:

pip install seleniumbase

from seleniumbase import sb_cdp

sb = sb_cdp.Chrome()
sb.goto("https://example.com")
elements = sb.find_elements("a")
for element in elements:
    print(element.text)
sb.quit()

Requires Python 3.9 or later. CDP mode and browser automation require a Chromium-based browser (Chrome, Chromium, Edge, or Brave); only unbranded Chromium and Chrome-for-Testing install automatically.

Verify before relying:

- Whether all 60 runtime dependencies are required for basic usage or if many are optional for specific features
- Performance characteristics and resource overhead when running multiple concurrent browser sessions
- Compatibility with headless environments and CI/CD platforms beyond the general pytest/Linux/Windows/macOS support listed

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

browser automation testing framework, selenium pytest wrapper, web scraping with stealth, bot detection bypass, CDP mode chromium automation, end-to-end testing framework, headless browser testing, browser-automation, bot-detection-bypass, web-scraping

[View on SkillFed](https://skillfed.io/packages/seleniumbase) · [View on PyPI](https://pypi.org/project/seleniumbase/)