If you want to dig deeper into the Piccolo internals, follow these instructions.

Get the tests running

  • Create a new virtualenv
  • Clone the Git repo.
  • Install the dependencies: pip install -r requirements.txt.
  • cd tests
  • Install the test dependencies: pip install -r test-requirements.txt.
  • Setup Postgres
  • Run the tests: ./

Contributing to the docs

The docs are written using Sphinx. To get them running locally:

  • cd docs
  • Install the requirements: pip install -r doc-requirements.txt
  • Do an initial build of the docs: make html
  • Serve the docs: python
  • The docs will auto rebuild as you make changes.

Code style

Piccolo uses Black for formatting, preferably with a max line length of 79, to keep it consistent with PEP8 .

You can configure VSCode by modifying settings.json as follows:

    "python.linting.enabled": true,
    "python.linting.mypyEnabled": true,
    "python.formatting.provider": "black",
    "python.formatting.blackArgs": [
    "editor.formatOnSave": true

Type hints are used throughout the project.