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

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

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

Uploaded Python 3Windows ARM64

patchright-1.56.0-py3-none-win_amd64.whl (35.6 MB view details)

Uploaded Python 3Windows x86-64

patchright-1.56.0-py3-none-win32.whl (35.6 MB view details)

Uploaded Python 3Windows x86

patchright-1.56.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (46.1 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

patchright-1.56.0-py3-none-manylinux1_x86_64.whl (46.2 MB view details)

Uploaded Python 3

patchright-1.56.0-py3-none-macosx_11_0_universal2.whl (40.6 MB view details)

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

patchright-1.56.0-py3-none-macosx_11_0_arm64.whl (39.4 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

patchright-1.56.0-py3-none-macosx_10_13_x86_64.whl (40.6 MB view details)

Uploaded Python 3macOS 10.13+ x86-64

File details

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

File metadata

  • Download URL: patchright-1.56.0-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.56.0-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 8bbf1c753e7b07b889a3ff43109ce3cea457605ea6b0477e65af4d9a2c5585cf
MD5 4ada1491c14bb4ff5a80796e169693ed
BLAKE2b-256 c5370b79ddfc6a2ba16e9f258670ea40a74c791d925f1847cf4ad0e739bc7506

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: patchright-1.56.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 35.6 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.56.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 0fe85d8f6b541689185115f3ce69e87a7f5dd964ec6aaeac635d4db5a906aec1
MD5 c022064f9bed5361e43b9ffb0ccc1160
BLAKE2b-256 958d37cc3127c6085ffa6482832a07f84587f2f04dbbaf194cc395bb2afa811c

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: patchright-1.56.0-py3-none-win32.whl
  • Upload date:
  • Size: 35.6 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.56.0-py3-none-win32.whl
Algorithm Hash digest
SHA256 5502899cd8764ccc7a18c3cb47a76e49b25ec4eae155ec5ebea9e5e0022cc811
MD5 2f866309ad73c24bdcf943ad301377ce
BLAKE2b-256 114ba43f86570cb72f732723c19ba71f1c02200ed1cc762d71daa2c35718a529

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.56.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 02329457d4f9e92b49209adceec33097042b6a6f03de31185a2f99721aeded6a
MD5 d425921c1fdac8c001040e7d8de3c0ab
BLAKE2b-256 53b46546fb868f464c888cee8e95d5b0cc4e276afc5e531bc3ca737e2a910f77

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.56.0-py3-none-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 cef0f31334dece118fa8dbe20e0c0ac97ea539a2a3e7dd007a67d05b4c3e0512
MD5 aaefa639735b3e5fea7a0cea101054a1
BLAKE2b-256 e6ad17f72b906a1d3d9750b26964d4481340defbfc02f039c888756061f41a33

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.56.0-py3-none-macosx_11_0_universal2.whl
Algorithm Hash digest
SHA256 e939a9651ebad6ed5afb84e6cf8b874fd80e4b03a912509dc5159f0fa2d4a752
MD5 fa419c5c0c0438072e22f42c5500ea35
BLAKE2b-256 5f49510b8fb761a7e6a2cbd8381f2254fd9442055e27961c0565944d5634ccb6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.56.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e0d8e86d743f4da99f83e9962f9317bd3aaabe4e9db86d3e12cb1d0f39e2f469
MD5 8bc0e31f19c80bb156e248e9b079f90b
BLAKE2b-256 a8f2e33cd3e6916ed959f5b9be1182363e19771be81541a77b2c5615a6434cc8

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for patchright-1.56.0-py3-none-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 9df1e0b2c35a298ad2807044699476d3e872f76117c319077b68d7b8ac8bffae
MD5 a8e96f708f641fcde6674f1a69839cf0
BLAKE2b-256 0dd6ac03353f1b3138541356a044c2d7d3e01b73f9555c7281dab3423c5d44da

See more details on using hashes here.

Provenance

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