https://github.com/pyodide/pyodide-build-environment-nightly
Nightly cross build environments for building Pyodide packages
https://github.com/pyodide/pyodide-build-environment-nightly
Last synced: 3 months ago
JSON representation
Nightly cross build environments for building Pyodide packages
- Host: GitHub
- URL: https://github.com/pyodide/pyodide-build-environment-nightly
- Owner: pyodide
- Created: 2025-01-06T12:36:01.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-01T03:55:51.000Z (3 months ago)
- Last Synced: 2026-04-01T05:51:04.586Z (3 months ago)
- Size: 140 KB
- Stars: 1
- Watchers: 4
- Forks: 3
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🌉 pyodide-build-environment-nightly
Nightly cross build environments for building Pyodide packages
## 🔧 Usage
This repository contains nightly cross build environments for building Pyodide packages.
The target user of this repository is package maintainers who want to build their packages against the unreleased version of Pyodide.
Each release in this repository contains a tip-of-tree build of Pyodide of the given date.
You can use the `pyodide xbuildenv install` command to install the build environment for a given date.
### Cross build environments
#### Release builds
```bash
pip install pyodide-build
# Change the date to the date of the build you want to use
pyodide xbuildenv install --url "https://github.com/pyodide/pyodide-build-environment-nightly/releases/download/20250125/xbuildenv.tar.bz2"
# Now you can use the build environment to build your package
pyodide build
```
#### Debug builds
For debugging purposes, you can also use the debug version of the cross build environment:
```bash
pip install pyodide-build
# Change the date to the date of the build you want to use
pyodide xbuildenv install --url "https://github.com/pyodide/pyodide-build-environment-nightly/releases/download/20250125/xbuildenv-debug.tar.bz2"
# Now you can use the build environment to build your package
pyodide build
```
The debug cross build environment is built with `PYODIDE_DEBUG=1` and provides additional debugging information.
> [!NOTE]
> The debug build does not make a difference in the build process itself. It is useful if you use the Pyodide CLI runner (`pyodide venv`), as
> it will automatically use the installed debug cross build environment for the Pyodide runtime and provide additional debugging information. To
> remove the debug build environment, you may use the `pyodide xbuildenv uninstall` command.
## 🔐 Verifying the release artifacts
If you would like to verify the provenance and integrity of the release artifacts, you may download them and use the `gh attestation` command.
```bash
gh attestation verify dist/xbuildenv.tar.bz2 --repo pyodide/pyodide-build-environment-nightly
gh attestation verify dist/xbuildenv-debug.tar.bz2 --repo pyodide/pyodide-build-environment-nightly
```
For more details on how to use the `gh attestation` command, please refer to the the [GitHub CLI documentation](https://cli.github.com/manual/gh_attestation_verify).
For more information on attestations, please refer to the [GitHub Attestations documentation](https://docs.github.com/en/actions/how-tos/security-for-github-actions/using-artifact-attestations/).
## 📝 Maintainer Notes
The build environment is periodically built and released by GHA.
Otherwise, if you want to manually trigger a build, you can create a new tag.
Creating a tag will trigger a GHA workflow that builds the cross build environment and uploads it as a release asset.