Zendriver ✌️
This package is a fork of
ultrafunkamsterdam/nodriver, created to add new features, compile unmerged bugfixes, and increase community engagement.
- Documentation: zendriver.dev
- AI-generated wiki: deepwiki.com/cdpdriver/zendriver
Zendriver is a blazing fast, async-first, undetectable webscraping/web automation framework implemented using the Chrome Devtools Protocol. Visit websites, scrape content, and run JavaScript using a real browser (no Selenium/Webdriver) all with just a few lines of Python.
Docker support is here! Check out cdpdriver/zendriver-docker for an example of how to run Zendriver with a real, GPU-accelerated browser (not headless) in a Docker container. (Linux-only)
Features
- Undetectable - Zendriver uses the Chrome Devtools Protocol instead of Selenium/WebDriver, making it (almost) impossible to detect
- Blazing fast - Chrome Devtools Protocol is fast, much faster than previous Selenium/WebDriver solutions. CDP combined with an async Python API makes Zendriver highly performant.
- Feature complete and easy to use - Packed with allowing you to get up and running in just a few lines of code.
- First-class Docker support - Traditionally, browser automation has been incredibly difficult to package with Docker, especially if you want to run real, GPU-accelerated Chrome (not headless). Now, deploying with Docker is easier than ever using the officially supported zendriver-docker project template.
- Automatic cookie and profile management - By default, uses fresh profile on each run, cleaning up on exit. Or, save and load cookies to a file to avoid repeating tedious login steps.
- Smart element lookup - Find elements selector or text, including iframe content. This could also be used as wait condition for a element to appear, since it will retry for the duration of
timeoutuntil found. Single element lookup by text usingtab.find()accepts abest_match flag, which will not naively return the first match, but will match candidates by closest matching text length. - Easy debugging - Descriptive
reprfor elements, which represents the element as HTML, makes debugging much easier.
Installation
To install, simply use pip (or your favorite package manager):
pip install zendriver
# or uv add zendriver, poetry add zendriver, etc.
Usage
Example for visiting https://www.browserscan.net/bot-detection and saving a screenshot of the results:
import asyncio
import zendriver as zd
async def main():
browser = await zd.start()
page = await browser.get("https://www.browserscan.net/bot-detection")
await page.save_screenshot("browserscan.png")
await browser.stop()
if __name__ == "__main__":
asyncio.run(main())
Check out the Quickstart for more information and examples.
Rationale for the fork
Zendriver remains committed to nodriver's goals of staying undetected for all modern anti-bot solutions and also keeps with the batteries-included approach of its predecessor. Unfortunately, contributions to the original nodriver repo are heavily restricted, making it difficult to submit issues or pull requests. At the time of writing, there are several pull requests open to fix critical bugs which have beeen left unaddressed for many months.
Zendriver aims to change this by:
- Including open pull requests in the original
nodriverrepo as part of the initial release - Modernizing the development process to include static analysis tools such as
ruffandmypy, reducing the number of easy-to-catch bugs which make it through in the future - Opening up the issue tracker and pull requests for community contributions, allowing the project to continue to grow along with its community.
With these changes in place, we hope to further development of state-of-the-art open-source web automation tools even further, helping to once again make the web truly open for all.
Contributing
Contributions of all types are always welcome! Please see CONTRIBUTING.md for details on how to contribute.
Getting additional help
If you have a question, bug report, or want to make a general inquiry about the project, please create a new GitHub issue. If you are having a problem with Zendriver, please make sure to include your operating system, Chrome version, code example demonstrating the issue, and any other information that may be relevant.
Questions directed to any personal accounts outside of GitHub will be ignored.
1 maintainer
Metadata
1 maintainer
Release files for zendriver 0.17.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| zendriver-0.17.1.tar.gz | 476.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| zendriver-0.17.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 858.1 kB
Release files / zendriver-0.17.1.tar.gz
| Download URL | zendriver-0.17.1.tar.gz |
|---|---|
| Size | 476.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b9d5f79eea2dd116ec91badd5efb8193606e8c6a80635b963a2d5ac085ef186b
|
|
BLAKE2b-256 checksum How to use checksums |
8cd5257ecf353843fde1839cc72aa927a6c98e924cb89368f3026cf22be66235
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / zendriver-0.17.1-py3-none-any.whl
| Download URL | zendriver-0.17.1-py3-none-any.whl |
|---|---|
| Size | 381.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d857a36aee9df719f9f381d42e5589a5101e19569a2e77a9f2813fc08a10db3a
|
|
BLAKE2b-256 checksum How to use checksums |
bedfc037faf5ebad4410dcb343cce96af99695a54ca03ed9d1d8b64d4de90c75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
