Undetected Python version of the Playwright testing and automation library.

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for Vinyzu from gravatar.com Vinyzu

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: Apache-2.0
    SPDX License Expression
  • Author: Microsoft Corporation, patched by github.com/Kaliiiiiiiiii-Vinyzu/
  • Requires: Python >=3.9
Classifiers
Report project as malware

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

Want to Sponsor this Project? Contact @vinyzu on Discord!


swiftproxy banner

Swiftproxy: High-Performance Residential Proxies for Scalable Data Collection

Built for developers who need reliable, anti-detection proxy infrastructure. Swiftproxy delivers stable connections, high success rates, and flexible control for large-scale scraping and automation.

  • 🌍 195+ locations with ethically sourced residential IPs
  • 🔄 Rotating & sticky sessions with precise geo-targeting
  • ⚡ Optimized for anti-ban & high success rate
  • 🔌 HTTP / HTTPS / SOCKS5 support
  • 🧪 Free 500MB trial for testing
  • 💸 Special discount code for Patchright users: PROXY90 - 10%

Best for: Web scraping, automation, multi-accounting, and large-scale data extraction

rapidproxy banner

RapidProxy provides a stable and high-performance proxy network built for large-scale data operations.

RapidProxy delivers:

  • 🌍 90M+ Residential IPs (200+ locations)
  • 🔄 Rotating Residential Proxies — from $0.65/GB (non-expiring traffic)
  • 🧩 Static Residential IPs — $5/IP (30 days, unlimited traffic)
  • 🎯 Precise geo-targeting
  • ⚡ Free Trial Available — test proxy performance risk-free
  • Built for scraping, automation, and high-performance data workflows.
  • 🔥 Special Offer: Use code RAPID10 to get 10% off

Start fast. Scale globally. Stay stable with RapidProxy.

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

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for Vinyzu from gravatar.com Vinyzu

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: Apache-2.0
    SPDX License Expression
  • Author: Microsoft Corporation, patched by github.com/Kaliiiiiiiiii-Vinyzu/
  • Requires: Python >=3.9
Classifiers

Release history Release notifications | RSS feed

This version

1.60.1

1.60.0

1.59.1

1.58.2

1.58.1

1.58.0

1.57.2

1.57.1

1.57.0

1.56.0

1.55.2

1.55.1

1.55.0

1.52.5

1.52.4

1.52.3

1.52.2

1.52.0

1.51.3

1.51.0

1.50.0

1.49.1

1.49.0

1.48.0.post0

0.0.1

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

Uploaded Python 3Windows ARM64

patchright-1.60.1-py3-none-win_amd64.whl (37.9 MB view details)

Uploaded Python 3Windows x86-64

patchright-1.60.1-py3-none-win32.whl (37.9 MB view details)

Uploaded Python 3Windows x86

patchright-1.60.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (47.1 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

patchright-1.60.1-py3-none-manylinux1_x86_64.whl (47.5 MB view details)

Uploaded Python 3

patchright-1.60.1-py3-none-macosx_11_0_universal2.whl (43.5 MB view details)

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

patchright-1.60.1-py3-none-macosx_11_0_arm64.whl (42.2 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

patchright-1.60.1-py3-none-macosx_10_13_x86_64.whl (43.5 MB view details)

Uploaded Python 3macOS 10.13+ x86-64

File details

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

File metadata

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

File hashes

Hashes for patchright-1.60.1-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 f795728c1e27fc226dbe203c1aec713a537f01be963474fe0f3691f5e6457f9f
MD5 e8c06d6354be54df0bdea1e2ff07f3e1
BLAKE2b-256 eeb8b6d1bfe98a420c1ccfb2f23a7bb2b4cdb40170907bae638e7ae92abd287c

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.60.1-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.60.1-py3-none-win_amd64.whl.

File metadata

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

File hashes

Hashes for patchright-1.60.1-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 51b306ed55cd58f1bca24641458f5c9f7e86a1f1727dcffdead669cfe4c0a485
MD5 f0445801061e6de8bbca9158254620f3
BLAKE2b-256 748efff80350ed2c2c1f62145d667070799c60ca9e9b28d54e4f751f0b4f8da6

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.60.1-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.60.1-py3-none-win32.whl.

File metadata

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

File hashes

Hashes for patchright-1.60.1-py3-none-win32.whl
Algorithm Hash digest
SHA256 05b98a6afdbe7e6645fe223009c47cc8e7859df55fd8ce9d8a9925b3389b0ee1
MD5 8550721ee8014b02d70d5e20f3329fd3
BLAKE2b-256 08bc81fb621e5ab4131e6f324c9ba6cb2a9f3b146c92f12484bec95efe8c8347

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.60.1-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.60.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for patchright-1.60.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 023945a2fd30219a284721ca36385bd44075ae7b53071dc1da38036b6dbe88ec
MD5 cefe44ab36549322e170feb0311c7946
BLAKE2b-256 dbfc9fd6a70818cf0bc3b62574af483d762963cb65ca0a369826a0536faffe41

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.60.1-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.60.1-py3-none-manylinux1_x86_64.whl.

File metadata

File hashes

Hashes for patchright-1.60.1-py3-none-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 547e7bfb813102309789cc42933780e5fdf7c4727de59fb2791e64bd1298a7f3
MD5 cb39aeffcf80dd05bf47849428b88f4c
BLAKE2b-256 cec24b8f69de0a20d90792980c43c0e60b10b801e08cf0224ccc8a8266e1fffb

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.60.1-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.60.1-py3-none-macosx_11_0_universal2.whl.

File metadata

File hashes

Hashes for patchright-1.60.1-py3-none-macosx_11_0_universal2.whl
Algorithm Hash digest
SHA256 9fd15a64c0ca80740dc2a3f41cda336a06a2ed6068d0ab893172654290b06e6b
MD5 0064e7ee72f9d99fbc0d630e90e12b92
BLAKE2b-256 54cc0fa0bedec61045fd9068682e3695557b622c483f829d341093879ec8dbd9

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.60.1-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.60.1-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for patchright-1.60.1-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 20bd806df2469b451ccd2ea10f5f944ceb0e0d83c716f5752b0c956c1ee59476
MD5 e09ff5a04dd12527b80a9f2e8fce69ed
BLAKE2b-256 55dd2dd8e4e02489ec8fd57ad93dec9ef444b6f42adcc4fe95df30237c92841d

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.60.1-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.60.1-py3-none-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for patchright-1.60.1-py3-none-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 e9492100d4e2a85ff92fc3a668dd16dee03f21df6e559c7b9f7c71e86ff48c6b
MD5 919ea3e6bbc24ef6b8268062d7ec3562
BLAKE2b-256 7126c1e858fd1acc63e410b3d33243955f36d2a0814487b97a7aa604ad2baffd

See more details on using hashes here.

Provenance

The following attestation bundles were made for patchright-1.60.1-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