Skip to main content

Build chrome and chromedriver for use with selenium

Project description


If you have used python with selenium more than a small amount you may have run into a problem caused by one of these three not being compatible with one or more of the others:

  • The browser version.
  • The selenium driver version.
  • The selenium version.

This package is a way to install all three of these together to avoid this problem not only when you first set selenium up but also to prevent this scenario, which has happened to me:

  1. You've got a big release planned for tomorrow.
  2. Google chrome/chromium is upgraded by your OS or inside your docker container somehow.
  3. Your regression test suite breaks because the new version of the browser is incompatible and your tests break.
  4. You're up all night trying to fix it.

HitchChrome is part of the hitchdev framework.

Please note that this package is intended FOR TESTING ONLY. The browser does NOT receive security updates and is potentially unsafe if used to browse the open web.


First, build into a directory of your choice:

from hitchchrome import ChromeBuild

chrome_build = ChromeBuild("./chrome84", "84")

Then use, either with GUI:

driver = chrome_build.webdriver()

Or headless:

driver = chrome_build.webdriver(headless=True)

You can also add chrome options arguments like so:

driver = chrome_build.webdriver(

Or, you can grab the binary locations for use elsewhere:


Package Status

  • Works with chrome versions 80 - 84.

Why not X?

  • Docker. Either you run the browser headless or you will potentially spend more time trying to get it to work than it took me to build this package. That said, you could potentially run this package in docker (see caveats below though).
  • pyderman - only downloads chromedriver. Unless all three versions are controlled and kept in sync (browser, driver, selenium), something will likely get out of sync eventually.
  • chromedriver-binary -- same. Also, you have to manually update it in your requirements.txt when your OS upgrades chrome or chromium or you want to upgrade selenium. I was using this when I decided to write this package.


  • Requires aria2 to be installed (to download). You will need to "apt-get install aria2" or "brew install aria2" or equivalent.
  • Avoid using this package for regular browsing and/or scraping. It fixes the version of chromium which does NOT receive security updates. If you get hacked because of this package that is on you. This package comes with NO warranty, implied or otherwise. Use entirely at your own risk. It is suggested that it be used solely for testing your OWN code.
  • This package fixes the version of selenium in This is done deliberately to ensure that the version being used has been tested with the version of chromium/chromedriver downloaded. If you have a later version of selenium in a requirements file or as a dependency of other packages it may conflict with this one.

Docker caveats

  • ensure_built() will download and install chromium + driver the first time it is run and use it subsequent times it is run. If you run this in a docker container, unless you run it during the build step, it will try to download chrome (~150MB) each time you run it. It'll work, but that will get annoying quickly.
  • If you use this package headless, inside a docker container, the user must not be root (i.e. default user). Chrome will refuse to run.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hitchchrome-85.0.tar.gz (13.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page