Batavia is an early alpha project. If it breaks, you get to keep all the shiny pieces.
Batavia is an implementation of the Python virtual machine, written in Javascript. With Batavia, you can run Python bytecode in your browser.
It honors Python 3.4.4+ syntax and conventions, and let's you reference objects and classes defined natively in JavaScript.
Batavia requires a Python 3.4 installation, and a virtualenv to run it all in.
Check the Setting up your environment for configuration help.
Clone the code repos:
$ mkdir pybee $ cd pybee $ git clone https://github.com/pybee/batavia $ git clone https://github.com/pybee/ouroboros
Setup a virtualenv (for other environments, see Getting Started).
Linux/Unix/Mac:
$ virtualenv venv $ . venv/bin/activate $ cd batavia $ pip install -e .
Windows:
> virtualenv venv > venv\Scripts\activate > cd batavia > pip install -e .
Run the
makescript to generate the combined Batavia JavaScript files:$ make
NOTE some platforms do not have an alias for make, e.g. Windows with GCC may require gmake to be issued instead.
For more detailed setup instructions, see the Getting Started tutorial
After you have setup the local installation of Batavia, you can now run Python in the browser:
$ cd testserver $ pip install -r requirements.txt $ ./manage.py runserver
then open a web browser at http://localhost:8000
For more detailed instructions, see the Python In The Browser guide.
Documentation for Batavia can be found on on Read The Docs, including:
If you'd like to contribute to Batavia development, our guide for first time contributors will help you get started.
If you experience problems with Batavia, log them on GitHub.
Batavia is part of the BeeWare suite. You can talk to the community through:
- @pybeeware on Twitter
- The pybee/general channel on Gitter.
We foster a welcoming and respectful community as described in our BeeWare Community Code of Conduct.