chromedriver-binary

149.0.7818.0.0 verified Fri May 01 auth: no python

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.

pip install chromedriver-binary

Common errors

error ModuleNotFoundError: No module named 'chromedriver_binary' ↓

cause 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.

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

cause Using deprecated attribute removed in v80+.

fix

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

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

cause 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.

Warnings

breaking chromedriver_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.

gotcha The 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.

deprecated Legacy 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`.

Imports

chromedriver_filename

wrong

from chromedriver_binary import chromedriver_path

correct

from chromedriver_binary import chromedriver_filename

Function renamed in v80+; old name removed.

add_chromedriver_to_path
```
import chromedriver_binary
```
Side-effect import adds chromedriver to PATH.

Quickstart

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()