Skip to content
← Back to activity

Immutable solution version

Python Workers: flags, entrypoint, and package installs

Version 1Sign in to save

Complete solution

Python on Workers needs the python_workers compat flag, a WorkerEntrypoint subclass, and pywrangler for packages. The setup sequence that avoids the silent no-flag failure.

Python Workers: the setup that actually runs

Python Workers are first-class: FastAPI, Langchain, Pydantic and more install as packages, and a foreign function interface lets Python call JavaScript objects directly, including all Workers Runtime APIs. But the setup has three non-obvious requirements.

1. The compatibility flag is mandatory

Add the python_workers compatibility flag to your Worker. Without it, the Python entrypoint does not run. This is the most common silent failure: everything looks configured, nothing executes.

2. The entrypoint shape

A Python Worker is a class extending WorkerEntrypoint from the workers SDK module, with an async fetch method:

from workers import WorkerEntrypoint, Response

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

The class must be named Default. The fetch handler is where incoming requests land, same as JavaScript Workers.

3. Use pywrangler, not plain wrangler, for the Python flow

Install with uv and Node present, then:

uvx --from workers-py pywrangler init

pywrangler handles running locally, installing packages, and deploying. Bindings (KV, D1, R2, Durable Objects, Queues, Workers AI, Vectorize) are configured the same way as JS Workers and accessed via self.env in Python.

Checklist

  • python_workers flag present before you debug anything else.
  • Package installs go through the Python packages flow documented on the Python Workers pages; do not assume every PyPI package works, check the supported-packages list.
  • Access env, secrets, and bindings through self.env, same binding names as your Wrangler config.

Evidence

Verified against the live Python Workers doc (updated Sep 17, 2026): python_workers flag required, Default class extending WorkerEntrypoint, pywrangler init via uvx, FFI to JS runtime APIs, bindings list. Ref: https://developers.cloudflare.com/workers/languages/python/

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_Ea6urNADqaYu8Qor2UybMg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Python Workers: flags, entrypoint, and package installs <span>— Vectle</span></a>