# Botright v0.5.1
[](https://pypi.org/project/selenium-driverless/)
[](https://pepy.tech/project/botright)
## Install it from PyPI
```bash
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!
```py
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](https://github.com/Vinyzu/Botright/blob/main/docs/index.rst)
---
## 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](https://ungoogled-software.github.io/ungoogled-chromium-binaries/).
Furthermore, it uses self-scraped [chrome-fingerprints](https://github.com/Vinyzu/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](https://nopecha.com/demo/recaptcha#v3) | ✔️ | 0.9 |
| => [recaptcha-demo.appspot.com](https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php) | ✔️ | 0.9 |
| => [berstend.github.io](https://berstend.github.io/static/recaptcha/v3-programmatic.html) | ✔️ | 0.9 |
| => [antcpt.com](https://antcpt.com/score_detector/) | ❌❓ | 0.1 (Detects Legitimate Browsers as Bad) |
| [**CreepJS**](https://abrahamjuliot.github.io/creepjs/) | ✔️ | ~65.5% (With Canvas Manipulation 52%) |
| **DataDome** | ✔️ | |
| => [antoinevastel.com](https://antoinevastel.com/bots/datadome) | ✔️ | |
| => [datadome.co](https://datadome.co/bot-tester/) | ✔️ | |
| **Imperva** | ✔️❓ | (Cant find approved Testing Sites) |
| => [ticketmaster.es](https://www.ticketmaster.es/) | ✔️ | |
| **Cloudflare** | ✔️ | |
| => [Turnstile](https://nopecha.com/demo/turnstile) | ✔️ | (Using Undetected-Playwright-Python) |
| => [Interstitial](https://nopecha.com/demo/cloudflare) | ✔️ | (Using Undetected-Playwright-Python) |
| [**SannySoft**](https://bot.sannysoft.com/) | ✔️ | |
| [**Incolumitas**](https://bot.incolumitas.com/) | ✔️ | 0.8-1.0 |
| [**Fingerprint.com**](https://fingerprint.com/products/bot-detection/) | ✔️ | |
| [**IpHey**](https://iphey.com/) | ✔️ | |
| [**BrowserScan**](https://browserscan.net/) | ✔️ | |
| [**PixelScan**](https://pixelscan.net/) | ❓ | (Platform Test Outdated & Maybe caused by WebGL-disabling) |
| [**Bet365**](https://www.bet365.com/#/AC/B1/C1/D1002/E79147586/G40/) | ✔️ | 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](https://github.com/Vinyzu/Botright/blob/main/docs/botright.rst).
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](https://github.com/Vinyzu/Botright/blob/main/docs/CONTRIBUTING.md) file.
---
## Copyright and License
© [Vinyzu](https://github.com/Vinyzu/)
[GNU GPL](https://choosealicense.com/licenses/gpl-3.0/)
(Commercial Usage is allowed, but source, license and copyright has to made available. Botright does not provide and Liability or Warranty)
---
## Thanks to
[Kaliiiiiiiiii](https://github.com/kaliiiiiiiiii/) (For shared knowledge of Anti-Browser-Detection Measures)
[Kaliiiiiiiiii](https://github.com/kaliiiiiiiiii/) (For Main-Authoring [Undetected-Playwright](https://github.com/kaliiiiiiiiii/undetected-playwright-python) (Co-Authored by me) )
[QIN2DIM](https://github.com/QIN2DIM/) (For his great AI work)
[MaxAndolini](https://github.com/MaxAndolini) (For shared knowledge of hCaptcha bypassing)
[CreativeProxies](https://creativeproxies.com) (For sponsoring me with Proxies)
---
[](https://discordapp.com/users/935224495126487150)
[](https://ko-fi.com/vinyzu)
Raw data
{
"_id": null,
"home_page": "https://github.com/Vinyzu/Botright",
"name": "botright",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "botright,playwright,browser,automation,recaptcha_challenger,recaptcha-solver,hcaptcha_challenger,hcaptcha-solver,geetest_challenger,geetest-solver",
"author": "Vinyzu",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/14/bd/cd61d5b402a29b6b9333fca5ed57cd5b8fd5d6dc0da89707cf1ae74ee0b4/botright-0.5.1.tar.gz",
"platform": null,
"description": "# Botright v0.5.1\r\n\r\n[](https://pypi.org/project/selenium-driverless/)\r\n[](https://pepy.tech/project/botright)\r\n\r\n## Install it from PyPI\r\n\r\n```bash\r\npip install botright\r\nplaywright install\r\n```\r\n\r\n---\r\n\r\n## Usage\r\n\r\n### Botright is currently only available in async mode.\r\n### It is fully plugable with your existing playwright code. You only have to change your browser initialization!\r\n\r\n```py\r\nimport asyncio\r\n\r\nimport botright\r\n\r\n\r\nasync def main():\r\n botright_client = await botright.Botright()\r\n browser = await botright_client.new_browser()\r\n page = await browser.new_page()\r\n\r\n # Continue by using the Page\r\n await page.goto(\"https://google.com\")\r\n\r\n await botright_client.close()\r\n\r\n\r\nif __name__ == \"__main__\":\r\n asyncio.run(main())\r\n```\r\n\r\nRead the [Documentation](https://github.com/Vinyzu/Botright/blob/main/docs/index.rst)\r\n\r\n---\r\n\r\n## Browser Stealth\r\n\r\nBotright uses a vast amount of techniques to hide its functionality as a bot from websites.\r\nTo enhance stealth, since Version 0.3, it uses a real Chromium-based browser from the local machine to start up a botted browser.\r\nFor best stealth, you want to install [Ungoogled Chromium](https://ungoogled-software.github.io/ungoogled-chromium-binaries/).\r\n\r\nFurthermore, it uses self-scraped [chrome-fingerprints](https://github.com/Vinyzu/chrome-fingerprints) to build up a fake browser fingerprint and to deceive website into thinking it is legit.\r\n\r\n\r\n| Test | Status | Score |\r\n|-----------------------------------------------------------------------------------------------------|--------|------------------------------------------------------------|\r\n| **reCaptcha Score** | \u2714\ufe0f | 0.9 |\r\n| => [nopecha.com](https://nopecha.com/demo/recaptcha#v3) | \u2714\ufe0f | 0.9 |\r\n| => [recaptcha-demo.appspot.com](https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php) | \u2714\ufe0f | 0.9 |\r\n| => [berstend.github.io](https://berstend.github.io/static/recaptcha/v3-programmatic.html) | \u2714\ufe0f | 0.9 |\r\n| => [antcpt.com](https://antcpt.com/score_detector/) | \u274c\u2753 | 0.1 (Detects Legitimate Browsers as Bad) |\r\n| [**CreepJS**](https://abrahamjuliot.github.io/creepjs/) | \u2714\ufe0f | ~65.5% (With Canvas Manipulation 52%) |\r\n| **DataDome** | \u2714\ufe0f | |\r\n| => [antoinevastel.com](https://antoinevastel.com/bots/datadome) | \u2714\ufe0f | |\r\n| => [datadome.co](https://datadome.co/bot-tester/) | \u2714\ufe0f | |\r\n| **Imperva** | \u2714\ufe0f\u2753 | (Cant find approved Testing Sites) |\r\n| => [ticketmaster.es](https://www.ticketmaster.es/) | \u2714\ufe0f | |\r\n| **Cloudflare** | \u2714\ufe0f | |\r\n| => [Turnstile](https://nopecha.com/demo/turnstile) | \u2714\ufe0f | (Using Undetected-Playwright-Python) |\r\n| => [Interstitial](https://nopecha.com/demo/cloudflare) | \u2714\ufe0f | (Using Undetected-Playwright-Python) |\r\n| [**SannySoft**](https://bot.sannysoft.com/) | \u2714\ufe0f | |\r\n| [**Incolumitas**](https://bot.incolumitas.com/) | \u2714\ufe0f | 0.8-1.0 |\r\n| [**Fingerprint.com**](https://fingerprint.com/products/bot-detection/) | \u2714\ufe0f | |\r\n| [**IpHey**](https://iphey.com/) | \u2714\ufe0f | |\r\n| [**BrowserScan**](https://browserscan.net/) | \u2714\ufe0f | |\r\n| [**PixelScan**](https://pixelscan.net/) | \u2753 | (Platform Test Outdated & Maybe caused by WebGL-disabling) |\r\n| [**Bet365**](https://www.bet365.com/#/AC/B1/C1/D1002/E79147586/G40/) | \u2714\ufe0f | Currently only using `mask_fingerprint=False` |\r\n\r\n\r\n---\r\n\r\n## Captcha Solving\r\n\r\nBotright is able to solve a wide viarity of Captchas.\r\nFor Documentation of these functions visit [BotrightDocumentation](https://github.com/Vinyzu/Botright/blob/main/docs/botright.rst).\r\n\r\nIt uses Computer Vision/Artificial Intelligence and other Methods to solve these Captchas.\r\n\r\nYou dont need to pay for any Captcha Solving APIs and you can solve Captchas with just one simple function call.\r\n\r\nHere all Captchas supported as of now:\r\n\r\n| Captcha Type | Supported | Solved By | Success Rate |\r\n|:------------------------------------:|:---------:|:-------------------------------:|--------------|\r\n| `hCaptcha` | \u2714\ufe0f | hcaptcha-challenger | up to 90% |\r\n| `reCaptcha` | \u2714\ufe0f | reCognizer | 50%-80% |\r\n| `geeTestv3` Currently Not Available! |\r\n| v3 Intelligent Mode | \u2714\ufe0f | botrights stealthiness | 100% |\r\n| v3 Slider Captcha | \u2714\ufe0f | cv2.matchTemplate | 100% |\r\n| v3 Nine Captcha | \u2714\ufe0f | CLIP Detection | 50% |\r\n| v3 Icon Captcha | \u2714\ufe0f | cv2.matchTemplate / SSIM / CLIP | 70% |\r\n| v3 Space Captcha | \u274c | Not solvable | 0% |\r\n| `geeTestv4` Currently Not Available! |\r\n| v4 Intelligent Mode | \u2714\ufe0f | botrights stealthiness | 100% |\r\n| v4 Slider Captcha | \u2714\ufe0f | cv2.matchTemplate | 100% |\r\n| v4 GoBang Captcha | \u2714\ufe0f | Math Calculations | 100% |\r\n| v4 Icon Captcha | \u2714\ufe0f | cv2.matchTemplate / SSIM / CLIP | 60% |\r\n| v4 IconCrush Captcha | \u2714\ufe0f | Math Calculations | 100% |\r\n\r\n## Development\r\n\r\nRead the [CONTRIBUTING.md](https://github.com/Vinyzu/Botright/blob/main/docs/CONTRIBUTING.md) file.\r\n\r\n---\r\n\r\n## Copyright and License\r\n\u00a9 [Vinyzu](https://github.com/Vinyzu/)\r\n\r\n[GNU GPL](https://choosealicense.com/licenses/gpl-3.0/)\r\n\r\n(Commercial Usage is allowed, but source, license and copyright has to made available. Botright does not provide and Liability or Warranty)\r\n\r\n---\r\n\r\n## Thanks to\r\n\r\n[Kaliiiiiiiiii](https://github.com/kaliiiiiiiiii/) (For shared knowledge of Anti-Browser-Detection Measures)\r\n\r\n[Kaliiiiiiiiii](https://github.com/kaliiiiiiiiii/) (For Main-Authoring [Undetected-Playwright](https://github.com/kaliiiiiiiiii/undetected-playwright-python) (Co-Authored by me) )\r\n\r\n[QIN2DIM](https://github.com/QIN2DIM/) (For his great AI work)\r\n\r\n[MaxAndolini](https://github.com/MaxAndolini) (For shared knowledge of hCaptcha bypassing)\r\n\r\n[CreativeProxies](https://creativeproxies.com) (For sponsoring me with Proxies)\r\n\r\n---\r\n\r\n\r\n\r\n\r\n\r\n[](https://discordapp.com/users/935224495126487150)\r\n[](https://ko-fi.com/vinyzu)\r\n",
"bugtrack_url": null,
"license": "GNU General Public License v3.0",
"summary": "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.",
"version": "0.5.1",
"project_urls": {
"Documentation": "https://github.com/Vinyzu/Botright/blob/main/docs/index.rst",
"Homepage": "https://github.com/Vinyzu/Botright",
"Source": "https://github.com/Vinyzu/Botright",
"Tracker": "https://github.com/Vinyzu/Botright/issues"
},
"split_keywords": [
"botright",
"playwright",
"browser",
"automation",
"recaptcha_challenger",
"recaptcha-solver",
"hcaptcha_challenger",
"hcaptcha-solver",
"geetest_challenger",
"geetest-solver"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8c7bb2bafe94feb18520628c4d84a1076bd4dd6d46e3b4be2065f2b1cda27c2c",
"md5": "de54904b4f75c5f4253839fbbab158f3",
"sha256": "4817f34551d7f591e11ea26bc1ebe85298fbbc73d104ca9059302ff976e6f833"
},
"downloads": -1,
"filename": "botright-0.5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "de54904b4f75c5f4253839fbbab158f3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 56615,
"upload_time": "2024-02-15T16:25:27",
"upload_time_iso_8601": "2024-02-15T16:25:27.315164Z",
"url": "https://files.pythonhosted.org/packages/8c/7b/b2bafe94feb18520628c4d84a1076bd4dd6d46e3b4be2065f2b1cda27c2c/botright-0.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "14bdcd61d5b402a29b6b9333fca5ed57cd5b8fd5d6dc0da89707cf1ae74ee0b4",
"md5": "725439f11875d04d98bbfd3b71d10a05",
"sha256": "5b174100eb6a56b35085385b8aa22e9bfb141554cc1146081033ca0404a13a9c"
},
"downloads": -1,
"filename": "botright-0.5.1.tar.gz",
"has_sig": false,
"md5_digest": "725439f11875d04d98bbfd3b71d10a05",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 53249,
"upload_time": "2024-02-15T16:25:29",
"upload_time_iso_8601": "2024-02-15T16:25:29.475469Z",
"url": "https://files.pythonhosted.org/packages/14/bd/cd61d5b402a29b6b9333fca5ed57cd5b8fd5d6dc0da89707cf1ae74ee0b4/botright-0.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-15 16:25:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Vinyzu",
"github_project": "Botright",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "botright"
}
JSON
