elan456/pygodide

Pygodide takes a Pygame project, the popular Python library for making 2D games, and turns it into a browser app with a single command and no changes to your source code. It works by running your game through Pyodide, a version of Python that runs inside the browser, and the project reports it runs about 2.5 times faster than pygbag, a similar existing tool that solves the same problem. The name is meant to be read as a play on words combining Pygame and Pyodide. To use it, you install pygodide with pip from your project's root folder, then run a build command that produces a web-hostable folder, or a zip file ready for uploading to itch.io. A serve command lets you host that build locally so you can open it at localhost in your browser and test it right away. The tool also offers a number of configuration options for cases where a project does not work out of the box. If your game does not convert cleanly, the project provides a troubleshooting guide and a template for filing an issue so the maintainers can fix the underlying problem for everyone. The repository includes several example projects, some of which are playable live on itch.io, covering things like particle effects, audio, and performance benchmarking. Before each release, these example projects are automatically tested in a headless browser to catch anything that breaks, so the maintained examples are treated as reliable, working references rather than just demos. Contributors can set up a development environment with the uv tool, install Playwright for browser testing, and run the same formatting, linting, and test checks used in the project's continuous integration, including a smoke test command that checks a given project actually runs after conversion. The project is released under the MIT license, so it can be used and modified freely with attribution.