pydoll-python

What it is and what it does

Pydoll is a Python library for automating Chromium browsers by connecting directly to the Chrome DevTools Protocol over WebSocket, eliminating the need for a WebDriver binary or the `navigator.webdriver` flag. It combines human-like interactions—Bezier-curve mouse movement, realistic typing, and scroll physics—with fingerprint injection that overrides User-Agent, Client Hints, navigator properties, WebGL, canvas, screen, fonts, timezone, and locale to present a consistent, non-bot identity. The library is built on asyncio and fully type-checked with mypy, offering clean async-native APIs for finding elements, clicking, typing, scrolling, intercepting network requests, and extracting structured data via Pydantic models.

The core use case is web scraping and automation that needs to bypass bot-detection systems like Cloudflare Turnstile or reCAPTCHA v3. It supports shadow DOM and cross-origin iframes, network request interception and monitoring, and authenticated HTTP requests that inherit the browser session. The maintainer notes the project is active but moving at a calmer pace as a single-person effort; Firefox support is planned once the project reaches 10k GitHub stars.

Use it for:

• Scrape sites protected by Cloudflare Turnstile or reCAPTCHA v3 by automating realistic user interactions and spoofing a consistent browser fingerprint.
• Monitor competitor pricing or content changes on bot-protected websites without triggering detection systems.
• Test web applications' anti-bot defenses and behavioral challenges in a controlled, headless environment.
• Intercept and analyze network traffic during automation to discover undocumented APIs or track third-party requests.
• Extract structured data from dynamic pages using Pydantic models for automatic validation and type safety.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Pydoll automates Chromium-based browsers via the Chrome DevTools Protocol without a WebDriver binary, using human-like interactions and fingerprint injection to evade bot detection.

Yes, if you need browser automation that evades bot detection and can tolerate a single-maintainer project with slower response times. The low install friction, active status, and zero known vulnerabilities make it safe to try. However, verify the license terms first (currently unclear in metadata), and confirm that fingerprint injection and human-like interactions actually work against your target sites—detection evasion success depends on your specific use case and the site's defenses.

Install

pydoll-python on PyPI

pip install pydoll-python

uv add pydoll-python

poetry add pydoll-python

Installing pydoll-python

Before you install

Low install friction with five async-first runtime dependencies (aiofiles, aiohttp, pydantic, typing_extensions, websockets). Active maintenance with a release 1 day old. Single-maintainer project currently moving at a calmer pace, so response times may be longer than typical.

License in practice

License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before use in proprietary or commercial projects.

Quickstart

import asyncio
from pydoll.browser import Chrome

async def automate():
    async with Chrome() as browser:
        tab = await browser.start()
        await tab.go_to('https://example.com')
        element = await tab.find(tag_name='input')
        await element.type_text('query', humanize=True)

asyncio.run(automate())

Requires Python 3.10 or later and a local Chromium installation; async/await syntax is mandatory.

Verify before relying

• Whether the package works with Chromium versions other than the latest, or if version-matching is required.
• Actual detection evasion success rates against current Cloudflare Turnstile and reCAPTCHA v3 implementations in real-world scenarios.
• Whether Firefox support is planned or confirmed for a future release.
• Performance and memory overhead compared to traditional WebDriver-based automation.

Package facts

Evidence: pydoll_python-2.24.0-py3-none-any.whl

Tags

More Dynamic Content packages

Further reading