# seleniumbase

> A complete web automation framework for end-to-end testing.

- **URL**: https://www.freshcrate.ai/projects/seleniumbase
- **Author**: Michael Mintz
- **Category**: Frameworks
- **Latest version**: `v4.49.3` (2026-05-30)
- **License**: MIT
- **Source**: https://github.com/seleniumbase/SeleniumBase/releases
- **Homepage**: https://github.com/seleniumbase/SeleniumBase
- **Language**: Python
- **GitHub**: 12,603 stars, 1,543 forks
- **Registry**: pypi (`seleniumbase`)
- **Tags**: `automation`, `browser`, `framework`, `pypi`, `pytest`, `selenium`, `seleniumbase`, `testing`, `webdriver`

## Description

<!-- SeleniumBase Docs -->

<meta property="og:site_name" content="SeleniumBase">
<meta property="og:title" content="SeleniumBase: Python Web Automation and E2E Testing" />
<meta property="og:description" content="Fast, easy, and reliable Web/UI testing with Python." />
<meta property="og:keywords" content="Python, pytest, selenium, webdriver, testing, automation, seleniumbase, framework, dashboard, recorder, reports, screenshots">
<meta property="og:image" content="https://seleniumbase.github.io/cdn/img/mac_sb_logo_5b.png" />
<link rel="icon" href="https://seleniumbase.github.io/img/logo7.png" />

<h1>SeleniumBase</h1>

<p align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/nice_logo_8t.png" alt="SeleniumBase" width="424" /></a></p>

<p align="center" class="hero__title"><b>All-in-one Browser Automation Framework:<br />Web Crawling / Testing / Scraping / Stealth</b></p>

<p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?color=3399EE" alt="PyPI version" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://github.com/seleniumbase/SeleniumBase/workflows/CI%20build/badge.svg" alt="SeleniumBase GitHub Actions" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" /></a> <a href="https://discord.gg/EdhQTn3EyE" target="_blank"><img src="https://img.shields.io/discord/727927627830001734?color=7289DA&label=Discord&logo=discord&logoColor=white"/></a></p>
<p align="center"></p>

<p align="center">
<a href="#python_installation">🚀 Start</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/features_list.md">🏰 Features</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/customizing_test_runs.md">🎛️ Options</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">📚 Examples</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/console_scripts/ReadMe.md">🪄 Scripts</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/mobile_testing.md">📱 Mobile</a>
<br />
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/method_summary.md">📘 The API</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md"> 🔠 SyntaxFormats</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/recorder_mode.md">🔴 Recorder</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/example_logs/ReadMe.md">📊 Dashboard</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/locale_codes.md">🗾 Locale</a>
<br />
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/commander.md">🎖️ GUI</a> |
<a href="https://seleniumbase.io/demo_page">📰 TestPage</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md">👤 UC Mode</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">🐙 CDP Mode</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a>  |
<a href="https://seleniumbase.io/devices/?url=seleniumbase.com">🖥️ Farm</a>
<br />
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/how_it_works.md">👁️ How</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/migration/raw_selenium">🚝 Migration</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">🎭 Stealthy Playwright</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/ReadMe.md">🛂 MasterQA</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/ReadMe.md">🚎 Tours</a>
<br />
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/integrations/github/workflows/ReadMe.md">🤖 CI/CD</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/js_package_manager.md">❇️ JSMgr</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/translations.md">🌏 Translator</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/presenter/ReadMe.md">🎞️ Presenter</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/visual_testing/ReadMe.md">🖼️ Visual</a> |
<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v4.49.3` | 2026-05-30 | High | ## CDP Mode: Patch 108 * [Update CDP Mode](https://github.com/seleniumbase/SeleniumBase/commit/c9773ac87e3ca337e185de87b9fc1c7c777c1cde) * [Update the list of methods](https://github.com/seleniumbase/SeleniumBase/commit/5ed39f29417998d8a916ceb258d98799f75eaffa) * [Update CDP Mode examples](https://github.com/seleniumbase/SeleniumBase/commit/b3d6f0865abb280a3350eeb08f29cf07253b9116) * [Refresh Python dependencies](https://github.com/seleniumbase/SeleniumBase/commit/17905ca95b1abc0e7f6099397f4 |
| `v4.49.2` | 2026-05-22 | High | ## CDP Mode: Patch 107 * [Update CDP Mode](https://github.com/seleniumbase/SeleniumBase/commit/8261b7c605b08c8b431c1c4ad243a76df27d848f) --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/4351 * [Refresh Python dependencies](https://github.com/seleniumbase/SeleniumBase/commit/c80c2fb2ce97d6c83acd8a580cdc57c1f0c58225) * [Refresh Python dependencies](https://github.com/seleniumbase/SeleniumBase/commit/c78890a265e1e81a32c71c89c5d9f0d9de2b563e) * [Update Stealthy Playwright e |
| `v4.49.0` | 2026-05-18 | High | ## CDP Mode: Patch 105 * [Update CDP Mode](https://github.com/seleniumbase/SeleniumBase/commit/15d90a13c5af70a9327e4d8265dbb636b275bce2) * [Update examples](https://github.com/seleniumbase/SeleniumBase/commit/070d0a204f547eedbd64ffa1cdad11c4735e1d1f) * [Update the docs](https://github.com/seleniumbase/SeleniumBase/commit/b8bd5aaca451da5683e88387d711a1d95070f5d9) * [Refresh Python dependencies](https://github.com/seleniumbase/SeleniumBase/commit/1b1f3f19ac37b0cbcd7a0d639ce1d62b2ecc8e2e)  Se |
| `v4.48.4` | 2026-04-30 | High | ## CDP Mode: Patch 104 * [Update CDP Mode](https://github.com/seleniumbase/SeleniumBase/commit/a756d91999539497c8215aff59f520da7ed14633) * [Update CDP Mode examples](https://github.com/seleniumbase/SeleniumBase/commit/0e8b32f9b894cbbac546256f33630b16b08be49a)  ## What's Changed * 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 |
| `v4.48.3` | 2026-04-28 | High | ## Update config and dependencies * [Update default config in Chrome](https://github.com/seleniumbase/SeleniumBase/commit/e5b2ffde2a9131f9e813cd97c430219648cd48e7) * [Refresh Python dependencies](https://github.com/seleniumbase/SeleniumBase/commit/163ef1b5b955df2b3daa201ca5652bb613ee1af9)  ## What's Changed * Update config and dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4338   **Full Changelog**: https://github.com/seleniumbase/SeleniumBase/compare/v4.48 |
| `4.48.2` | 2026-04-21 | Low | Imported from PyPI (4.48.2) |
| `v4.48.2` | 2026-04-18 | High | ## Fix unzip in powershell * [Fix unzip in powershell for paths that contain spaces](https://github.com/seleniumbase/SeleniumBase/commit/2bc7763221c6a0726010caf49476a2f5e87413d7) * [Refresh Python dependencies](https://github.com/seleniumbase/SeleniumBase/commit/b0518dc2bbd3bf28f659a310cec12ef6e07cb4f9)  ## What's Changed * Fix unzip in powershell by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4330   **Full Changelog**: https://github.com/seleniumbase/SeleniumBase/compa |
| `v4.48.2` | 2026-04-18 | Medium | ## Fix unzip in powershell * [Fix unzip in powershell for paths that contain spaces](https://github.com/seleniumbase/SeleniumBase/commit/2bc7763221c6a0726010caf49476a2f5e87413d7) * [Refresh Python dependencies](https://github.com/seleniumbase/SeleniumBase/commit/b0518dc2bbd3bf28f659a310cec12ef6e07cb4f9)  ## What's Changed * Fix unzip in powershell by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4330   **Full Changelog**: https://github.com/seleniumbase/SeleniumBase/compa |
| `v4.48.2` | 2026-04-18 | Medium | ## Fix unzip in powershell * [Fix unzip in powershell for paths that contain spaces](https://github.com/seleniumbase/SeleniumBase/commit/2bc7763221c6a0726010caf49476a2f5e87413d7) * [Refresh Python dependencies](https://github.com/seleniumbase/SeleniumBase/commit/b0518dc2bbd3bf28f659a310cec12ef6e07cb4f9)  ## What's Changed * Fix unzip in powershell by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4330   **Full Changelog**: https://github.com/seleniumbase/SeleniumBase/compa |
| `v4.48.2` | 2026-04-18 | Medium | ## Fix unzip in powershell * [Fix unzip in powershell for paths that contain spaces](https://github.com/seleniumbase/SeleniumBase/commit/2bc7763221c6a0726010caf49476a2f5e87413d7) * [Refresh Python dependencies](https://github.com/seleniumbase/SeleniumBase/commit/b0518dc2bbd3bf28f659a310cec12ef6e07cb4f9)  ## What's Changed * Fix unzip in powershell by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/4330   **Full Changelog**: https://github.com/seleniumbase/SeleniumBase/compa |

## Citation

- HTML: https://www.freshcrate.ai/projects/seleniumbase
- Markdown: https://www.freshcrate.ai/projects/seleniumbase.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/seleniumbase/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._