chromedriver-py

148.0.7778.56 verified Mon Apr 27 auth: no python

A simple Python package that automatically downloads and manages the correct ChromeDriver binary for your platform, enabling Selenium WebDriver to control Chrome. Version 148.0.7778.56 is current; the package mirrors ChromeDriver releases and is updated frequently.

pip install chromedriver-py

Common errors

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

cause The chromedriver binary is not in the system PATH or the path is not correctly specified.

fix

Use chromedriver_path from chromedriver_py as shown in quickstart, or add the binary location to PATH.

error AttributeError: module 'chromedriver_py' has no attribute 'chromedriver' ↓

cause Importing the wrong attribute from the package.

fix

Use 'from chromedriver_py import chromedriver_path' instead of 'from chromedriver_py import chromedriver'.

error ValueError: This version of ChromeDriver only supports Chrome version 148 ↓

cause Chrome browser version does not match the ChromeDriver version installed.

fix

Update Chrome to version 148 or install a compatible chromedriver-py version (e.g., pip install chromedriver-py==114.0.5735.90 for Chrome 114).

Warnings

breaking In Selenium 4.x, the 'executable_path' parameter is deprecated; use 'Service' instead. ↓

fix from selenium.webdriver.chrome.service import Service from chromedriver_py import chromedriver_path service = Service(executable_path=chromedriver_path) driver = webdriver.Chrome(service=service)

gotcha The chromedriver binary path may change between package versions; always re-install to get the latest binary. ↓

fix pip install --upgrade chromedriver-py

gotcha Ensure Chrome browser is installed and matches the ChromeDriver major version; mismatches cause session errors. ↓

fix Check Chrome version via chrome://settings/help, then install matching chromedriver-py version (e.g., 114.x for Chrome 114).

Imports

chromedriver_path
wrong
```
from chromedriver_py import chromedriver
```
correct
```
from chromedriver_py import chromedriver_path
```
'chromedriver' is not exported; use 'chromedriver_path' for the binary path

Quickstart

Basic Selenium script using chromedriver-py to automatically locate the ChromeDriver binary.

from selenium import webdriver
from chromedriver_py import chromedriver_path

driver = webdriver.Chrome(executable_path=chromedriver_path)
driver.get('https://www.google.com')
print(driver.title)
driver.quit()