Pre-release

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

pygodide

PyPI Python versions Downloads CI License: MIT

Docs Ruff

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 FPS benchmark: pygodide 453 vs pygbag 180 on perf_bench

Loading screen | FPS vs pygbag

Documentation

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.

Project links

Data verified by PyPI on Jul 25, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Elan456 from gravatar.com Elan456

Credits

Author: Ethan Anderson

GitHub Statistics

Data verified by PyPI on Jul 25, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.11

Provides Extra

smoke

Tags

browser build-tool cli emscripten game gamedev html5 html5-game itch.io packaging pygame pygame-ce pygodide pyodide wasm web webassembly

Classifiers

Report project as malware

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

Uploaded Source

Built Distribution

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

pygodide-0.1.0b14-py3-none-any.whl (64.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pygodide-0.1.0b14.tar.gz
  • Upload date:
  • Size: 521.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pygodide-0.1.0b14.tar.gz
Algorithm Hash digest
SHA256 8ab303d56f9175227455b2692c8d6292b125b0829b71fe0cbd5026fe94935429
MD5 b1ac68aa54700ea3bfefd895572d1532
BLAKE2b-256 0407fa8298e2e985ff2c25d17f621edafb30e419e18702869926008a9dd60926

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygodide-0.1.0b14.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.

File details

Details for the file pygodide-0.1.0b14-py3-none-any.whl.

File metadata

  • Download URL: pygodide-0.1.0b14-py3-none-any.whl
  • Upload date:
  • Size: 64.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pygodide-0.1.0b14-py3-none-any.whl
Algorithm Hash digest
SHA256 5fc72134c2dd7f9a26ba291f1040696b7bbed9fb76714024c0b5092cea255636
MD5 9b3f37eab9abfc5191cba13aa114ea44
BLAKE2b-256 17f08b54ebf288020a5eae83c5a9410ff650deb1d41156fae74edd865926b749

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygodide-0.1.0b14-py3-none-any.whl:

Publisher: publish.yml on Elan456/pygodide

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page