Python Workers Examples

This is a collection of examples for writing Cloudflare Workers in Python. Use these examples to learn how Python Workers work.

Get started

1. git clone https://github.com/cloudflare/python-workers-examples
2. cd hello
3. npx wrangler@latest dev
4. Press the b key to open a browser tab, and make a request to your Worker

You can run npx wrangler@latest dev in any example project directory to run a local development server using Wrangler, the CLI for Cloudflare Workers. This local development server is powered by workerd, the open-source Workers runtime.

Need to deploy your Worker to Cloudflare? Python Workers are in open beta and have a few limitations.

Examples

• 01-hello/ — the most basic Python Worker
• 05-query-d1/ - shows how to query D1 with Python Workers
• 06-vendoring/ - shows how to vendor packages

These examples are deprecated:

• 02-binding/ — shows how bindings work in Python Workers. Put a key into Workers KV, and then read it.
• 03-fastapi/ — demonstrates how to use the FastAPI package with Python Workers
• 04-langchain/ — demonstrates how to use the LangChain package with Python Workers

Open Beta and Limits

• Python Workers are in open beta. You can use packages in your Workers by vendoring them using the pywrangler tool.
• You must add the python_workers compatibility flag to your Worker while Python Workers are in open beta.

We’d love your feedback. Join the #python-workers channel in the Cloudflare Developers Discord and let us know what you’d like to see next.

License

The Apache 2.0 license.