cloudflare/workers-py

cloudflare/workers-py

Description: Write Cloudflare Workers in 100% Python via Pyodide.

Language: Python

Stars: 84

Forks: 14

Open issues: 19

Created: 2025-02-06T10:56:47Z

Pushed: 2026-06-09T09:31:28Z

Default branch: main

Fork: no

Archived: no

README:

workers-py Monorepo

A monorepo containing Python libraries and tools for Cloudflare Workers.

Packages

| Package | Description | |---------|-------------| | [workers-py](./packages/cli/) | A set of libraries and tools for Python Workers | | [workers-runtime-sdk](./packages/runtime-sdk/) | Python SDK for Cloudflare Workers |

Development

Prerequisites

• Python 3.12+
• uv for package management

Working with packages

Each package is self-contained with its own pyproject.toml. To work on a specific package:

cd packages/
uv sync
uv run pytest

Releasing

This project uses python-semantic-release with the monorepo configuration. Each package is released independently.

To release a specific package:

cd packages/
semantic-release version

Commit Conventions

This project uses Conventional Commits with package-scoped commits for the monorepo. For package-specific changes, use the scope prefix:

• feat(cli): add new feature - Feature for workers-py
• fix(runtime-sdk): fix bug - Bug fix for workers-runtime-sdk

Tags:

• feat: New feature (triggers minor version bump)
• fix: Bug fix (triggers patch version bump)
• docs, style, refactor, test, chore, ci: Non-release commits

License

MIT