Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Bootstrap Python projects with virtualenv and pip.

Project Description

Bootstrap Python projects or libraries by checking system pre-requirements if necessary, creating virtual environment, installing all requirements there and finally execute post-bootstrap hooks if any.



As easy as:

# pip install bootstrapper


bootstrapper is licensed under the terms of BSD License.


You may configure any option of bootstrapper, virtualenv and pip by setting it in bootstrap.cfg file. For example:

env = venv
hook = cp -r {PROJECT}/{{.def,}}

quiet = True

quiet = True

By default, next configuration would be used:

env = env
requirements = requirements.txt
quiet = False

download_cache = ~/.bootstrapper/pip-cache/


Download cache option would be used only for pip 1.x as pip 6.0 introduce changes to caching and don’t use this option anymore.

Your configuration or arguments from command line overwrite default options, when arguments from command line overwrite your configuration as well.


$ bootstrapper --help
usage: bootstrapper [-h] [--version] [-c CONFIG]
                    [-p PRE_REQUIREMENTS [PRE_REQUIREMENTS ...]] [-e ENV]
                    [-r REQUIREMENTS] [-C HOOK] [--recreate] [-q]

Bootstrap Python projects and libraries with virtualenv and pip.

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -c CONFIG, --config CONFIG
                        Path to config file. By default: bootstrap.cfg
                        List of pre-requirements to check, separated by space.
  -e ENV, --env ENV     Virtual environment name. By default: env
                        Path to requirements file. By default:
  -C HOOK, --hook HOOK  Execute this hook after bootstrap process.
  --recreate            Recreate virtualenv on every run.
  -q, --quiet           Minimize output, show only error messages.

How it works?

There are two types of Python installables: libraries and projects, where library is Python code which only has and project is Python code that has at least requirements.txt, but could have as well.

Bootstrapper created as tool for installs Python projects, but time after time I needed to use it with libraries too, so from version 0.2 script check if passed requirements file exists on disk and if does just run,

$ pip install -r requirements.txt ...

inside of created virtual environment. But if requirements file does not exist, script sends other arguments to pip,

$ pip install -U -e . ...

and this is all magic.

So in pseudo-code installing Python library or project with bootstrapper is simple process of 4 steps:



0.5 (2015-01-07)

  • Do not use --download-cache option for pip>=6.0. More about new pip caching

0.4 (2014-08-25)

  • Exit from bootstrap script if given config file doesn’t exist
  • Do not run post-bootstrap hook if environment creation or requirements installation ended with error

0.3.1 (2014-03-08)

  • Fix UnboundLocalError in function to create virtual environment

0.3 (2014-03-02)

  • Do not recreate virtual environment if already working in activated virtual environment
  • Colorize error messages if system has pip 1.5+
  • Support multiple command line arguments for pip 1.5 from config files
  • Ignore double handling of virtualenv/pip errors

0.2.2 (2013-12-25)

  • More fixes to MS Windows platform
  • Ability to use {pip} in bootstrap.cfg as path to pip different in MS Windows and Unix systems
  • Store full traceback on interrupting workflow or unexcepted error

0.2.1 (2013-12-20)

  • Fix installing requirements in venv on MS Windows platform

0.2 (2013-12-18)

  • Full support of MS Windows platform
  • Ability to use bootstrapper for libraries with only as well as for projects with requirements.txt or other requirements file
  • Remove support of major/minor requirements in favor of tox

0.1.6 (2013-12-17)

  • Initial support of MS Windows platform

0.1.5 (2013-06-02)

  • Real support of Python 3 versions
  • Enable Travis CI support
  • Refactor bootstrapper to Python module

0.1.4 (2013-06-02)

  • Support Python 3 versions

0.1.3 (2013-05-28)

  • Disable --use-mirrors key by default for installing requirements via pip cause of latest PyPI CDN changes

0.1.2 (2013-05-28)

  • Make ability to reuse cached pip files by storing them in ~/.bootstrapper user directory by default

0.1.1 (2013-01-02)

  • Use --use-mirrors key by default when pip installs requirements to virtual environment

0.1 (2012-09-26)

  • Initial release

Release History

History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(12.1 kB) Copy SHA256 Hash SHA256
Wheel 3.4 Jan 7, 2015
(9.2 kB) Copy SHA256 Hash SHA256
Source None Jan 7, 2015

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting