pygodide 0.1.0b2

Modern replacement for pygbag that leverages pyodide for running pygame in the web

pygodide

BETA (Everything is subject to change)

Pronounced "pie-go-died", pygodide is a tool for converting pygame projects into web applications using Pyodide. It provides a simple command line interface and works by analyzing your code and asset files and then building them together with some web-specific glue code to make everything work in the browser.

Thanks to Pyodide, pygodide supports far more Python packages than just pygame.

Install

pip install pygodide

git clone https://github.com/Elan456/pygodide.git
cd pygodide
uv sync --dev

Quick Start

pygodide build /path/to/your/pygame/project --serve

That's it! Open http://localhost:8000 in a web browser to see your app running. Currently only supports flat projects. The vision is to support any arbitrary pygame project.

Development

Install the local hooks once after cloning:

uv run pre-commit install --hook-type pre-commit --hook-type pre-push

Run the same checks as CI locally:

uv run ruff format --check .
uv run ruff check .
uv run pytest

Proof of Concept

test_targets/ball_bouncing contains a small Pygame app.

Using the following command, you can build and serve the app in a web browser:

pygodide build test_targets/ball_bouncing/src --serve

You'll get the output of:

Serving /home/ethan/Projects/pygodide/test_targets/ball_bouncing/build at http://localhost:8000

Open http://localhost:8000 in a web browser to see the app running. You should see a bouncing ball! Press the arrow keys to accelerate the ball in different directions.