{"id":21035,"library":"chromedriver-py","title":"chromedriver-py","description":"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.","status":"active","version":"148.0.7778.56","language":"python","source_language":"en","source_url":"https://github.com/breuerfelix/chromedriver-py","tags":["selenium","chromedriver","webdriver","testing","browser automation"],"install":[{"cmd":"pip install chromedriver-py","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"Required for WebDriver functionality","package":"selenium","optional":false}],"imports":[{"note":"'chromedriver' is not exported; use 'chromedriver_path' for the binary path","wrong":"from chromedriver_py import chromedriver","symbol":"chromedriver_path","correct":"from chromedriver_py import chromedriver_path"}],"quickstart":{"code":"from selenium import webdriver\nfrom chromedriver_py import chromedriver_path\n\ndriver = webdriver.Chrome(executable_path=chromedriver_path)\ndriver.get('https://www.google.com')\nprint(driver.title)\ndriver.quit()","lang":"python","description":"Basic Selenium script using chromedriver-py to automatically locate the ChromeDriver binary."},"warnings":[{"fix":"from selenium.webdriver.chrome.service import Service\nfrom chromedriver_py import chromedriver_path\nservice = Service(executable_path=chromedriver_path)\ndriver = webdriver.Chrome(service=service)","message":"In Selenium 4.x, the 'executable_path' parameter is deprecated; use 'Service' instead.","severity":"breaking","affected_versions":"chromedriver-py >= 100; Selenium >= 4.0.0"},{"fix":"pip install --upgrade chromedriver-py","message":"The chromedriver binary path may change between package versions; always re-install to get the latest binary.","severity":"gotcha","affected_versions":"all"},{"fix":"Check Chrome version via chrome://settings/help, then install matching chromedriver-py version (e.g., 114.x for Chrome 114).","message":"Ensure Chrome browser is installed and matches the ChromeDriver major version; mismatches cause session errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use chromedriver_path from chromedriver_py as shown in quickstart, or add the binary location to PATH.","cause":"The chromedriver binary is not in the system PATH or the path is not correctly specified.","error":"selenium.common.exceptions.WebDriverException: Message: 'chromedriver' executable needs to be in PATH"},{"fix":"Use 'from chromedriver_py import chromedriver_path' instead of 'from chromedriver_py import chromedriver'.","cause":"Importing the wrong attribute from the package.","error":"AttributeError: module 'chromedriver_py' has no attribute 'chromedriver'"},{"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).","cause":"Chrome browser version does not match the ChromeDriver version installed.","error":"ValueError: This version of ChromeDriver only supports Chrome version 148"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}