Registry / testing / chromedriver-binary

chromedriver-binary

library151.0.7897.3.0pypypi✓ verified 85d ago

Installs the chromedriver binary for Selenium/Playwright automation. Version 149.0.7818.0.0 corresponds to ChromeDriver matching Chrome 149. Released irregularly alongside ChromeDriver updates.

testing http-networking web-framework

pip install chromedriver-binary

github ↗package ↗

INSTALL

IMPORT

SIG · CHROMEDRIVER-BINAR

chromedriver-binary

testingpythonv151.0.7897.3.0

Install

5.1s avg

Import

114ms

Disk

38MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v151.0.7897.3.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.116s · 40.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 5.1s · import 0.112s · 41MB

38MB installed

● package 38MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

chromedriver_filename

✓ from chromedriver_binary import chromedriver_filename

✗ from chromedriver_binary import chromedriver_path

Function renamed in v80+; old name removed.

add_chromedriver_to_path

✓ import chromedriver_binary

Side-effect import adds chromedriver to PATH.

Import chromedriver_binary to automatically add chromedriver to PATH, then instantiate Selenium Chrome driver.

import chromedriver_binary from selenium import webdriver driver = webdriver.Chrome() driver.get('https://example.com') driver.quit()

chromedriver --version

Debug

Known issues

breakingchromedriver_binary.chromedriver_path was removed in version 80+. Use chromedriver_binary.chromedriver_filename or just import the module.

fix

Replace `chromedriver_path` with `chromedriver_filename` or rely on the side-effect import.

affects: >=80.0.0

gotchaThe package auto-downloads a chromedriver binary on install, but only for the host platform. Cross-platform builds (e.g., Docker multi-arch) may fail if the wrong binary is installed.

fix

Use platform-specific Docker base images or install chromedriver via system package manager in CI.

affects: all

deprecatedLegacy import `from chromedriver_binary import *` is discouraged; instead import the module itself or use `chromedriver_filename`.

fix

Use `import chromedriver_binary` or `from chromedriver_binary import chromedriver_filename`.

affects: <80.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'chromedriver_binary'

Package not installed or installed with wrong name (e.g., `chromedriver-binary` vs `chromedriver_binary`).

fix

Run `pip install chromedriver-binary` — note the hyphen in the package name.

AttributeError: module 'chromedriver_binary' has no attribute 'chromedriver_path'

Using deprecated attribute removed in v80+.

fix

Replace with `chromedriver_filename` or simply `import chromedriver_binary` without referencing the attribute.

selenium.common.exceptions.WebDriverException: Message: 'chromedriver' executable needs to be in PATH

chromedriver_binary was imported too late or not at all; PATH not updated.

fix

Ensure `import chromedriver_binary` is executed before any WebDriver instantiation. It performs PATH modification on import.

Upgrade

Version history

151.0.7897.3.0latest on PyPI · released Jun 18, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

20 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/danielkaiser/python-chromedriver-binary ↗

packagehttps://pypi.org/project/chromedriver-binary/ ↗