pygodide

Pre-release

This release is a pre-release and may not be stable for production use.

pygodide turns Pygame projects into browser apps using Pyodide with one command, no edits to your source code, and achieving 2.5x more FPS than pygbag.

Pronounced "pie-go-died"

_{FPS performance benchmark |
Full benchmark}

If anything does not work out of the box, pygodide offers many configuration options to adapt to your needs.

Stuck? Work through the instructions first. If you still cannot get your game running, open a "My project didn't convert" issue so we can improve pygodide for everyone.

Documentation: https://elan456.github.io/pygodide/

Quick Start

From your project's root directory, run the following commands:

Install

# Or add to your pyproject.toml and `uv sync`
pip install pygodide

Build

# Produces the web-hostable build/ directory
pygodide build .

# For an itch.io zip file
pygodide build . --zip

Serve

# Hosts the build/ directory locally
pygodide serve .

Open http://localhost:8000 in your browser.

Troubleshooting

If anything went wrong, work through the instructions page first (config, async, smoke tests, and common failures).

If you still cannot get your game running in the browser, open a "My project didn't convert" issue so we can improve pygodide for everyone. Paste build/pygodide-build.log into the form.

Examples and Live Demos

Sample projects live under test_targets/, and a few of them are uploaded to itch.io.

Numpy particles demo: https://elan456.itch.io/pygodide-test-project
Audio demo: https://elan456.itch.io/pygodide-audio-demo
Arcade performance benchmark: https://elan456.itch.io/pygodide-performance-benchmark

Try one locally:

pygodide build test_targets/ball_bouncing
pygodide serve test_targets/ball_bouncing

Before every release, each target under test_targets/ is automatically verified using a headless browser to catch regressions. All features shown in the test targets are maintained as first-class features.

Contributing

git clone https://github.com/Elan456/pygodide.git
cd pygodide
uv sync --dev
uv run playwright install chromium
uv run pre-commit install --hook-type pre-commit --hook-type pre-push

The dev group includes pygodide[smoke], so Playwright is installed with uv sync --dev. You still need playwright install chromium once for browser binaries.

Run the same checks as CI:

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

Smoke tests (from this repo)

uv run playwright install chromium   # once
uv run pygodide smoke /path/to/your/pygame/project
uv run pygodide smoke test_targets --suite

Be sure to read AGENTS.md; it is written for both human contributors and AI tools.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pygodide-0.1.0b12.tar.gz (470.7 kB view details)

Uploaded Jul 18, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pygodide-0.1.0b12-py3-none-any.whl (63.5 kB view details)

Uploaded Jul 18, 2026 Python 3

File details

Details for the file pygodide-0.1.0b12.tar.gz.

File metadata

Download URL: pygodide-0.1.0b12.tar.gz
Upload date: Jul 18, 2026
Size: 470.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pygodide-0.1.0b12.tar.gz
Algorithm	Hash digest
SHA256	`b6b98d15dfc97ddb060ebb83350a75509bd2df4f808c74542dd2bf20a68549f2`
MD5	`107a8d4c22b735d195bbd3f8e7a4d674`
BLAKE2b-256	`caf1abc739b05ed58676b93fab0132c9eed8d45c25ed59a12e35fd53cd656e16`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygodide-0.1.0b12.tar.gz:

Publisher: publish.yml on Elan456/pygodide

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pygodide-0.1.0b12.tar.gz
- Subject digest: b6b98d15dfc97ddb060ebb83350a75509bd2df4f808c74542dd2bf20a68549f2
- Sigstore transparency entry: 2195061732
- Sigstore integration time: Jul 18, 2026
Source repository:
- Permalink: Elan456/pygodide@a5bbc3d612f3b184061f01138e96efcedf0c284d
- Branch / Tag: refs/tags/0.1.0b12
- Owner: https://github.com/Elan456
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@a5bbc3d612f3b184061f01138e96efcedf0c284d
- Trigger Event: release