---
id: selenium-stealth
version: "1.0.6"
license: unclear
license_treatment: permissive
maintenance: abandoned
---

# selenium-stealth — Trying to make python selenium more stealthy.

License: permissive · Maintenance: abandoned · Downloads: 300.1K/mo

## What it is and what it does

selenium-stealth is a Python wrapper around Selenium WebDriver that injects JavaScript into Chrome to mask signs of automation. It modifies browser properties—user agent, language, platform, WebGL vendor, and renderer—to make a Selenium-driven Chrome instance appear like a normal user browser rather than a bot. The package is a Python port of the JavaScript puppeteer-extra-plugin-stealth library.

You pass your Selenium Chrome driver to the stealth() function, which configures it with spoofed browser attributes and JavaScript patches. The goal is to pass bot-detection tests and allow tasks like Google account login or maintaining a normal reCAPTCHA v3 score. However, the package has been abandoned since late 2020 and receives no updates, so its effectiveness against modern detection systems is uncertain.

Use it for:

- Automate Google account login or other services that block Selenium-driven browsers.
- Scrape websites that use bot-detection JavaScript to block automated access.
- Maintain a normal reCAPTCHA v3 score when running Selenium automation.
- Pass public bot-detection tests (e.g., bot.sannysoft.com) with a headless or headful Chrome driver.
- Bypass browser-based fingerprinting that flags Selenium automation signals.

## Worth the install?

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

Modifies a Selenium Chrome WebDriver to evade bot-detection mechanisms by injecting JavaScript that masks automation signals.

No. While the package has low install friction and a permissive license, it is abandoned (last update 2021-12-30, no releases since 2020-11-05) and bot-detection techniques have evolved significantly since then. Installing it risks wasting time on evasion methods that no longer work. Consider it only if you are certain the specific detection bypass it provides still works against your target, and be prepared to maintain or fork the code yourself.

## Install

pip install selenium-stealth
uv add selenium-stealth
poetry add selenium-stealth

## Installing selenium-stealth

Before you install: Low install friction—pure Python wheel with a single runtime dependency on selenium. However, the package is abandoned: last commit was 2021-12-30 and no releases since 2020-11-05. Maintenance status poses a risk if Selenium or detection-evasion techniques evolve.

License in practice: MIT license (permissive). You may use, modify, and distribute this package freely, including in commercial projects, with minimal restrictions.

Quickstart:

from selenium import webdriver
from selenium_stealth import stealth

options = webdriver.ChromeOptions()
driver = webdriver.Chrome(options=options)
stealth(driver, languages=["en-US", "en"], vendor="Google Inc.", platform="Win32")
driver.get("https://example.com")

Requires a Chrome WebDriver executable and Chrome browser installed; only supports Chrome, not Firefox or other browsers.

Verify before relying:

- Whether evasion techniques remain effective against current bot-detection systems (package has not been updated since 2020).
- Compatibility with recent Selenium versions and Chrome/Chromium releases.
- Whether the injected JavaScript stealth passes still work against evolving detection methods.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 300.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

selenium bot detection bypass, selenium stealth mode, prevent selenium detection, selenium chrome evasion, selenium webdriver masking, automation detection prevention, selenium headless detection, selenium-automation, bot-detection-evasion, abandoned

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