This Python library offers the ability to transpile Python machine learning models into Leo code. Additionally, it provides tools to execute the transpiled code from Python and to generate zk proofs.
-
Python: Ensure Python 3.9.6 or newer is installed.
- Check by running:
python3 --version
- If not installed, follow the instructions here.
-
Leo: Ensure Leo version 1.9.3 or newer is installed.
- Check by running:
leo --version
- If necessary, update:
leo update
- Installation guide: Leo Installation
-
Confirm you're on the master branch of GitHub (you should be by default).
Through PyPI:
- Install using the following command:
pip3 install zkml
Through the GitHub repository:
- Clone the repository, or download the
.whl
or.tar.gz
file from thedist
folder. - Navigate to the
dist
directory containing the.whl
or.tar.gz
file:cd dist
- Install using pip:
OR
pip3 install zkml-0.0.1b1-py3-none-any.whl
pip3 install zkml-0.0.1b1.tar.gz
- Explore the
examples
folder from GitHub for example usages. To run the examples, additional Python packages are required. You can install these from theexamples
folder by running:pip3 install -r requirements.txt
- The examples demonstrate how to work with the Python to Leo transpiler. Currently, the transpiler supports scikit-learn decision tree and multilayer perceptron neural network models, and the examples cover the Iris dataset, the German credit dataset, and the MNIST dataset.
Notes:
-
On some systems, "python" and "pip" might be used instead of "python3" and "pip3".
-
In case you are unfamiliar with Jupyter notebooks, here are two ways to run these notebooks:
-
Visual Studio Code (VS Code)
- Ensure you have VS Code installed.
- Install the Jupyter extension in VS Code.
- Open the notebook file (
.ipynb
) in VS Code to view, edit, and run the Python code cells interactively.
-
Jupyter Notebook
- Ensure you have Jupyter Notebook installed.
- Navigate to the
examples
folder in a terminal and launch Jupyter Notebook using the commandjupyter notebook
. - Once Jupyter Notebook launches in your browser, open the notebook files (
.ipynb
) to view and run the Python code cells interactively.
For a more detailed tutorial on using Jupyter Notebooks, refer to this Jupyter Notebook beginner guide.
-
- Clone the repository.
- Ensure no previous version of
zkml
is installed:pip3 uninstall zkml
- Navigate to the
zkml
source code directory:cd zkml
- Install in editable mode:
pip3 install -e .
Please follow the contribution guidelines outlined here. For efficient workflows, we also encourage you to get in touch with the developers prior to contributing.
Thank you for your interest in the zkml Python to Leo transpiler. Let's push the boundaries of zk and Python together!