The installation of PyScaffold requires:

as well as a working installation of Git. Especially Windows users should make sure that the command git is available on the command line. Otherwise, check and update your PATH environment variable or run PyScaffold from the Git Bash.


It is recommended to use virtualenv and pip for Python package management. Make sure pip, six and setuptools are up to date:

pip install --upgrade pip setuptools six

Additionally, if you want to create a Django project or want to use cookiecutter:


In most cases only Django needs to be installed manually since PyScaffold will download and install its requirements automatically when using pip. One exception might be setuptools if you are not using a current version of Virtual Environments as development environment. In case you are using the system installation of Python from your Linux distribution make sure setuptools is installed. To install it on Debian or Ubuntu:

sudo apt-get install python-setuptools

In case of Redhat or Fedora:

sudo yum install python-setuptools


If you have pip installed, then simply type:

pip install --upgrade pyscaffold

to get the lastest stable version. The most recent development version can be installed with:

pip install --pre --upgrade pyscaffold

Using pip also has the advantage that all requirements are automatically installed.

If you want to install PyScaffold with all features like Django and cookiecutter support, run:

pip install --upgrade pyscaffold[ALL]

Additional Requirements

If you run commands like python test and python docs within your project, some additional requirements like py.test will be installed automatically as egg-files inside the .eggs folder. This is quite comfortable but can be confusing because these packages won’t be available to other packages inside your virtual environment. In order to avoid this just install following packages inside your virtual environment before you run commands like doc and test: