2020-10-29 22:38:32 +00:00
|
|
|
<div align="center">
|
2021-03-29 08:37:03 +00:00
|
|
|
<a href="https://github.com/pyodide/pyodide">
|
2021-02-15 08:28:58 +00:00
|
|
|
<img src="./docs/_static/img/pyodide-logo-readme.png" alt="Pyodide">
|
2020-10-29 22:38:32 +00:00
|
|
|
</a>
|
|
|
|
</div>
|
2018-02-24 17:52:47 +00:00
|
|
|
|
2021-07-31 18:46:22 +00:00
|
|
|
[![NPM Latest Release](https://img.shields.io/npm/v/pyodide)](https://www.npmjs.com/package/pyodide)
|
2024-07-15 07:27:12 +00:00
|
|
|
[![PyPI Latest Release](https://img.shields.io/pypi/v/pyodide-py.svg)](https://pypi.org/project/pyodide-py/)
|
2021-03-29 08:37:03 +00:00
|
|
|
[![Build Status](https://circleci.com/gh/pyodide/pyodide.png)](https://circleci.com/gh/pyodide/pyodide)
|
2021-04-21 19:51:28 +00:00
|
|
|
[![Documentation Status](https://readthedocs.org/projects/pyodide/badge/?version=stable)](https://pyodide.readthedocs.io/?badge=stable)
|
2018-03-30 18:10:03 +00:00
|
|
|
|
2021-12-13 17:36:35 +00:00
|
|
|
Pyodide is a Python distribution for the browser and Node.js based on WebAssembly.
|
2018-06-07 19:50:53 +00:00
|
|
|
|
2019-06-22 00:25:44 +00:00
|
|
|
## What is Pyodide?
|
|
|
|
|
2021-12-13 17:36:35 +00:00
|
|
|
Pyodide is a port of CPython to WebAssembly/[Emscripten](https://emscripten.org/).
|
2018-02-23 19:34:33 +00:00
|
|
|
|
2021-12-13 17:36:35 +00:00
|
|
|
Pyodide makes it possible to install and run Python packages in the browser with
|
2024-02-22 15:42:48 +00:00
|
|
|
[micropip](https://micropip.pyodide.org/). Any pure
|
2021-12-13 17:36:35 +00:00
|
|
|
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
|
2021-12-26 20:46:03 +00:00
|
|
|
general-purpose packages such as regex, PyYAML, lxml and scientific Python
|
|
|
|
packages including NumPy, pandas, SciPy, Matplotlib, and scikit-learn.
|
2018-06-22 18:54:59 +00:00
|
|
|
|
2021-12-13 17:36:35 +00:00
|
|
|
Pyodide comes with a robust Javascript ⟺ Python foreign function interface so
|
2022-06-22 03:15:37 +00:00
|
|
|
that you can freely mix these two languages in your code with minimal friction.
|
|
|
|
This includes full support for error handling, async/await, and much more.
|
2021-12-13 17:36:35 +00:00
|
|
|
|
|
|
|
When used inside a browser, Python has full access to the Web APIs.
|
2019-06-22 00:25:44 +00:00
|
|
|
|
|
|
|
## Try Pyodide (no installation needed)
|
|
|
|
|
2021-04-06 22:11:00 +00:00
|
|
|
Try Pyodide in a
|
2021-04-21 20:57:45 +00:00
|
|
|
[REPL](https://pyodide.org/en/stable/console.html) directly in
|
2021-04-06 22:11:00 +00:00
|
|
|
your browser. For further information, see the
|
2021-04-21 19:51:28 +00:00
|
|
|
[documentation](https://pyodide.org/en/stable/).
|
2018-06-07 19:43:04 +00:00
|
|
|
|
2019-06-22 00:25:44 +00:00
|
|
|
## Getting Started
|
|
|
|
|
2021-04-06 22:11:00 +00:00
|
|
|
Pyodide offers three different ways to get started depending on your needs and
|
|
|
|
technical resources. These include:
|
2019-05-31 20:02:51 +00:00
|
|
|
|
2021-04-06 22:11:00 +00:00
|
|
|
- Use a hosted distribution of Pyodide: see the [Getting
|
2021-04-21 19:51:28 +00:00
|
|
|
Started](https://pyodide.org/en/stable/usage/quickstart.html) documentation.
|
2021-04-06 22:11:00 +00:00
|
|
|
- Download a version of Pyodide from the [releases
|
|
|
|
page](https://github.com/pyodide/pyodide/releases/) and serve it
|
|
|
|
with a web server.
|
2021-04-21 19:51:28 +00:00
|
|
|
- [Build Pyodide from source](https://pyodide.org/en/stable/development/building-from-sources.html)
|
2020-05-19 16:14:56 +00:00
|
|
|
- Build natively with `make`: primarily for Linux users who want to
|
|
|
|
experiment or contribute back to the project.
|
2021-04-21 19:51:28 +00:00
|
|
|
- [Use a Docker image](https://pyodide.org/en/stable/development/building-from-sources.html#using-docker):
|
2020-05-19 16:14:56 +00:00
|
|
|
recommended for Windows and macOS users and for Linux users who prefer a
|
|
|
|
Debian-based Docker image with the dependencies already installed.
|
2018-10-08 19:33:33 +00:00
|
|
|
|
2021-04-06 22:11:00 +00:00
|
|
|
## History
|
2021-07-31 18:46:22 +00:00
|
|
|
|
2021-04-06 22:11:00 +00:00
|
|
|
Pyodide was created in 2018 by [Michael Droettboom](https://github.com/mdboom)
|
2021-04-21 20:57:45 +00:00
|
|
|
at Mozilla as part of the [Iodide
|
2021-04-06 22:11:00 +00:00
|
|
|
project](https://github.com/iodide-project/iodide). 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
|
2021-04-12 16:34:02 +00:00
|
|
|
client-side notebook, see [Pyodide notebook
|
2021-04-21 19:51:28 +00:00
|
|
|
environments](https://pyodide.org/en/stable/project/related-projects.html#notebook-environments-ides-repls).
|
2021-04-06 22:11:00 +00:00
|
|
|
|
2019-06-22 00:25:44 +00:00
|
|
|
## Contributing
|
|
|
|
|
2021-04-06 22:11:00 +00:00
|
|
|
Please view the [contributing
|
2021-04-21 19:51:28 +00:00
|
|
|
guide](https://pyodide.org/en/stable/development/contributing.html) for tips
|
2021-04-06 22:11:00 +00:00
|
|
|
on filing issues, making changes, and submitting pull requests. Pyodide is an
|
2021-11-14 20:47:49 +00:00
|
|
|
independent and community-driven open-source project. The decision-making
|
2021-04-06 22:11:00 +00:00
|
|
|
process is outlined in the [Project
|
2021-04-21 19:51:28 +00:00
|
|
|
governance](https://pyodide.org/en/stable/project/governance.html).
|
2018-04-11 14:17:02 +00:00
|
|
|
|
2021-04-28 13:48:54 +00:00
|
|
|
## Communication
|
|
|
|
|
2021-11-15 09:30:59 +00:00
|
|
|
- Blog: [blog.pyodide.org](https://blog.pyodide.org/)
|
2021-04-28 13:48:54 +00:00
|
|
|
- Mailing list: [mail.python.org/mailman3/lists/pyodide.python.org/](https://mail.python.org/mailman3/lists/pyodide.python.org/)
|
|
|
|
- Twitter: [twitter.com/pyodide](https://twitter.com/pyodide)
|
|
|
|
- Stack Overflow: [stackoverflow.com/questions/tagged/pyodide](https://stackoverflow.com/questions/tagged/pyodide)
|
2024-08-20 09:55:18 +00:00
|
|
|
- Discord: [Pyodide Discord](https://dsc.gg/pyodide)
|
2021-04-28 13:48:54 +00:00
|
|
|
|
2019-06-22 00:25:44 +00:00
|
|
|
## License
|
2018-06-14 18:19:08 +00:00
|
|
|
|
2021-04-06 22:11:00 +00:00
|
|
|
Pyodide uses the [Mozilla Public License Version
|
|
|
|
2.0](https://choosealicense.com/licenses/mpl-2.0/).
|