seleniumbase
SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- 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.
- Low install friction with a wheel distribution.
License · maintenance · safety
MIT (permissive) — 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.
last release 2026-08-10 (4 days) · last repo commit 2026-08-14 · 12,925 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 3,083,496 downloads/mo, #2,761 on PyPI
Alternatives
Verify before relying
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()- 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
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 on this page. Verify before relying on it.
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
seleniumbase on PyPI
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.
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.
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()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 the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 60 packagespippackagingsetuptoolswheelattrscertifiexceptiongroupwebsocketsfilelockfastenersmycdppynoseplatformdirstyping-extensionssbvirtualdisplayMarkupSafeJinja2sixparseparse-typecoloramapsutilpyyamlpygmentspyreadline3tabcompleterpdbpidnacharset-normalizerurllib3 |
| Maintenance | Actively maintained 4 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 3,083,496 / month, #2,761 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleEnvironment :: MacOS XEnvironment :: Web EnvironmentEnvironment :: Win32 (MS Windows)Framework :: PytestIntended Audience :: DevelopersIntended Audience :: Information TechnologyOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.15Programming Language :: Python :: 3.9Topic :: InternetTopic :: Internet :: WWW/HTTP :: BrowsersTopic :: Scientific/EngineeringTopic :: Scientific/Engineering :: Artificial IntelligenceTopic :: Scientific/Engineering :: Image ProcessingTopic :: Scientific/Engineering :: VisualizationTopic :: Software DevelopmentTopic :: Software Development :: Code GeneratorsTopic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Application FrameworksTopic :: Software Development :: Libraries :: Python ModulesTopic :: Software Development :: Quality AssuranceTopic :: Software Development :: TestingTopic :: Software Development :: Testing :: AcceptanceTopic :: Software Development :: Testing :: Traffic GenerationTopic :: Utilities |
Evidence: seleniumbase-4.51.12-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “selenium pytest wrapper”
- seleniumbaseSeleniumBase is a browser automation framework that combines Selenium…
- pytest-seleniumpytest-selenium is a pytest plugin that integrates Selenium WebDriver…
- seleniumSelenium provides Python bindings to automate web browser…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also selenium-stealth · pytest-selenium · browsergym-core · undetected-chromedriver · zendriver · splinter · DrissionPage · requestium · cloakbrowser · pytest-playwright