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


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.55.2-py3-none-win_arm64.whl (31.2 MB view details)

Uploaded Python 3Windows ARM64

patchright-1.55.2-py3-none-win_amd64.whl (35.5 MB view details)

Uploaded Python 3Windows x86-64

patchright-1.55.2-py3-none-win32.whl (35.5 MB view details)

Uploaded Python 3Windows x86

patchright-1.55.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (45.3 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

patchright-1.55.2-py3-none-manylinux1_x86_64.whl (45.9 MB view details)

Uploaded Python 3

patchright-1.55.2-py3-none-macosx_11_0_universal2.whl (40.4 MB view details)

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

patchright-1.55.2-py3-none-macosx_11_0_arm64.whl (38.7 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

patchright-1.55.2-py3-none-macosx_10_13_x86_64.whl (40.4 MB view details)

Uploaded Python 3macOS 10.13+ x86-64

File details

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

File metadata

  • Download URL: patchright-1.55.2-py3-none-win_arm64.whl
  • Upload date:
  • Size: 31.2 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.55.2-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 64d10d3ef080acfed63b27b94106b380d85ec3d2577154ca1a5853d453451f3d
MD5 fabb54e0a8eb417d1ff23ea699a1e8b3
BLAKE2b-256 ba3e763eab982ba23887f0564af5fc599323880f169390a17f724d4aec475ea1

See more details on using hashes here.

Provenance

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

Publisher: patchright_workflow.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.55.2-py3-none-win_amd64.whl.

File metadata

  • Download URL: patchright-1.55.2-py3-none-win_amd64.whl
  • Upload date:
  • Size: 35.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.55.2-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 7018eb12650077e87d8608fa3d0523f2328997c3973407cfa993014b254a705c
MD5 6e3b6102e5ea467c1895a1f5f56c63bb
BLAKE2b-256 190657ecc1bce388bdb970141aedb45ebc6f91e3914e0fb92d4a8aa1535c8ca4

See more details on using hashes here.

Provenance

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

Publisher: patchright_workflow.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.55.2-py3-none-win32.whl.

File metadata

  • Download URL: patchright-1.55.2-py3-none-win32.whl
  • Upload date:
  • Size: 35.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.55.2-py3-none-win32.whl
Algorithm Hash digest
SHA256 b4e36ec235f4a4e5845763327f6dd552866f96ab7fedda121d89ea95b62386d2
MD5 df57b23f9898e3ee631dafa184ce2bfb
BLAKE2b-256 73181b499548864461f56fa557f4e6f975179ae6732fa7e957104c44b5e5957e

See more details on using hashes here.

Provenance

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

Publisher: patchright_workflow.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.55.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for patchright-1.55.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 8771ec426f8b19098426b00322043d93127490ff15a639933baed37bdafd75d5
MD5 a4a4cab29469bcf436e2d6ed4e1ac6ac
BLAKE2b-256 6506fa03fe1717e1ef25a65c0e352adf955f9e823e19bb6340fb5f3fbc554560

See more details on using hashes here.

Provenance

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

Publisher: patchright_workflow.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.55.2-py3-none-manylinux1_x86_64.whl.

File metadata

File hashes

Hashes for patchright-1.55.2-py3-none-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 9f4ee976895a7083a253de1bfabfa36801e719800a7e98c39f7535924ba1c8b1
MD5 8d7d464949ee48e4d759b6ce23869ef9
BLAKE2b-256 312c4da1001c4c0d0c8b269f8e2aaffc4d810cb8601370e4473c0756bceb7405

See more details on using hashes here.

Provenance

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

Publisher: patchright_workflow.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.55.2-py3-none-macosx_11_0_universal2.whl.

File metadata

File hashes

Hashes for patchright-1.55.2-py3-none-macosx_11_0_universal2.whl
Algorithm Hash digest
SHA256 f9f5b7a386f18357c567905aaf4f26bb58b9c1d54f2f13e727a69be5fd06ef39
MD5 b4457e8dc3aa689c2ff29a92c3d939b9
BLAKE2b-256 ad8d8acd6e078082155eb416773cbda90921a89e21a470a5b000d0f4b7350fb2

See more details on using hashes here.

Provenance

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

Publisher: patchright_workflow.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.55.2-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for patchright-1.55.2-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 8e0f3f3d1cff7e31f93d1725af35748e6ab77899244e5764a56450bcc52d9ef8
MD5 5ece8eff3e64f20f6841ac67e6f10d39
BLAKE2b-256 dd8e4e6f513d87876f643f3523ab789b6aefda04b5f4202d5aea0caf94538053

See more details on using hashes here.

Provenance

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

Publisher: patchright_workflow.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.55.2-py3-none-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for patchright-1.55.2-py3-none-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 329c6c94e19181d59cb3fdfb126ea1156b218f57450bdca1eba3d0e98f8ccc45
MD5 ddc7e7f2c9bc50546dbbc2438981ca19
BLAKE2b-256 3394b02c620444cfe65aace1a7189f0d45b43ccabee5df6e7be36adbb464377b

See more details on using hashes here.

Provenance

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

Publisher: patchright_workflow.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