{"id":5876,"library":"chromedriver-autoinstaller","title":"Chromedriver Autoinstaller","description":"chromedriver-autoinstaller is a Python library that automatically downloads and installs the appropriate Chromedriver executable for the currently installed version of Google Chrome on your system. It supports Linux, MacOS, and Windows operating systems. The current version is 0.6.4 and the library is actively maintained, with a recent release in January 2024.","status":"active","version":"0.6.4","language":"en","source_language":"en","source_url":"https://github.com/yeongbin-jo/python-chromedriver-autoinstaller","tags":["selenium","webdriver","chrome","automation","driver","autoinstaller"],"install":[{"cmd":"pip install chromedriver-autoinstaller","lang":"bash","label":"Install stable version"}],"dependencies":[{"reason":"Commonly used with this library to automate Chrome, though not a direct dependency for the installer itself.","package":"selenium","optional":false}],"imports":[{"note":"The `install()` method directly handles the download and setup of the ChromeDriver.","symbol":"install","correct":"import chromedriver_autoinstaller\nchromedriver_autoinstaller.install()"}],"quickstart":{"code":"import chromedriver_autoinstaller\nfrom selenium import webdriver\nfrom selenium.webdriver.chrome.options import Options\nimport os\n\n# Ensure chromedriver is installed and up-to-date\nchromedriver_autoinstaller.install()\n\n# Set up Chrome options (e.g., headless mode for automation)\nchrome_options = Options()\n# chrome_options.add_argument('--headless') # Uncomment for headless browsing\n# chrome_options.add_argument('--no-sandbox') # Recommended for Linux environments, especially in CI/CD\n\n# Initialize the WebDriver\ndriver = webdriver.Chrome(options=chrome_options)\n\n# Navigate to a website\ndriver.get(\"https://www.google.com\")\n\n# Print the page title to verify\nprint(f\"Page title: {driver.title}\")\n\n# Close the browser\ndriver.quit()","lang":"python","description":"This quickstart demonstrates how to use `chromedriver-autoinstaller` to ensure the correct Chromedriver is available, then initializes a Selenium WebDriver for Chrome, navigates to Google, prints the page title, and quits."},"warnings":[{"fix":"Update to `chromedriver-autoinstaller` version `0.6.2` or newer. These versions implement the updated driver location logic.","message":"Chrome v115+ introduced a new driver restructuring (Chrome-for-Testing), which broke older versions of `chromedriver-autoinstaller`'s ability to locate and download the correct driver.","severity":"breaking","affected_versions":"<0.6.2"},{"fix":"Configure your environment to run Chrome as a regular user instead. If absolutely necessary (e.g., in some containerized environments), `ChromeOptions().add_argument('--no-sandbox')` can be used, but this is an unsupported and potentially risky workaround.","message":"Running Chrome or ChromeDriver as the root user (administrator) on Linux is highly discouraged and can cause Chrome to crash, often resulting in 'DevToolsActivePort file doesn't exist' errors.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure all necessary Python runtime and SSL DLLs are explicitly included in your application's build process or environment setup for bundled applications.","message":"When bundling applications with tools like `cx_Freeze` or PyInstaller, missing SSL-related DLLs (e.g., `libcrypto-1_1-x64.dll`, `libssl-1_1-x64.dll` on Windows) can prevent `chromedriver-autoinstaller` from downloading files, leading to SSL errors during installation.","severity":"gotcha","affected_versions":"All versions when bundled"},{"fix":"Always confirm the exact package name `chromedriver-autoinstaller` when installing to ensure you are using the intended library.","message":"Be careful with package naming. The correct package name for this library is `chromedriver-autoinstaller`. Other similar-sounding packages like `chromedriver-autoinstall` or `chromedriver-autoinstaller-fix` exist on PyPI and may offer different functionality, bug fixes, or maintenance levels.","severity":"gotcha","affected_versions":"All versions (user error)"}],"env_vars":null,"last_verified":"2026-04-14T00:00:00.000Z","next_check":"2026-07-13T00:00:00.000Z"}