pygodide

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 (in certain cases).

Pronounced "pie-go-died"

pygodide in-browser loading screen, then a pygame snake game starting

_{Loading screen |
FPS vs pygbag}

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.

Try one locally:

git clone https://github.com/Elan456/pygodide.git
cd pygodide
pip install pygodide

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.0.tar.gz (521.9 kB view details)

Uploaded Aug 6, 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.0-py3-none-any.whl (60.4 kB view details)

Uploaded Aug 6, 2026 Python 3

File details

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

File metadata

Download URL: pygodide-0.1.0.tar.gz
Upload date: Aug 6, 2026
Size: 521.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pygodide-0.1.0.tar.gz
Algorithm	Hash digest
SHA256	`a8a82571beff74dff0b7ae5485520cb57ce80551602da8f29fea29b0ab7ad429`
MD5	`c029dbe17fabb178de125af353a8e80f`
BLAKE2b-256	`616c77882993111ad5abe9f56c6905b206427e3116b015c32ec52c472b1fbf33`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygodide-0.1.0.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.0.tar.gz
- Subject digest: a8a82571beff74dff0b7ae5485520cb57ce80551602da8f29fea29b0ab7ad429
- Sigstore transparency entry: 2356477523
- Sigstore integration time: Aug 6, 2026
Source repository:
- Permalink: Elan456/pygodide@d9ef9b74bcc12f480e6b37a16af7ed612e3110fc
- Branch / Tag: refs/tags/0.1.0
- Owner: https://github.com/Elan456
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@d9ef9b74bcc12f480e6b37a16af7ed612e3110fc
- Trigger Event: release