1. mkdir new-site && cd new-site to create a new folder

  2. poetry init --no-interaction --dependency 'coltrane:<1' && poetry install to create a new virtual environment and install the coltrane package

  3. Optional: brew install watchman on MacOS for less resource-intensive local development server


coltrane has some additional functionality that is not enabled by default, but can be used if it is installed with extras.


Adds support for using JSON5 for data files. This allows trailing commas and comments in JSON, so it can be useful for making JSON a little more readable.

poetry add coltrane -E json5


Adds support for deploying coltrane to a production server with gunicorn and whitenoise pre-configured. More details at

poetry add coltrane -E deploy