Install & Compatibility
Where this runs
tested against v1.0.3 · 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
py 3.10
✕ build_error
✓ 2.1s
py 3.11
✕ build_error
✓ 2.1s
py 3.12
✕ build_error
✓ 1.7s
py 3.13
✕ build_error
✓ 1.8s
py 3.9
✕ build_error
✕ build_error
19MB installed
● package 19MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
geckordp
✓ import geckordp
Top-level module; no submodule needed for basic launch.
GeckoDriver
✓ from geckordp.rdp_client import GeckoDriver
✗ from geckordp import GeckoDriver
GeckoDriver is in the rdp_client module, not top-level.
FirefoxProfile
✓ from geckordp.profile import FirefoxProfile
Used for custom profile settings.
Basic launch and stop of Firefox with custom profile. Ensure Firefox binary is in PATH.
import geckordp
from geckordp.rdp_client import GeckoDriver
from geckordp.profile import FirefoxProfile
profile = FirefoxProfile()
profile.set_preference('xpinstall.signatures.required', False)
driver = GeckoDriver(profile=profile)
driver.start()
print('Firefox launched with remote debugging on port', driver.port)
driver.stop()
Errors
Common errors & fixes
FileNotFoundError: [Errno 2] No such file or directory: 'firefox'
Firefox is not installed or not in PATH.
fixInstall Firefox and ensure the binary is accessible. On Ubuntu: 'sudo apt install firefox'. On macOS: place in /Applications/Firefox.app/Contents/MacOS/firefox or symlink.
OSError: [Errno 98] Address already in use
Default port (9222) is taken by another Firefox or geckordp instance.
fixSpecify a custom port: driver = GeckoDriver(port=9223). Also kill leftover Firefox processes.
Upgrade
Version history
1.0.3latest on PyPI · released Sep 3, 2024
Audit
Dependencies
firefoxrequiredBrowser binary required; geckordp launches Firefox with remote debugging enabled.