Pyodide is a Python distribution for the browser and Node.js based on WebAssembly
Go to file
Hood Chatham 8ab07acadd
ENH Add support for pickling JsException (#2631)
2022-05-29 18:31:49 -07:00
.circleci Use tblib to pickle errors in `run_in_pyodide` (#2619) 2022-05-27 12:28:46 -07:00
.github DOC Improve GH PR template (#2464) 2022-05-03 17:38:55 -06:00
benchmark MAINT Split conftest.py into modules (#2418) 2022-05-08 16:52:08 +09:00
cpython Fix building CPython on macos (Fixes #2360) (#2554) 2022-05-12 15:50:01 -07:00
docs Simplify the version bump process (#2587) 2022-05-30 10:26:40 +09:00
emsdk Fix uname to report emscripten version accurately (#2608) 2022-05-24 15:25:25 -07:00
packages docs(various): Typo fixes (#2641) 2022-05-29 09:45:45 -07:00
pyodide-build Simplify the version bump process (#2587) 2022-05-30 10:26:40 +09:00
pyodide-test-runner/pyodide_test_runner ENH Add support for pickling JsException (#2631) 2022-05-29 18:31:49 -07:00
src ENH Add support for pickling JsException (#2631) 2022-05-29 18:31:49 -07:00
tools Simplify the version bump process (#2587) 2022-05-30 10:26:40 +09:00
.clang-format chore: update pre-commit hooks (#2209) 2022-02-23 23:58:11 -05:00
.dockerignore Docker image with prebuilt pyodide (#787) 2020-11-08 21:05:38 +01:00
.editorconfig Fix #71: Upgrade to Python 3.7 2018-09-06 10:56:33 -04:00
.flake8 chore: enable the rest of flake8 & bugbear (#2216) 2022-02-27 12:39:53 -05:00
.gitignore Add pyodide_build create_xbuildenv and install_xbuildenv (#2550) 2022-05-17 22:04:18 -07:00
.pre-commit-config.yaml [pre-commit.ci] pre-commit autoupdate (#2597) 2022-05-25 08:40:03 +02:00
.prettierignore style: improve pre-commit (#2177) 2022-02-19 09:06:25 +01:00
.readthedocs.yml fix: better mypy coverage (#2339) 2022-04-01 21:58:54 +02:00
CODE-OF-CONDUCT.md MAINT Apply prettier to everything by default (#2095) 2022-01-10 13:47:59 -08:00
Dockerfile refactor: use cmake 3.22 from pip (#2489) 2022-05-04 14:22:50 -06:00
Dockerfile-prebuilt Rename 'build' directory to 'dist' (#2387) 2022-04-11 16:01:40 -07:00
LICENSE Initial commit 2018-02-23 14:21:29 -05:00
Makefile MAINT Remove outdated commands in Makefile (#2576) 2022-05-19 15:09:24 +09:00
Makefile.envs Add loadDynlib to micropip._compat (split off from #2591) (#2639) 2022-05-28 23:06:51 -07:00
README.md DOCS Fix capitalization of package names in readme [skip ci] (#2068) 2021-12-26 12:46:03 -08:00
conftest.py MAINT Add pytest.mark.xfail_browsers and use it to reduce boilerplate (#2616) 2022-05-25 13:34:40 -07:00
lgtm.yml Apply lints suggested by lgtm.com (#1398) 2021-03-31 21:11:41 +02:00
pyodide_env.sh chore: more pre-commit checking (#2257) 2022-03-07 21:51:20 -08:00
pyproject.toml chore(types): fill out remaining partial types (#2612) 2022-05-25 20:31:04 -07:00
repository-structure.md chore: more pre-commit checking (#2257) 2022-03-07 21:51:20 -08:00
requirements.txt Simplify the version bump process (#2587) 2022-05-30 10:26:40 +09:00
run_docker Use tblib to pickle errors in `run_in_pyodide` (#2619) 2022-05-27 12:28:46 -07:00
setup.cfg Simplify the version bump process (#2587) 2022-05-30 10:26:40 +09:00

README.md

NPM Latest Release PyPI Latest Release Build Status Documentation Status

Pyodide is a Python distribution for the browser and Node.js based on WebAssembly.

What is Pyodide?

Pyodide is a port of CPython to WebAssembly/Emscripten.

Pyodide makes it possible to install and run Python packages in the browser with micropip. Any pure Python package with a wheel available on PyPi is supported. Many packages with C extensions have also been ported for use with Pyodide. These include many general-purpose packages such as regex, PyYAML, lxml and scientific Python packages including NumPy, pandas, SciPy, Matplotlib, and scikit-learn.

Pyodide comes with a robust Javascript ⟺ Python foreign function interface so that you can freely mix these two languages in your code with minimal friction. This includes full support for error handling (throw an error in one language, catch it in the other), async/await, and much more.

When used inside a browser, Python has full access to the Web APIs.

Try Pyodide (no installation needed)

Try Pyodide in a REPL directly in your browser. For further information, see the documentation.

Getting Started

Pyodide offers three different ways to get started depending on your needs and technical resources. These include:

  • Use a hosted distribution of Pyodide: see the Getting Started documentation.
  • Download a version of Pyodide from the releases page and serve it with a web server.
  • Build Pyodide from source
    • Build natively with make: primarily for Linux users who want to experiment or contribute back to the project.
    • Use a Docker image: recommended for Windows and macOS users and for Linux users who prefer a Debian-based Docker image with the dependencies already installed.

History

Pyodide was created in 2018 by Michael Droettboom at Mozilla as part of the Iodide project. Iodide is an experimental web-based notebook environment for literate scientific computing and communication.

Iodide is no longer maintained. If you want to use Pyodide in an interactive client-side notebook, see Pyodide notebook environments.

Contributing

Please view the contributing guide for tips on filing issues, making changes, and submitting pull requests. Pyodide is an independent and community-driven open-source project. The decision-making process is outlined in the Project governance.

Communication

License

Pyodide uses the Mozilla Public License Version 2.0.