NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #3401 most downloaded on PyPI
SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
Latest stable
4.57.1
Last release 9 days ago
05 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
8 versions withdrawn
withdrawn after publishing
11 years old
1234 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Refresh Python dependencies -- Refresh filelock, pytest, and pyotp.
filelock, pytest, and pyotp.Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.12...v4.49.13
Add missing await for async method call in CDP Mode -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4388 -- (Applies to setting a
ad_block=True in CDP Mode)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.11...v4.49.12
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Update MyCDP -- (Note that all CDP calls go through MyCDP)
MyCDP)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.10...v4.49.11
Update CDP Mode -- Improve error-handling for various edge-cases -- Make sure all CDP Mode methods can be called via sb.METHOD (rather than sb.cdp.MET
sb.METHOD (rather than sb.cdp.METHOD)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.9...v4.49.10
Add functionality for handling downloads in CDP Mode -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4376
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.8...v4.49.9
Update the self-hosted dashboard -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4372
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.7...v4.49.8
Fix RuntimeWarning: coroutine 'Connection.aclose' was never awaited
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.6...v4.49.7
Fix RuntimeWarning: coroutine 'Event.wait' was never awaited --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4363
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.5...v4.49.6
Update error-handling for checking if a process is still running
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.4...v4.49.5
Handle PermissionError in methods that use psutil
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.3...v4.49.4
Fixed assertion output in CDP Mode.
flash() method as CDP mode.Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.2...v4.49.3
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4351
This simplifies a lot of method calls. Eg. sb.cdp.METHOD() can now be called with sb.METHOD().
Over 40 examples have been updated to include website changes and simplifications.
sb.solve_captcha() now detects more CAPTCHAs than it did before.
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.1...v4.49.2
Update CDP Mode --> Add is_running() to help determine if the browser process is running. (For debugging)
is_running() to help determine if the browser process is running. (For debugging)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.49.0...v4.49.1
SeleniumBase CDP Mode now makes Chrome-for-Testing stealthy! (Add --cft as a command-line option to use this feature.)
SeleniumBase CDP Mode now makes Chrome-for-Testing stealthy!
(Add --cft as a command-line option to use this feature.)
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.48.4...v4.49.0
CDP Mode: Patch 104 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4339
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.48.3...v4.48.4
Update default config in Chrome
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.48.2...v4.48.3
Fix unzip in powershell for paths that contain spaces
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.48.1...v4.48.2
Update default config for Chrome and Edge
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.48.0...v4.48.1
Update CDP Mode --> solve_captcha() now supports "Friendly Captcha" --> nest-asyncio is patched from within to avoid deprecation warnings on Python 3.…
solve_captcha() now supports "Friendly Captcha"
--> nest-asyncio is patched from within to avoid deprecation warnings on Python 3.14selenium upgradeFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.47.9...v4.48.0
CDP Mode: Patch 103 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4313
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.47.8...v4.47.9
Fix issues with Stealthy Playwright Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4302
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.47.7...v4.47.8
CDP Mode: Patch 101 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4298
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.47.6...v4.47.7
Add a scroll option to multiple clicking methods
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.47.5...v4.47.6
Fix thread-locking in async CDP Mode
get_text() method, have selector default to "body"driver.quit() interchangeable with driver.stop()Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.47.4...v4.47.5
CDP Mode: Patch 98 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4286
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.47.3...v4.47.4
This resolves https://github.com/seleniumbase/SeleniumBase/issues/4276
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.47.2...v4.47.3
CDP Mode: Patch 96 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4274
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.47.1...v4.47.2
CDP Mode: Patch 95 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4257
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.47.0...v4.47.1
CDP and Docker updates by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4252
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.46.5...v4.47.0
Refresh Python dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4241
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.46.4...v4.46.5
Fix shutil copy typo -- Should be shutil.copy2 (not 3)
shutil copy typoshutil.copy2 (not 3)shutil copy typo by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4232Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.46.3...v4.46.4
CDP Mode: Patch 94 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4229
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.46.2...v4.46.3
Remove a CDP workaround that's no longer needed --> Related to user_data_dir usage on older Chrome versions.
user_data_dir usage on older Chrome versions.Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.46.1...v4.46.2
`variables` should accept a Python dict in `sb_manager`
variables updatevariables update by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4222Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.46.0...v4.46.1
Update CDP Mode -- Mostly updates to the async format.
async format.Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.13...v4.46.0
Fix an issue with CDP Mode -- This resolves https://github.com/seleniumbase/SeleniumBase/issues/4209
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.12...v4.45.13
Add Stealthy Playwright examples
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.11...v4.45.12
Improve the virtual display error-handling
solve_captcha() method can now click on the Imperva/Incapsula hCaptcha.use_chromium=True is set.Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.10...v4.45.11
Prevent duplicate virtual displays --> This prevents a memory leak when activating CDP Mode on Linux
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.9...v4.45.10
Update CDP Mode --> Prevent an Xvfb memory leak on Linux for Pure CDP Mode
sbase mkdir DIR by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4198Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.8...v4.45.9
Fix an issue with the async event handler --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4192
sb.evaluate() instead of sb.cdp.evaluate().sb.evaluate() shortcut mentioned above.pdfminer.six (optional)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.7...v4.45.8
Improvements to bypass PX CAPTCHAs on sites using PerimeterX
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.6...v4.45.7
Hovering and clicking in CDP Mode without PyAutoGUI.
asyncio.create_task instead of asyncio.gather.Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.5...v4.45.6
Fix base Chromium in Driver() format --> Specifically Driver(use_chromium=True) or --use-chromium with Driver() --> Also fixes Chrome-for-Testing and
Driver(use_chromium=True) or --use-chromium with Driver()
--> Also fixes Chrome-for-Testing and Chrome-Headless-Shell with Driver() formatFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.4...v4.45.5
Add Stealthy Playwright examples
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.3...v4.45.4
Add support for base "Chromium" --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4174
sbase get chromium downloads Chromium to the seleniumbase/chromium_drivers/ folder.
In scripts, use Chromium via use_chromium=True, or --use-chromium on the command-line.
(Unlike Chrome 142+, Chromium still allows extensions with the --load-extension switch.)
In SeleniumBase, use extension_dir="DIR1,DIR2" / --extension-dir="DIR1,DIR2" to load.
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.2...v4.45.3
Try to prevent a CDP Mode memory leak
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.1...v4.45.2
Fix issue with passing options to new tabs in CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4157
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.45.0...v4.45.1
Add "Stealthy Playwright Mode" examples
--> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4155 --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4154 --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4153 --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4152 --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4150
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.20...v4.45.0
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4140 --> This resolves https://github.com/seleniumbase/SeleniumB
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.19...v4.44.20
Update CDP Mode --> Includes various improvements to CDP Mode
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.18...v4.44.19
This resolves multiple issues with CDP Mode related to:
This resolves multiple issues with CDP Mode related to:
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.17...v4.44.18
Update CDP Mode --> Prevent stuck page loads from freezing scripts forever (add timeouts)
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.16...v4.44.17
Update Recorder Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4125 --> This resolves https://github.com/seleniumbase/Sele
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.15...v4.44.16
Fix the Atlas Browser integration --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4123
CDP Mode: Patch 78
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.14...v4.44.15
Fix issue with opening new tabs in CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4121
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.13...v4.44.14
Fix disable_csp=True in CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4115
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.12...v4.44.13
Add updates for pytest --> (Needed to support the latest pytest)
pytest)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.11...v4.44.12
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4099 --> This resolves https://github.com/seleniumbase/SeleniumB
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.10...v4.44.11
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4096 --> This also fixes a few other issues with UC Mode
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.44.9...v4.44.10
One column per quarter.