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 acheiving 2.5x more fps than pygbag.
Pronounced "pie-go-died"
FPS Performance Benchmark | Full Benchmark
If anything doesn't work out-of-the-box, pygodide offers tons of configuration options to adapt to your needs.
Documentation: https://elan456.github.io/pygodide/
Quick Start
While in 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, head over to the instructions page for more details and troubleshooting guidance.
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 the AGENTS.md it's written for both human contributors as well as AI tools.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pygodide-0.1.0b10.tar.gz.
File metadata
- Download URL: pygodide-0.1.0b10.tar.gz
- Upload date:
- Size: 458.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bf7ad3794efaf99ba157af44cf283a4c2b7d5b7f0a3ff043c900bbdd54915ae3
|
|
| MD5 |
f7aaf48f3c676045288cac67c7c2e579
|
|
| BLAKE2b-256 |
96d668bbe10294843c6ad2fc80ab1de3ff956110ebcce05f945800624fcdef0c
|
Provenance
The following attestation bundles were made for pygodide-0.1.0b10.tar.gz:
Publisher:
publish.yml on Elan456/pygodide
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pygodide-0.1.0b10.tar.gz -
Subject digest:
bf7ad3794efaf99ba157af44cf283a4c2b7d5b7f0a3ff043c900bbdd54915ae3 - Sigstore transparency entry: 2179879683
- Sigstore integration time:
-
Permalink:
Elan456/pygodide@222b6219f46f51f6c72397741418cf87e6483139 -
Branch / Tag:
refs/tags/0.1.0b10 - Owner: https://github.com/Elan456
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@222b6219f46f51f6c72397741418cf87e6483139 -
Trigger Event:
release
-
Statement type:
File details
Details for the file pygodide-0.1.0b10-py3-none-any.whl.
File metadata
- Download URL: pygodide-0.1.0b10-py3-none-any.whl
- Upload date:
- Size: 56.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
064d1a4e5b1e783e081ecfd16c0a48131569c11b3047fe7cc6802e7d7ccfe370
|
|
| MD5 |
b07a861d4731792d73afe7f91e5b963b
|
|
| BLAKE2b-256 |
b9978b10425b59542a5d7260f8c9627160376b39058f133d273b615f935100e7
|
Provenance
The following attestation bundles were made for pygodide-0.1.0b10-py3-none-any.whl:
Publisher:
publish.yml on Elan456/pygodide
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pygodide-0.1.0b10-py3-none-any.whl -
Subject digest:
064d1a4e5b1e783e081ecfd16c0a48131569c11b3047fe7cc6802e7d7ccfe370 - Sigstore transparency entry: 2179879766
- Sigstore integration time:
-
Permalink:
Elan456/pygodide@222b6219f46f51f6c72397741418cf87e6483139 -
Branch / Tag:
refs/tags/0.1.0b10 - Owner: https://github.com/Elan456
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@222b6219f46f51f6c72397741418cf87e6483139 -
Trigger Event:
release
-
Statement type:
