Skip to main content

Botright, the most advance undetected, fingerprint-changing, captcha-solving, open-source automation framework. Build on Playwright, its as easy to use as it is to extend your code. Solving your Captchas for free with AI.

Project description

Botright v0.5.1

Tests & Linting Downloads

Install it from PyPI

pip install botright
playwright install

Usage

Botright is currently only available in async mode.

It is fully plugable with your existing playwright code. You only have to change your browser initialization!

import asyncio

import botright


async def main():
    botright_client = await botright.Botright()
    browser = await botright_client.new_browser()
    page = await browser.new_page()

    # Continue by using the Page
    await page.goto("https://google.com")

    await botright_client.close()


if __name__ == "__main__":
    asyncio.run(main())

Read the Documentation


Browser Stealth

Botright uses a vast amount of techniques to hide its functionality as a bot from websites. To enhance stealth, since Version 0.3, it uses a real Chromium-based browser from the local machine to start up a botted browser. For best stealth, you want to install Ungoogled Chromium.

Furthermore, it uses self-scraped chrome-fingerprints to build up a fake browser fingerprint and to deceive website into thinking it is legit.

Test Status Score
reCaptcha Score ✔️ 0.9
=> nopecha.com ✔️ 0.9
=> recaptcha-demo.appspot.com ✔️ 0.9
=> berstend.github.io ✔️ 0.9
=> antcpt.com ❌❓ 0.1 (Detects Legitimate Browsers as Bad)
CreepJS ✔️ ~65.5% (With Canvas Manipulation 52%)
DataDome ✔️
=> antoinevastel.com ✔️
=> datadome.co ✔️
Imperva ✔️❓ (Cant find approved Testing Sites)
=> ticketmaster.es ✔️
Cloudflare ✔️
=> Turnstile ✔️ (Using Undetected-Playwright-Python)
=> Interstitial ✔️ (Using Undetected-Playwright-Python)
SannySoft ✔️
Incolumitas ✔️ 0.8-1.0
Fingerprint.com ✔️
IpHey ✔️
BrowserScan ✔️
PixelScan (Platform Test Outdated & Maybe caused by WebGL-disabling)
Bet365 ✔️ Currently only using mask_fingerprint=False

Captcha Solving

Botright is able to solve a wide viarity of Captchas. For Documentation of these functions visit BotrightDocumentation.

It uses Computer Vision/Artificial Intelligence and other Methods to solve these Captchas.

You dont need to pay for any Captcha Solving APIs and you can solve Captchas with just one simple function call.

Here all Captchas supported as of now:

Captcha Type Supported Solved By Success Rate
hCaptcha ✔️ hcaptcha-challenger up to 90%
reCaptcha ✔️ reCognizer 50%-80%
geeTestv3 Currently Not Available!
v3 Intelligent Mode ✔️ botrights stealthiness 100%
v3 Slider Captcha ✔️ cv2.matchTemplate 100%
v3 Nine Captcha ✔️ CLIP Detection 50%
v3 Icon Captcha ✔️ cv2.matchTemplate / SSIM / CLIP 70%
v3 Space Captcha Not solvable 0%
geeTestv4 Currently Not Available!
v4 Intelligent Mode ✔️ botrights stealthiness 100%
v4 Slider Captcha ✔️ cv2.matchTemplate 100%
v4 GoBang Captcha ✔️ Math Calculations 100%
v4 Icon Captcha ✔️ cv2.matchTemplate / SSIM / CLIP 60%
v4 IconCrush Captcha ✔️ Math Calculations 100%

Development

Read the CONTRIBUTING.md file.


Copyright and License

© Vinyzu

GNU GPL

(Commercial Usage is allowed, but source, license and copyright has to made available. Botright does not provide and Liability or Warranty)


Thanks to

Kaliiiiiiiiii (For shared knowledge of Anti-Browser-Detection Measures)

Kaliiiiiiiiii (For Main-Authoring Undetected-Playwright (Co-Authored by me) )

QIN2DIM (For his great AI work)

MaxAndolini (For shared knowledge of hCaptcha bypassing)

CreativeProxies (For sponsoring me with Proxies)


Version License Python

my-discord buy-me-a-coffee

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

botright-0.5.1.tar.gz (53.2 kB view details)

Uploaded Source

Built Distribution

botright-0.5.1-py3-none-any.whl (56.6 kB view details)

Uploaded Python 3

File details

Details for the file botright-0.5.1.tar.gz.

File metadata

  • Download URL: botright-0.5.1.tar.gz
  • Upload date:
  • Size: 53.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.1

File hashes

Hashes for botright-0.5.1.tar.gz
Algorithm Hash digest
SHA256 5b174100eb6a56b35085385b8aa22e9bfb141554cc1146081033ca0404a13a9c
MD5 725439f11875d04d98bbfd3b71d10a05
BLAKE2b-256 14bdcd61d5b402a29b6b9333fca5ed57cd5b8fd5d6dc0da89707cf1ae74ee0b4

See more details on using hashes here.

File details

Details for the file botright-0.5.1-py3-none-any.whl.

File metadata

  • Download URL: botright-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 56.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.1

File hashes

Hashes for botright-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4817f34551d7f591e11ea26bc1ebe85298fbbc73d104ca9059302ff976e6f833
MD5 de54904b4f75c5f4253839fbbab158f3
BLAKE2b-256 8c7bb2bafe94feb18520628c4d84a1076bd4dd6d46e3b4be2065f2b1cda27c2c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page