Skip to main content

Fast, highly-concurrent and scalable web APIs for everyone

Project description


Bocadillo is now UNMAINTAINED. This repository will be archived by November 2019. We recommend users to migrate to other well-supported alternatives, such as Starlette or FastAPI. Please see #334 for more information.

Build status Test coverage pypi version code style

Mentioned in awesome-asyncio @bocadillopy on Twitter


Bocadillo is a Python async web framework that makes building performant and highly concurrent web APIs fun and accessible to everyone.


Python 3.6+


pip install bocadillo


from bocadillo import App, configure

app = App()

async def index(req, res):
    res.json = {"hello": "world"}

Save this as, then start a uvicorn server (hot reload enabled!):

uvicorn app:app --reload

Say hello!

$ curl http://localhost:8000
{"hello": "world"}

Ready to dive in? Visit the documentation site.


All changes to Bocadillo are recorded in the changelog. To see what's coming in the next release, read the Unreleased section.

Release notes may also be published as blog posts on Bocadillo News.


Found a bug? A typo? Want to help build a new feature? We'd love to see your contributions! There are also many ways to contribute that don't include code: helping with issues, laying out new ideas, improving docs, etc.

Check out the Contributing guide to get started.

By the way, here is the Bocadillo Contributor Hall of Fame. 👨‍💻👩‍💻


Logo 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.

Source Distribution

bocadillo-0.18.3.tar.gz (42.9 kB view hashes)

Uploaded Source

Built Distribution

bocadillo-0.18.3-py3-none-any.whl (65.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page