Registry /
testing / geckodriver-autoinstaller
Install & Compatibility
Where this runs
tested against v0.1.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
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.112s · 17.8MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 1.5s · import 0.104s · 18MB
16MB installed
● package 16MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
geckodriver_autoinstaller
✓ import geckodriver_autoinstaller
The library is typically imported directly and then its 'install' method is called.
This quickstart demonstrates how to use `geckodriver-autoinstaller` to ensure the geckodriver executable is available and compatible with your Firefox browser, then initializes a Selenium Firefox WebDriver instance.
import geckodriver_autoinstaller
from selenium import webdriver
# Automatically install geckodriver
geckodriver_autoinstaller.install()
# Initialize Firefox WebDriver
driver = webdriver.Firefox()
# Example usage
driver.get("https://www.google.com")
print(f"Page title: {driver.title}")
driver.quit()
Debug
Known issues
deprecatedThis library (geckodriver-autoinstaller) has not been updated since February 2020 (version 0.1.0). A popular fork, `pyautogecko`, explicitly states that this project is 'no longer maintained'. It may not be compatible with recent versions of Firefox or Selenium, and critical bug fixes or security updates are unlikely.fixConsider using `webdriver_manager` (for `selenium` versions before 4.6) or relying on Selenium's built-in driver management (for `selenium` versions 4.6+) instead. If you prefer a similar autoinstaller, look into more actively maintained forks like `pyautogecko`.
affects: <=0.1.0
gotcha`geckodriver` is exclusively for Mozilla Firefox. This library will only manage the driver for Firefox and cannot be used for Chrome, Edge, or other browsers. The project description in some contexts might have mistakenly referred to Chrome, but the official PyPI and GitHub state Firefox.fixEnsure you are using `webdriver.Firefox()` from Selenium. For other browsers, use their respective driver management solutions (e.g., `chromedriver-autoinstaller` for Chrome, or `webdriver_manager` for multiple browsers, or Selenium's built-in manager).
affects: *
gotchaDue to its unmaintained status, this library's installed `geckodriver` version might become incompatible with newer Firefox browser releases or recent Selenium versions. This can lead to `SessionNotCreatedException` or similar runtime errors.fixManually verify the installed Firefox version and ensure the `geckodriver` installed by this library is compatible. If issues arise, consider alternative driver management solutions like `webdriver_manager`.
affects: 0.1.0 (with newer Firefox/Selenium)
gotchaEven with automatic installation, the `geckodriver` executable might not be correctly found in the system's PATH, or there could be permission denied errors, especially in Linux/macOS or CI/CD environments.fixAfter calling `geckodriver_autoinstaller.install()`, verify that the executable is indeed in a directory listed in your system's PATH. On Linux/macOS, check its executable permissions (`chmod +x`). In some cases, explicitly setting `webdriver.Firefox(service=Service(executable_path='/path/to/geckodriver'))` may be necessary, especially with newer Selenium versions.
affects: *
Errors
Common errors & fixes
WebDriverException: Message: 'geckodriver' executable needs to be in PATH
Although `geckodriver-autoinstaller` is designed to place geckodriver in the system's PATH, this error can still occur if the installation fails, the PATH isn't updated correctly, the system doesn't recognize the updated PATH in the current session, or the `install()` method is not explicitly called.
fixEnsure you have `import geckodriver_autoinstaller` and `geckodriver_autoinstaller.install()` in your code before initializing `webdriver.Firefox()`. If the issue persists, manually verify geckodriver's presence and add its directory to the system's PATH, or switch to a more actively maintained library like `webdriver-manager`.
RuntimeError: Failed to download geckodriver archive: <URL>
This error occurs because `geckodriver-autoinstaller` attempts to download the geckodriver executable from a specific URL that has become invalid or inaccessible, likely due to the library being unmaintained and not updated to reflect changes in Mozilla's geckodriver release infrastructure.
fixAs `geckodriver-autoinstaller` is unmaintained, this issue is unlikely to be resolved within the library. Manually download the correct `geckodriver` version from the official Mozilla GitHub releases page, place it in a known location, and either add that location to your system's PATH or specify its `executable_path` when creating the `webdriver.Firefox()` instance. Alternatively, consider using `webdriver-manager` which handles driver downloads and PATH management more robustly.
ValueError: Could not get version for Firefox with this command: firefox --version
`geckodriver-autoinstaller` relies on executing `firefox --version` to determine the installed Firefox browser's version for compatibility. This error indicates that the command failed, either because Firefox is not found in the system's PATH, is named differently (e.g., `firefox-bin`), or there are insufficient permissions to execute it.
fixEnsure Mozilla Firefox is correctly installed and its executable is discoverable via your system's PATH. If Firefox is installed in a non-standard location or has a custom executable name, you might need to manually set the `firefox_binary` option when initializing the Selenium WebDriver, or use `webdriver-manager` for more resilient version detection.
The geckodriver version (...) might not be compatible with the detected firefox version (...)
Despite `geckodriver-autoinstaller`'s purpose, its unmaintained status (last release 2020) means it may download an older `geckodriver` that is incompatible with newer, automatically updated versions of Firefox, leading to version mismatch warnings or functional failures during Selenium test execution.
fixManually check your installed Firefox browser version and download the corresponding compatible `geckodriver` from the official Mozilla GitHub releases page. Place the downloaded `geckodriver` executable in your system's PATH or explicitly provide its path to `webdriver.Firefox(executable_path='path/to/geckodriver')`. For a long-term solution, migrate to `webdriver-manager`, which continuously updates its driver mappings.
Upgrade
Version history
0.1.0latest on PyPI · released Feb 14, 2020
Audit
Dependencies
seleniumrequiredThis library is designed to be used in conjunction with Selenium WebDriver for Firefox automation.