Skip to main content

Undetected Python version of the Playwright testing and automation library.

Project description

🎭 Patchright Python


Patchright Version GitHub Downloads (all assets, all releases)

Patchright is a patched and undetected version of the Playwright Testing and Automation Framework.
It can be used as a drop-in replacement for Playwright.

[!NOTE]
This repository serves the Patchright-Python Package. To use Patchright with NodeJS, check out the NodeJS Package. Also check out the main Patchright Driver Repository


Sponsors

Hyperbrowser Banner Ad
If you’re looking for a high-performance browser automation platform checkout Hyperbrowser. It’s ideal for AI Agents, large-scale web scraping and automated testing.
Hyperbrowser delivers cloud-based browser infrastructure that scales instantly from a few sessions to thousands, with built-in CAPTCHA solving, stealth fingerprinting, and a global proxy network. It integrates seamlessly with Puppeteer, Playwright, and Selenium, so you can be up and running in minutes, no server or proxy management required.

Key Features:

  • Instant scaling: Launch 1,000+ concurrent browsers
  • Captcha Solving: Handles reCAPTCHA, Cloudflare, AWS, and more
  • Stealth mode: Dynamic, human-like fingerprints for undetectable automation
  • Global proxy network: 170+ countries with rotation and geo-targeting
  • Built-in debugging: Live view and session replay for real-time monitoring
  • 1-line integration: Works with Puppeteer, Playwright, Selenium in Node.js or Python

👉 Learn more at hyperbrowser.ai


Thordata Banner

Thordata - Your First Plan is on Us! 💰Get 100% of your first residential proxy purchase back as wallet balance, up to $900.

⚡ Why Thordata?

🌍 190+ real residential & ISP IP locations
🔐 Fully encrypted, ultra-secure connections
🚀 Optimized for web scraping, ad verification & automation workflows

🔥Don’t wait — this is your best time to start with Thordata and experience the safest, fastest proxy network.


Install it from PyPI

# Install Patchright with Pip from PyPI
pip install patchright
# Install Chromium-Driver for Patchright
patchright install chromium

Usage

Just change the import and use it like playwright. Patchright is a drop-in-replacement for Playwright!

[!IMPORTANT]
Patchright only patches CHROMIUM based browsers. Firefox and Webkit are not supported.

# patchright here!
from patchright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()
    page.goto('http://playwright.dev')
    page.screenshot(path=f'example-{p.chromium.name}.png')
    browser.close()
import asyncio
# patchright here!
from patchright.async_api import async_playwright

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.launch()
        page = await browser.new_page()
        await page.goto('http://playwright.dev')
        await page.screenshot(path=f'example-{p.chromium.name}.png')
        await browser.close()

asyncio.run(main())

Best Practice - use Chrome without Fingerprint Injection

To be completely undetected, use the following configuration:

playwright.chromium.launch_persistent_context(
    user_data_dir="...",
    channel="chrome",
    headless=False,
    no_viewport=True,
    # do NOT add custom browser headers or user_agent
    ...
)

[!NOTE]
We recommend using Google Chrome instead of Chromium. You can install it via patchright install chrome (or via any other installation method) and use it with channel="chrome".


Patches

Runtime.enable Leak

This is the biggest Patch Patchright uses. To avoid detection by this leak, patchright avoids using Runtime.enable by executing Javascript in (isolated) ExecutionContexts.

Console.enable Leak

Patchright patches this leak by disabling the Console API all together. This means, console functionality will not work in Patchright. If you really need the console, you might be better off using Javascript loggers, although they also can be easily detected.

Command Flags Leaks

Patchright tweaks the Playwright Default Args to avoid detection by Command Flag Leaks. This (most importantly) affects:

  • --disable-blink-features=AutomationControlled (added) to avoid navigator.webdriver detection.
  • --enable-automation (removed) to avoid navigator.webdriver detection.
  • --disable-popup-blocking (removed) to avoid popup crashing.
  • --disable-component-update (removed) to avoid detection as a Stealth Driver.
  • --disable-default-apps (removed) to enable default apps.
  • --disable-extensions (removed) to enable extensions

General Leaks

Patchright patches some general leaks in the Playwright codebase. This mainly includes poor setups and obvious detection points.

Closed Shadow Roots

Patchright is able to interact with elements in Closed Shadow Roots. Just use normal locators and Patchright will do the rest.
Patchright is now also able to use XPaths in Closed Shadow Roots.


Stealth

With the right setup, Patchright currently is considered undetectable. Patchright passes:


Documentation and API Reference

See the original Playwright Documentation and API Reference

Extended Patchright API

evaluate Method (Frame.evaluate, Page.evaluate, Locator.evaluate, Worker.evaluate, JSHandle.evaluate)

  • Added isolated_context to choose Execution Context (Main/Isolated). Bool (optional, Defaults to True)
object.evaluate(
    expression: str,
    arg: typing.Optional[typing.Any] = None,
    ...,
+   isolated_context: typing.Optional[bool] = True
)

evaluate_handle Method (Frame.evaluate_handle, Page.evaluate_handle, Locator.evaluate_handle, Worker.evaluate_handle, JSHandle.evaluate)

  • Added isolated_context to choose Execution Context (Main/Isolated). Bool (optional, Defaults to True)
object.evaluate_handle(
    expression: str,
    arg: typing.Optional[typing.Any] = None,
    ...,
+   isolated_context: typing.Optional[bool] = True
)

evaluate_all Method (Locator.evaluate_all)

  • Added isolated_context to choose Execution Context (Main/Isolated). Bool (optional, Defaults to True)
Locator.evaluate_all(
    expression: str,
    arg: typing.Optional[typing.Any] = None,
    ...,
+   isolated_context: typing.Optional[bool] = True
)

Bugs

The bugs are documented in the Patchright Driver Repository.


TODO

The TODO is documented in the Patchright Driver Repository.


Development

Deployment of new Patchright versions are automatic, but bugs due to Playwright codebase changes may occur. Fixes for these bugs might take a few days to be released.


Support our work

If you choose to support our work, please contact @vinyzu or @steve_abcdef on Discord.


Copyright and License

© Vinyzu

Patchright is licensed Apache 2.0


Disclaimer

This repository is provided for educational purposes only.
No warranties are provided regarding accuracy, completeness, or suitability for any purpose. Use at your own risk—the authors and maintainers assume no liability for any damages, legal issues, or warranty breaches resulting from use, modification, or distribution of this code.
Any misuse or legal violations are the sole responsibility of the user.


Authors

Active Maintainer: Vinyzu
Co-Maintainer: Kaliiiiiiiiii

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

patchright-1.57.2-py3-none-win_arm64.whl (32.8 MB view details)

Uploaded Python 3Windows ARM64

patchright-1.57.2-py3-none-win_amd64.whl (36.5 MB view details)

Uploaded Python 3Windows x86-64

patchright-1.57.2-py3-none-win32.whl (36.5 MB view details)

Uploaded Python 3Windows x86

patchright-1.57.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (45.7 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

patchright-1.57.2-py3-none-manylinux1_x86_64.whl (46.0 MB view details)

Uploaded Python 3

patchright-1.57.2-py3-none-macosx_11_0_universal2.whl (42.0 MB view details)

Uploaded Python 3macOS 11.0+ universal2 (ARM64, x86-64)

patchright-1.57.2-py3-none-macosx_11_0_arm64.whl (40.8 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

patchright-1.57.2-py3-none-macosx_10_13_x86_64.whl (42.0 MB view details)

Uploaded Python 3macOS 10.13+ x86-64

File details

Details for the file patchright-1.57.2-py3-none-win_arm64.whl.

File metadata

  • Download URL: patchright-1.57.2-py3-none-win_arm64.whl
  • Upload date:
  • Size: 32.8 MB
  • Tags: Python 3, Windows ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for patchright-1.57.2-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 830173d31c0a9eed6c03192e191dc007f30f05bc580764860cbd0001431f6f01
MD5 ae0187514d14c596401df8e55a034b99
BLAKE2b-256 5c315371fb36ec6ec3b4b1ae1784dd5254e2c7b85d0e0d34dd371933ffde2c53

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.57.2-py3-none-win_arm64.whl:

Publisher: patchright_release.yml on Kaliiiiiiiiii-Vinyzu/patchright-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file patchright-1.57.2-py3-none-win_amd64.whl.

File metadata

  • Download URL: patchright-1.57.2-py3-none-win_amd64.whl
  • Upload date:
  • Size: 36.5 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for patchright-1.57.2-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 8865dca554dbe98b585e277f3d151e0b5fccdf3765408ec0c8631093f7828eda
MD5 37130c6411c7b28e7154299c8cc1e9ae
BLAKE2b-256 d10fed5262996ea573632c4c18ab72c8eafc1eb1ee2c8b3d8470cb52f7075ca1

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.57.2-py3-none-win_amd64.whl:

Publisher: patchright_release.yml on Kaliiiiiiiiii-Vinyzu/patchright-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file patchright-1.57.2-py3-none-win32.whl.

File metadata

  • Download URL: patchright-1.57.2-py3-none-win32.whl
  • Upload date:
  • Size: 36.5 MB
  • Tags: Python 3, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for patchright-1.57.2-py3-none-win32.whl
Algorithm Hash digest
SHA256 54f5f090ed5c9bb331c79c5546b9a43854ee87eb31072c308f45c76561e409b5
MD5 28bb1c9bb8c294f027ffd846ae1fd3e3
BLAKE2b-256 c2877a2e2fab5d25aa4fce59dfe9d69d3b18a437b19243fdf498697dc1fe0f98

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.57.2-py3-none-win32.whl:

Publisher: patchright_release.yml on Kaliiiiiiiiii-Vinyzu/patchright-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file patchright-1.57.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for patchright-1.57.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 b58d6b2122c47dc72204847eff0ec0ea67afcb1f6573fa3f357b149b389af4ff
MD5 65f8760390aeec8047507c5c8f8bc24d
BLAKE2b-256 965cfb81d91376ac15d275812ab6fb8048506ee444413a97319ef640817b0984

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.57.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: patchright_release.yml on Kaliiiiiiiiii-Vinyzu/patchright-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file patchright-1.57.2-py3-none-manylinux1_x86_64.whl.

File metadata

File hashes

Hashes for patchright-1.57.2-py3-none-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 5119daf606c0d21185ef4d2a6f4008db915173ed11601ebedd67abadcab0d594
MD5 d8bf63ae450e6e3682a00e43e41908a6
BLAKE2b-256 fa6b214164f57f339742c3795e55cd472c7cdb82ac769d89548c6526477794f8

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.57.2-py3-none-manylinux1_x86_64.whl:

Publisher: patchright_release.yml on Kaliiiiiiiiii-Vinyzu/patchright-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file patchright-1.57.2-py3-none-macosx_11_0_universal2.whl.

File metadata

File hashes

Hashes for patchright-1.57.2-py3-none-macosx_11_0_universal2.whl
Algorithm Hash digest
SHA256 af8e74a16af04dda592a8f8e89e4dd041e1ffcfd90566d17577176958fe80393
MD5 3b70fc61be201bda4f352e1b73fca44d
BLAKE2b-256 4984d3f53f39855288bbe26a4ee8b5af00e1aab940af7dc971be53b3209671a9

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.57.2-py3-none-macosx_11_0_universal2.whl:

Publisher: patchright_release.yml on Kaliiiiiiiiii-Vinyzu/patchright-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file patchright-1.57.2-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for patchright-1.57.2-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 b16d07fc454fbd7392c29663784abf9a577b2482df3479ae487ecd8bc3948b68
MD5 17cdca47f88c7c5f59a353dfba276efa
BLAKE2b-256 dfa080ee346f4d22cca4d6e6112e162dad51d9702350438b4b644acfe2874ce2

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.57.2-py3-none-macosx_11_0_arm64.whl:

Publisher: patchright_release.yml on Kaliiiiiiiiii-Vinyzu/patchright-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file patchright-1.57.2-py3-none-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for patchright-1.57.2-py3-none-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 eecd88992104156da183bf0e0144a43c278227a0eb9e538ae62c3f01448b86b8
MD5 d081fb665815214aeb16ee30b05eae8a
BLAKE2b-256 e09d2e8ab9f09bdbfd4b8b17229f92f3b2af32fd8474a19c92d94f08c7a78dd1

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.57.2-py3-none-macosx_10_13_x86_64.whl:

Publisher: patchright_release.yml on Kaliiiiiiiiii-Vinyzu/patchright-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page