🎭 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.

NodeMaven Banner

NodeMaven: Your reliable proxy provider with High Quality IPs.
Superb solution for automation, web scraping, SEO research, and social media management.

Why NodeMaven?

✅ 99.9% Uptime
🎯 Sticky sessions up to 7 days
🔍 IP Filtering: Proxies are guaranteed to have fraud score <97%
🔰 No KYC required
💸 Cashback on Traffic - Burn GB and earn up to 10% back

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.

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

Uploaded Python 3Windows ARM64

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

Uploaded Python 3Windows x86-64

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

Uploaded Python 3Windows x86

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

Uploaded Python 3manylinux: glibc 2.17+ ARM64

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

Uploaded Python 3

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

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

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

Uploaded Python 3macOS 11.0+ ARM64

patchright-1.62.1-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.1-py3-none-win_arm64.whl.

File metadata

  • Download URL: patchright-1.62.1-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.1-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 60e1e4cb56905a84597c83fe458bed3406092c3fa170138170ed175b8ce5fae2
MD5 f2f17f896ca8521379e791c4e67fe200
BLAKE2b-256 e95564867b8a201dfb314ccfa5d94667ee851dc6eaaf87b44b1e47eababda313

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: patchright-1.62.1-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.1-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 ad8a13859e775f6204b786785f8ccc1de60ea078c45485834025c827761dba2e
MD5 d74d7ea88544a171314e9f7538aba78f
BLAKE2b-256 84d853680cf0313fc3d0c4fb028c39c9c752241eea03c7d3ada0837b144a7ada

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: patchright-1.62.1-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.1-py3-none-win32.whl
Algorithm Hash digest
SHA256 85fa54f292412f0e184fd38d991224cc7209d826a310b74ac947966db9a2dc4e
MD5 7dd011921a816dd431af24880eeae221
BLAKE2b-256 707b196310c6b82ca0047a86da4733c127b8f20611e63a057be521dc29ab9ab5

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.62.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 8f1e63d5099f586ddd4b6af56d624c72b0b561c6cf85e8a473d8d7bb962b0f54
MD5 5ff3d05b66c40cdf3e049b2309621fbe
BLAKE2b-256 9db9d27d47400b9b77bf8600fd71f68049d4f1f838e297595f1af0111d22f9e0

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.62.1-py3-none-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 ae908d0a69885f344bc36404a02bbfd772fc64c281f9bb77957dbc51be395592
MD5 0cefb6bf961482dff2532f9363d8fb4a
BLAKE2b-256 f9947b367bd063fe665461758402b7bb1560ce686d116536ca0e5d8445e9bea4

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.62.1-py3-none-macosx_11_0_universal2.whl
Algorithm Hash digest
SHA256 699b5c7d8c671ca6d807817fc3debdecfe518dab504e595dc203e65723a0899f
MD5 e2e8173f85f79920e5d8adcd3d1e7023
BLAKE2b-256 b6e482cd1d55045ca56d105dcfa6a44aed84974d84978396cb4c5f2b9cd5ff6c

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.62.1-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c826cadbca1298cdcf6641a51c5e9d74fe5a11139f3569a2bed37471ac36cbbf
MD5 3d5808cef2d7be740f077f6c860d4a67
BLAKE2b-256 503857c1bb35858238295c6c78cd7460ea16dd9f9215e57860a1cc37980cca5d

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.62.1-py3-none-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 b57fe7074bcd501f269bc80c57980b6895a26d3a765a1852df682f68d6ff4068
MD5 2df745faf2c812b69e0a4bd468c137bd
BLAKE2b-256 298b459c7bdafd2e9e6e87db9f2fad69c98ec46a26e5ecc5f7e86ea597478fde

See more details on using hashes here.

Provenance

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

Release history Release notifications | RSS feed

1.62.3

8 files

1.62.2

8 files

This release

1.62.1 This release

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