---
title: Python Workers
description: Write Workers in 100% Python
image: https://edgetunnel-b2h.pages.dev/dev-products-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://edgetunnel-b2h.pages.dev/workers/llms.txt  
> Use this file to discover all available pages before exploring further. 

[Skip to content](#%5Ftop) 

# Python Workers

Cloudflare Workers provides a first-class Python experience, including support for:

* Easy to install and fast-booting [Packages](https://edgetunnel-b2h.pages.dev/workers/languages/python/packages), including [FastAPI ↗](https://fastapi.tiangolo.com/), [Langchain ↗](https://pypi.org/project/langchain/), [Pydantic ↗](https://docs.pydantic.dev/latest/) and more.
* A robust [foreign function interface (FFI)](https://edgetunnel-b2h.pages.dev/workers/languages/python/ffi) that lets you use JavaScript objects and functions directly from Python — including all [Runtime APIs](https://edgetunnel-b2h.pages.dev/workers/runtime-apis/)
* An ecosystem of services on the Workers Platform accessible via [bindings](https://edgetunnel-b2h.pages.dev/workers/runtime-apis/bindings/), including:  
  * State storage and databases like [KV](https://edgetunnel-b2h.pages.dev/kv), [D1](https://edgetunnel-b2h.pages.dev/d1), [Durable Objects](https://edgetunnel-b2h.pages.dev/durable-objects/)
  * Access to [Environment Variables](https://edgetunnel-b2h.pages.dev/workers/configuration/environment-variables/), [Secrets](https://edgetunnel-b2h.pages.dev/workers/configuration/secrets/), and other Workers using [Service Bindings](https://edgetunnel-b2h.pages.dev/workers/runtime-apis/bindings/service-bindings/)
  * AI capabilities with [Workers AI](https://edgetunnel-b2h.pages.dev/workers-ai/), [Vectorize](https://edgetunnel-b2h.pages.dev/vectorize)
  * File storage with [R2](https://edgetunnel-b2h.pages.dev/r2)
  * [Durable Workflows](https://edgetunnel-b2h.pages.dev/workflows/), [Queues](https://edgetunnel-b2h.pages.dev/queues/), and [more](https://edgetunnel-b2h.pages.dev/workers/runtime-apis/bindings/)

## Introduction

A Python Worker can be as simple as four lines of code:

**Python**

```python
from workers import WorkerEntrypoint, Response


class Default(WorkerEntrypoint):
    async def fetch(self, request):
        return Response("Hello World!")
```

Similar to other Workers, the main entry point for a Python worker is the [fetch handler](https://edgetunnel-b2h.pages.dev/workers/runtime-apis/handlers/fetch) which handles incoming requests sent to the Worker.

In a Python Worker, this handler is placed in a `Default` class that extends the `WorkerEntrypoint` class (which you can import from the `workers` SDK module).

Python Workers are in beta.

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 ↗](https://discord.cloudflare.com/) and let us know what you'd like to see next.

### The `pywrangler` CLI tool

To run a Python Worker locally, install packages, and deploy it to Cloudflare, you use [pywrangler ↗](https://github.com/cloudflare/workers-py), the CLI for Python Workers.

To set it up, first, ensure [uv ↗](https://docs.astral.sh/uv/#installation) and [Node ↗](https://nodejs.org/en) are installed.

Then set up your development environment:

```bash
uvx --from workers-py pywrangler init
```

This will create a `pyproject.toml` file with `workers-py` as a development dependency. `pywrangler init` will create a wrangler config file. You can then run `pywrangler` with:

```bash
uv run pywrangler dev
```

To deploy a Python Worker to Cloudflare, run `pywrangler deploy`:

```bash
uv run pywrangler deploy
```

### Python Worker Templates

When you initialize a new Python Worker project and select from one of many templates:

```bash
uv run pywrangler init
```

Or you can clone the examples repository to explore more options:

```bash
git clone https://github.com/cloudflare/python-workers-examples
cd python-workers-examples/01-hello
```

## Next Up

* Learn more about [the basics of Python Workers](https://edgetunnel-b2h.pages.dev/workers/languages/python/basics)
* Learn details about local development, deployment, and [how to Python Workers work](https://edgetunnel-b2h.pages.dev/workers/languages/python/how-python-workers-work).
* Explore the [package](https://edgetunnel-b2h.pages.dev/workers/languages/python/packages) docs for instructions on how to use packages with Python Workers.
* Understand which parts of the [Python Standard Library](https://edgetunnel-b2h.pages.dev/workers/languages/python/stdlib) are supported in Python Workers.
* Learn about Python Workers' [foreign function interface (FFI)](https://edgetunnel-b2h.pages.dev/workers/languages/python/ffi), and how to use it to work with [bindings](https://edgetunnel-b2h.pages.dev/workers/runtime-apis/bindings) and [Runtime APIs](https://edgetunnel-b2h.pages.dev/workers/runtime-apis/).

```json
{"@context":"https://schema.org","@type":"WebPage","@id":"https://edgetunnel-b2h.pages.dev/workers/languages/python/#page","headline":"Write Cloudflare Workers in Python · Cloudflare Workers docs","description":"Write Workers in 100% Python","url":"https://edgetunnel-b2h.pages.dev/workers/languages/python/","inLanguage":"en","image":"https://edgetunnel-b2h.pages.dev/dev-products-preview.png","dateModified":"2026-06-22","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://edgetunnel-b2h.pages.dev/#website","name":"Cloudflare Docs","url":"https://edgetunnel-b2h.pages.dev/"}}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/workers/","name":"Workers"}},{"@type":"ListItem","position":3,"item":{"@id":"/workers/languages/","name":"Languages"}},{"@type":"ListItem","position":4,"item":{"@id":"/workers/languages/python/","name":"Python Workers"}}]}
```