🎭 Patchright Python


Patchright Version PyPI Downloads

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!

NodeMaven Banner

NodeMaven: Your efficient proxy provider for Web Scraping and Automation with High Quality IPs.


Why NodeMaven?

🎯 ZIP targeting
✅ 99.9% Uptime
🔍 IP Filtering: Proxies are guaranteed to have fraud score <97%
🔰 No KYC required
🎉 Unique free tools: Proxy Bandwidth Checker, Meta Tag Checker, IP Lookup and others!

Special codes for Patchright users:
🔥 PATCHRIGHT35 - 35% off to Mobile and Residential Proxies
🔥 PATCHRIGHT40 - 40% off to ISP (Static) Proxies

Choose quality and stability with NodeMaven.

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.

ColaProxy Banner

ColaProxy : Low-Cost Residential Proxies for Scalable Automation, Scraping, and Global Data Access

Why choose ColaProxy?

  • Dynamic Residential Proxies from as low as $0.3/GB
  • Massive residential IP pool across 195+ countries
  • 99.9% uptime with stable and fast connections
  • HTTP / HTTPS / SOCKS5 protocol support
  • Rotating & sticky sessions for flexible automation
  • Precise country-level geo-targeting
  • 24/7 expert support

Need reliable proxies for Patchright automation? ColaProxy offers cost-effective residential, ISP, and mobile proxy solutions for scraping, testing, account management, SEO monitoring, and global data collection. Use coupon code COLA20 to enjoy 20% off your order.

Affordable, stable, and built for developers. Start scaling your Patchright projects with ColaProxy.

Scrappey

Sponsored by Scrappey

Getting the browser past detection is one problem. Keeping proxies rotating, fingerprints current and sessions alive across a few million requests is a different one. Scrappey takes the second problem: one endpoint, solved pages back.

  • Clearcote — our own patched Chromium, maintained in-house, not a stock build
  • Several engines behind one endpoint — blocked on one stack, routed to another
  • Click, type, wait and scroll over the API — a real session, not a fetch proxy
  • Residential and datacenter proxies included, or bring your own
  • Per request, no monthly minimum
curl -X POST "https://publisher.scrappey.com/api/v1?key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cmd": "request.get", "url": "https://example.com"}'

Get 10% off with code PATCHRIGHT

Documentation · Discord · Get an API key

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 links

Data verified by PyPI on Aug 29, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.62.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Vinyzu from gravatar.com Vinyzu

Credits

Author: Microsoft Corporation, patched by github.com/Kaliiiiiiiiii-Vinyzu/

GitHub Statistics

Data verified by PyPI on Aug 29, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.10

Classifiers

Report project as malware

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

Uploaded Python 3Windows ARM64

patchright-1.62.2-py3-none-win_amd64.whl (38.2 MB view details)

Uploaded Python 3Windows x86-64

patchright-1.62.2-py3-none-win32.whl (38.2 MB view details)

Uploaded Python 3Windows x86

patchright-1.62.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (47.4 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

patchright-1.62.2-py3-none-manylinux1_x86_64.whl (47.7 MB view details)

Uploaded Python 3

patchright-1.62.2-py3-none-macosx_11_0_universal2.whl (43.7 MB view details)

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

patchright-1.62.2-py3-none-macosx_11_0_arm64.whl (42.5 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

patchright-1.62.2-py3-none-macosx_10_13_x86_64.whl (43.7 MB view details)

Uploaded Python 3macOS 10.13+ x86-64

File details

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

File metadata

  • Download URL: patchright-1.62.2-py3-none-win_arm64.whl
  • Upload date:
  • Size: 34.2 MB
  • Tags: Python 3, Windows ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for patchright-1.62.2-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 ad14de00666b5c2d13e859e9ee76e000df5c7a7452ffca81e1a16f9c617bd4e3
MD5 6bd3e5e438e05c47db4060a4900c523f
BLAKE2b-256 3db34117d15ed2455d8552785b9a0a01261c9204a851668f3febf85b687f32a0

See more details on using hashes here.

Provenance

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

File metadata

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

File hashes

Hashes for patchright-1.62.2-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 9aad3b4500fa69e82bfd8533a0dba93518e275f3f6acb61d44e60a4bf1482138
MD5 ff7f66b6f40db3f4d3ad160311de5f73
BLAKE2b-256 dbf6646c808d6adf064799b7381a7430f95be73f0e9a6a5a635512c882df468a

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: patchright-1.62.2-py3-none-win32.whl
  • Upload date:
  • Size: 38.2 MB
  • Tags: Python 3, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for patchright-1.62.2-py3-none-win32.whl
Algorithm Hash digest
SHA256 9db416e7fabab8e159f1c8279548972c6786e02396b78e856f447158ead5eeed
MD5 0f21a34464b5a3b46b7b7872b724fda9
BLAKE2b-256 24726eaf528fd54845391f52742839f88ba016b38dd4077a8078e23ebd28a136

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.62.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 4772ad6105c8033e961bcbb32775883d4e58dca658e77d59dbaebc2899776b5c
MD5 d1861635a7049dedd9a058a67a410744
BLAKE2b-256 f772985a0c3d7a4a41af6def51cfabad597e32b518fb01d77d7c304d7f55f2e6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.62.2-py3-none-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 1b90b6c31c16ce8ed9ce932c168fffd0c7b452cedd833fef4271e6989b56b7bd
MD5 785a20082c60d93c6ab9972989766210
BLAKE2b-256 ca036cd89013e9584dbb36a9b40a0c77e9abb079201fd5cd9b63e629e2c37a34

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.62.2-py3-none-macosx_11_0_universal2.whl
Algorithm Hash digest
SHA256 a1de2dbb07e4aeb878c75a0ee34f5ffe1d5381d0584b073c7e05cc2c6a2932f3
MD5 29d077ea7bc0f0b0a56f452333304454
BLAKE2b-256 cf35163e2a28f28e0211dcb31ddd4ef5a73878238fc09470fec02d67d5fe4d46

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.62.2-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7b5fa69138f0ce7a9e5ad79ce9e2216811395e97df4fac26d373e409cc4a8bb0
MD5 ddefccd573ded235200e8093bcd147c5
BLAKE2b-256 19ac6b0e2501081d96c523c415b1a1c883e89f8b1d0ce7263c69baf01489106b

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.62.2-py3-none-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 e4a6260aa96d6200f47ab46c4cfa2b4e0e7404b6c2436b11c8cced23515796dd
MD5 c8cf0873cee74d7cf65bb9eac7a323a5
BLAKE2b-256 5f4cfc08cb0d97e839781e992368b6ba4f0701b8e32ea02faa884838b41b88f3

See more details on using hashes here.

Provenance

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

Release history Release notifications | RSS feed

1.62.3

8 files

This release

1.62.2 This release

8 files

1.62.1

8 files

1.61.2

8 files

1.61.1

8 files

1.60.1

8 files

1.60.0

8 files

1.59.1

8 files

1.58.2

8 files

1.58.1

8 files

1.58.0

8 files

1.57.2

8 files

1.57.1

8 files

1.57.0

8 files

1.56.0

8 files

1.55.2

8 files

1.55.1

8 files

1.55.0

8 files

1.52.5

8 files

1.52.4

8 files

1.52.3

8 files

1.52.2

8 files

1.52.0

8 files

1.51.3

7 files

1.51.0

7 files

1.50.0

7 files

1.49.1

7 files

1.49.0

7 files

1.48.0.post0

7 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page