An alternative to FlareSolverr as a drop-in replacement, built with seleniumbase and FastAPI.
Important
This software does not guarantee (only greatly increases the chance) that any challenge will be bypassed. While this tool passes the initial browser check, Cloudflare and other captcha providers likely require valid network traffic originating from the user’s public IP address to mark a connection as legitimate. If any website does not pass the challenge, please run troubleshooting steps and check if other websites work before you create an GitHub issue.
Important
Support for NAS devices (like Synology) is minimal. Please report issues, but do not expect it to be fixed quickly. The only ARM device I have is a free Ampere Oracle VM, so I can only test ARM support on that. See #22 and #3
Note
Thanks to FastAPI implementation, now you can also see the API documentation at /docs or / (redirect to /docs) endpoints.
- Clone repo to the host that has issues with Byparr.
- Run
docker build --target test . - Depending of the build success:
- If run successfully, try updating container or if already on newest stable release create an issue for creating new release with new dependencies
- If build fails, try troubleshooting on another host/using other method
- Download uv
- Download dependencies using
uv sync --group test - Run tests with
uv run pytest --retries 3(You can add-n autofor parallelization) - If you see any
Fcharacter in terminal, that means test failed even after retries. - Depending of the test success:
- If run successfully, try updating container or if already on newest stable release create an issue for creating new release with new dependencies
- If test fails, try troubleshooting on another host/using other method
| Environment Variable | Default | Description |
|---|---|---|
USE_XVFB |
SeleniumBase default |
Use virtual desktop with Xvfb. (Linux only) (Can cause performance hog #14) |
USE_HEADLESS |
SeleniumBase default |
Use headless chromium. |
PROXY |
None | Proxy to use in format: protocol://username:password@host:port. SOCKS5 with authentication is not supported by Chrome, see compose.yaml file for a workaround |
Recently I've partnered with a new in town proxy service - ProxyBase - to offer affordable proxy services that seems to work seamlessly with Byparr! Using my affiliate code byparr (case sensitive!) when signing up will not only get you access to their cost-effective ($0.69/GB with occasional promotions) proxy network but will also help support the continued development of this project. ProxyBase's proxies can significantly improve your success rate when bypassing anti-bot challenges. Check out ProxyBase and enhance your Byparr experience! Just remember that it uses socks5 protocol, so check Options section for more details.
v*.*.*/latest- Releases considered stablemain- Latest release from main branch (untested)
See compose.yaml
docker run -p 8191:8191 ghcr.io/thephaseless/byparr:latestuv sync && uv run main.py- Slimming container (only ~650 MB now!)
- Add more anti-bot challenges
- Add doc strings
- Implement versioning
- Proxy support
- Add more architectures support