Cloudflare Workers で対応している Python パッケージ

Pywrangler ↗ は、パッケージと Python Workers を管理する CLI ツールです。 wrangler のラッパーとして、環境一式を用意します。デプロイ時にはパッケージを Worker バンドルに含めます。

始めるには、次の内容の pyproject.toml ファイルを作成します。

[project]
name = "YourProjectName"
version = "0.1.0"
description = "Add your description here"
requires-python = ">=3.13"
dependencies = [
    "fastapi"
]

[dependency-groups]
dev = [
	"workers-py",
	"workers-runtime-sdk"
]

上記により、Worker は FastAPI ↗ パッケージに依存できます。

Worker をローカルで実行するには:

uv run pywrangler dev

Worker をデプロイするには:

uv run pywrangler deploy

依存関係は、デプロイ時に Worker へ自動でバンドルされます。

pywrangler CLI は wrangler ツールが対応するすべてのコマンドにも対応しています。コマンドの全一覧は uv run pywrangler --help を実行してください。

対応ライブラリ

Python Workers は、PyPI ↗ 上の純粋な Python パッケージと PyEmscripten ↗ Python パッケージに対応しています。さらに、Python Workers は Pyodide ↗ に含まれるパッケージにも対応しています。

Python パッケージの WebAssembly 対応はまだ初期段階です。一部のパッケージは、PyPI 上の PyEmscripten ホイールとしてまだ利用できないことがあります。使いたいパッケージがまだない場合は、パッケージメンテナーに連絡し、PyEmscripten ホイールを依頼することを推奨します。 Cloudflare Workers Runtime の GitHub リポジトリにある Python Packages Discussions ↗ でスレッドを開始することもできます。パッケージメンテナーとのやり取りを支援します。