Installation

Requirements

• Linux or macOS — pyodide-build works best on Linux and macOS. Windows is not supported.

• Python 3.12 or later — must match the Python version targeted by the Pyodide cross-build environment you install.

• Node.js — required for testing with pyodide venv. Not needed for building. Node.js >= 24 is recommended.

Install pyodide-build

pip

pip install pyodide-build

pipx

pipx install pyodide-build

uv

uv tool install pyodide-cli --with pyodide-build

Verify the installation:

pyodide --version

What’s next?

• Concepts — understand cross-compilation, the cross-build environment, and platform tags

• Quick Start — build your first WebAssembly wheel