🎭 Patchright Python
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.
Sponsors
Want to Sponsor this Project? Contact @vinyzu on Discord!
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.
Check Nodemaven's new GitHub for more web scraping and automation solutions - https://github.com/nodemaven
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 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.
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
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!
# 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
...
)
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:
- Brotector ✅ (with CDP-Patches)
- Cloudflare ✅
- Kasada ✅
- Akamai ✅
- Shape/F5 ✅
- Bet365 ✅
- Datadome ✅
- Fingerprint.com ✅
- CreepJS ✅
- Sannysoft ✅
- Incolumitas ✅
- IPHey ✅
- Browserscan ✅
- Pixelscan ✅
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_contextto choose Execution Context (Main/Isolated).Bool(optional, Defaults toTrue)
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_contextto choose Execution Context (Main/Isolated).Bool(optional, Defaults toTrue)
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_contextto choose Execution Context (Main/Isolated).Bool(optional, Defaults toTrue)
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
1 maintainer
Metadata
1 maintainer
Release files for patchright 1.64.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| patchright-1.64.2-py3-none-win_arm64.whl | Python 3 | none | Windows ARM64 | Details |
| patchright-1.64.2-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| patchright-1.64.2-py3-none-win32.whl | Python 3 | none | Windows x86-32 | Details |
| patchright-1.64.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| patchright-1.64.2-py3-none-manylinux1_x86_64.whl | Python 3 | none | Linux glibc 2.5+ x86-64 | Details |
| patchright-1.64.2-py3-none-macosx_11_0_universal2.whl | Python 3 | none | macOS 11.0+ universal2 (ARM64, x86-64) | Details |
| patchright-1.64.2-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| patchright-1.64.2-py3-none-macosx_10_13_x86_64.whl | Python 3 | none | macOS 10.13+ x86-64 | Details |
Total release size: 341.0 MB
Release files / patchright-1.64.2-py3-none-win_arm64.whl
| Download URL | patchright-1.64.2-py3-none-win_arm64.whl |
|---|---|
| Size | 34.7 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
b472d3394d7ed5c31307ee4dff11813c8e90dbe5345c9357e8967d5a8826bdc9
|
|
BLAKE2b-256 checksum How to use checksums |
2c85b4c176316a8da67f27049558d54a17dbe8d7599c3428510aedde2b249919
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logRelease files / patchright-1.64.2-py3-none-win_amd64.whl
| Download URL | patchright-1.64.2-py3-none-win_amd64.whl |
|---|---|
| Size | 38.8 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
46d2a444d5c97bab24243521fe4a515fc6fd9433ff6536aee87f8bc3ab250cad
|
|
BLAKE2b-256 checksum How to use checksums |
df004499f5ddc048fcc1672cbfaee41f08ea21adf3a4f9418d1af64c22cf5394
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logRelease files / patchright-1.64.2-py3-none-win32.whl
| Download URL | patchright-1.64.2-py3-none-win32.whl |
|---|---|
| Size | 38.8 MB |
| Tags | Python 3 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
cec5b2c2946ff662be63c1c6b94de8ec1bc96e3478cd512742e535357a995b53
|
|
BLAKE2b-256 checksum How to use checksums |
17f79e07f8d5e8afddefb426e868e9deb67526fa0880ddc99e38eabcae0193a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logRelease files / patchright-1.64.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | patchright-1.64.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 48.1 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
eec87f61800b2733182c4d1104c2344dd4df997bfb26ca3a80de5f8130619447
|
|
BLAKE2b-256 checksum How to use checksums |
545de5da55a16f40daca201ee7b0db277f6748bc084ca7d9aacbe37d711130d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logRelease files / patchright-1.64.2-py3-none-manylinux1_x86_64.whl
| Download URL | patchright-1.64.2-py3-none-manylinux1_x86_64.whl |
|---|---|
| Size | 48.5 MB |
| Tags | Linux glibc 2.5+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
808f97f4813772474e333d569337e30ef6bcf641e9fd98a25b49ac15d8770605
|
|
BLAKE2b-256 checksum How to use checksums |
1b760dd1fbe35c279e52d4e0e1414592381eb938a79345ea2dd008597259ac6a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logRelease files / patchright-1.64.2-py3-none-macosx_11_0_universal2.whl
| Download URL | patchright-1.64.2-py3-none-macosx_11_0_universal2.whl |
|---|---|
| Size | 44.5 MB |
| Tags | Python 3 macOS 11.0+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
7771a19f12656aa9a1f817475ae57f38c7b4fd6616d4c3fea89fdf60eac20c84
|
|
BLAKE2b-256 checksum How to use checksums |
57d3a505cd32ed5c73f1910deff202eb1bf66687f0bc095af03901d4d034ef16
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logRelease files / patchright-1.64.2-py3-none-macosx_11_0_arm64.whl
| Download URL | patchright-1.64.2-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 43.1 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c36a071c259f6e99f5b69ec5a2c4993ea3c274b04d324eed914e5937b0d7c218
|
|
BLAKE2b-256 checksum How to use checksums |
801ad03526d13eca26f057f55fd7f47a5495c9138e2883a0fa7cc30575338ca4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logRelease files / patchright-1.64.2-py3-none-macosx_10_13_x86_64.whl
| Download URL | patchright-1.64.2-py3-none-macosx_10_13_x86_64.whl |
|---|---|
| Size | 44.5 MB |
| Tags | Python 3 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
a1e3b1eebdaa3f66c472aba6d277f589c1f885ca7149a88c3e2e28a8982386f2
|
|
BLAKE2b-256 checksum How to use checksums |
f34f85a72d6ce8f49d7241d4d876880f7ac7595e90b49ad2c5f9d2d5a04fedfe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logSecurity for patchright 1.64.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 8 files in this release have been uploaded with provenance metadata.
Attestation for patchright-1.64.2-py3-none-win_arm64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
