pyodide/README.md

88 lines
4.0 KiB
Markdown
Raw Normal View History

2020-10-29 22:38:32 +00:00
<div align="center">
<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
[![NPM Latest Release](https://img.shields.io/npm/v/pyodide)](https://www.npmjs.com/package/pyodide)
[![PyPI Latest Release](https://img.shields.io/pypi/v/pyodide-py.svg)](https://pypi.org/project/pyodide-py/)
[![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
## 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
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.
## Try Pyodide (no installation needed)
Try Pyodide in a
[REPL](https://pyodide.org/en/stable/console.html) directly in
your browser. For further information, see the
2021-04-21 19:51:28 +00:00
[documentation](https://pyodide.org/en/stable/).
## Getting Started
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
- 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.
- 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)
- 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):
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
## History
Pyodide was created in 2018 by [Michael Droettboom](https://github.com/mdboom)
at Mozilla as part of the [Iodide
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
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).
## Contributing
Please view the [contributing
2021-04-21 19:51:28 +00:00
guide](https://pyodide.org/en/stable/development/contributing.html) for tips
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
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
## Communication
- Blog: [blog.pyodide.org](https://blog.pyodide.org/)
- 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)
## License
2018-06-14 18:19:08 +00:00
Pyodide uses the [Mozilla Public License Version
2.0](https://choosealicense.com/licenses/mpl-2.0/).