The easiest way to install DiffeRT is through pip:

pip install differt

We provide pre-built binaries for most platforms. If you want (or need) to build the package from the source distribution, check out the requirements below.

This project is built using both Python and Rust code, to provide an easy-to-use but performant program. It also heavily uses the capabilities brought by JAX for numerical arrays.

To run build this package locally, you need:

• Python 3.9 or above;
• Rust stable toolchain;
• make (e.g., GNU Make or Make for Windows);
• Maturin for building Python bindings from Rust code;
• and Rye to manage this project.

The following commands assume that you installed the project locally with:

rye sync

and that you activated the corresponding Python virtual environment:

. .venv/bin/activate  # or .venv\Scripts\activate on Windows

To generate the documentation, please run the following:

cd docs
make html

Finally, you can open build/html/index.html to see the generated docs.

Both Rust and Python codebases have their own tests and benchmarks.

You can very easily test you code using Cargo:

cargo test

or benchmark it:

cargo bench

in the same way, you can very test you code with Pytest:

pytest

or benchmark it:

pytest --benchmark-only