---
id: pydoll-python
version: "2.24.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# pydoll-python — Pydoll is a library for automating chromium-based browsers without a WebDriver, offering realistic interactions.

License: unclear · Maintenance: active · Downloads: 76.4K/mo

## 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 above — 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

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

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 76.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

browser automation without webdriver, stealth web scraping python, anti-bot evasion automation, chrome devtools protocol python, fingerprint spoofing browser, humanlike mouse and typing, cloudflare turnstile bypass, web-scraping, bot-evasion, async-first

[View on SkillFed](https://skillfed.io/packages/pydoll-python) · [View on PyPI](https://pypi.org/project/pydoll-python/)