pyodide/README.md

60 lines
2.8 KiB
Markdown

<div align="center">
<a href="https://github.com/iodide-project/pyodide">
<img src="./docs/_static/img/pyodide-logo-readme.png" alt="Pyodide">
</a>
</div>
[![Build Status](https://circleci.com/gh/iodide-project/pyodide.png)](https://circleci.com/gh/iodide-project/pyodide)
[![Documentation Status](https://readthedocs.org/projects/pyodide/badge/?version=latest)](https://pyodide.readthedocs.io/?badge=latest)
Python with the scientific stack, compiled to WebAssembly.
## What is Pyodide?
**Pyodide** brings the Python 3.8 runtime to the browser via WebAssembly, along with the Python scientific stack including NumPy, Pandas, Matplotlib, SciPy, and scikit-learn. The [`packages` directory](https://github.com/iodide-project/pyodide/tree/master/packages) lists over 75 packages which are currently available. In addition it's possible to install pure Python wheels from PyPi.
**Pyodide** provides transparent conversion of objects between Javascript and Python.
When used inside a browser, Python has full access to the Web APIs.
While closely related to the [iodide project](https://iodide.io), a tool for *literate scientific computing and communication for the web*, Pyodide goes beyond running in a notebook environment. To maximize the flexibility of the modern web, **Pyodide** may
be used standalone in any context where you want to **run Python inside a web
browser**.
## Try Pyodide (no installation needed)
Try pyodide in [Python REPL](https://pyodide-cdn2.iodide.io/v0.16.1/full/console.html) directly in your
browser.
For further information, look through the [documentation](https://pyodide.readthedocs.io/).
## Getting Started
Pyodide offers three different ways to get started depending on your needs and technical resources.
These include:
- Use hosted distribution of pyodide: see [using pyodide from
Javascript](https://pyodide.readthedocs.io/en/latest/usage/quickstart.html)
documentation.
- Download a pre-built version from this
repository's [releases
page](https://github.com/iodide-project/pyodide/releases/) and serve its contents with
a web server.
- [Build Pyodide from source](https://pyodide.readthedocs.io/en/latest/development/building-from-sources.html)
- Build natively with `make`: primarily for Linux users who want to
experiment or contribute back to the project.
- [Use a Docker image](https://pyodide.readthedocs.io/en/latest/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.
## Contributing
Please view the
[contributing guide](https://pyodide.readthedocs.io/en/latest/development/contributing.html)
for tips on filing issues, making changes, and submitting pull requests.
## License
Pyodide uses the Mozilla Public License Version 2.0. See the
[LICENSE file](LICENSE) for more details.