Python

Cloudflare Python Workers 使用 workers SDK、WorkerEntrypoint class 和 python_workers compatibility flag。目前 Python Workers 仍为 beta。

open-compute 在认证日期 2026-09-08 下支持原生 Worker Loader child 中的 Python module。固定的 Pyodide bundle 内嵌在 ocd 中，生产启动不会下载 Python runtime。

配置 parent Worker

在 parent 项目的 wrangler.jsonc 中声明 Worker Loader binding：

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "name": "python-loader",
  "main": "src/index.ts",
  "compatibility_date": "2026-09-08",
  "worker_loaders": [{ "binding": "LOADER" }]
}

加载 Python child

Python child 使用 Cloudflare 的 WorkerEntrypoint 模型。parent 提供 Python module，并调用其默认 entrypoint：

interface Env {
  LOADER: WorkerLoader;
}

const pythonSource = `
from workers import WorkerEntrypoint, Response

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

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const child = env.LOADER.load({
      compatibilityDate: "2026-09-08",
      compatibilityFlags: ["python_workers"],
      mainModule: "main.py",
      globalOutbound: null,
      modules: {
        "main.py": { py: pythonSource },
      },
    });

    return child.getEntrypoint().fetch(request);
  },
} satisfies ExportedHandler<Env>;

使用项目内经过认证的 Wrangler 部署 parent：

ocd wrangler deploy

目前 open-compute 的公开 upload contract 不支持通过 pywrangler 把 Python 文件直接作为普通 Worker 的 main 部署，请使用上面的 Worker Loader 路径。在标准 CPU、内存和 subrequest enforcement 可用之前，显式 child limits（包括空对象）也会被拒绝。

Cloudflare 参考：Python Workers。