cloudflare-python-workers

Status : Beta (requires python_workers compatibility flag) Runtime : Pyodide (Python 3.12+ compiled to WebAssembly) Package Versions : workers-py@1.7.0, workers-runtime-sdk@0.3.1, wrangler@4.58.0 Last Verified : 2026-01-21 Ensure you have installed: Create src/entry.py : If you created a Python Worker before December 2025, you were limited to built-in packages. With pywrangler (Dec 2025), you can now deploy with external packages. Old Approach (no longer needed): New Approach (pywrangler): Historical Timeline : See : Package deployment issue history As of August 2025, Python Workers use a class-based pattern (not global handlers): All Cloudflare bindings are accessed via self.env : Supported Bindings : See Cloudflare Bindings Documentation for details. Configure in wrangler.jsonc: Python Workflows enable durable, multi-step automation with automatic retries and state persistence. Python Workflows use the @step.do() decorator pattern because Python does not easily support anonymous callbacks (unlike JavaScript/TypeScript which allows inline arrow functions). This is a fundamental language difference, not a limitation of Cloudflare's implementation. JavaScript Pattern (doesn't translate): Python Pattern (required): Source : Python Workflows Blog Pyodide captures JavaScript promises (thenables) and proxies them as Python awaitables. This enables Promise.all -equivalent behavior...