Skip to main content

A modern Python web framework filled with asynchronous salsa.

Project description

python pypi downloads travis black codecov license Join the chat at


Bocadillo is a Python web framework that provides a sane toolkit for quickly building performant web applications and services, while encouraging best practices and keeping developer experience in mind.

Under the hood, it uses the Starlette ASGI toolkit and the lightning-fast uvicorn ASGI server.

Read the documentation

Quick start

Install it:

pip install bocadillo

Build something:

import bocadillo

api = bocadillo.API()

async def index(req, res):
    # Use a template from the ./templates directory 
    res.html = await api.template("index.html")

async def greet(req, res, person): = {"message": f"Hi, {person}!"}

if __name__ == "__main__":



Make requests!

curl http://localhost:8000/greet/Bocadillo
{"message": "Hi, Bocadillo!"}

Hungry for more? Head to the docs.


See CONTRIBUTING for contribution guidelines.


See CHANGELOG for a chronological log of changes to Bocadillo.


For a list of short, mid and long-term feature ideas currently in our scope, see the Roadmap.

To see what has already been implemented for the next release, see the Unreleased section of our changelog.



  • Designed by Florimond Manca.
  • Sandwich icon designed by macrovector.

Project details

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
bocadillo-0.11.0-py3-none-any.whl (31.2 kB) Copy SHA256 hash SHA256 Wheel py3
bocadillo-0.11.0.tar.gz (24.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page