Installing leafwaxtools

If you know what you are doing, you may install leafwaxtools in any suitable Python environment, with a Python version >=3.12.

However, we have not, and cannot possiblly, try every situation.

If you are new to Python, we recommend the use of Anaconda (or its minimal version Miniconda), to set up such an environment. Then you may install leafwaxtools via pip.

Installing Anaconda or Miniconda

To install Anaconda or Miniconda on your platform, follow the instructions from this page.

Creating a new conda environment

As of June 2025, we recommend Python 3.12. Create an environment via the command line in your operating system’s terminal.:

conda create -n leafwax python=3.12

To view a list of available environments:

conda env list

To activate the new environment:

conda activate leafwax

To view the list of packages in your environment:

conda list

To remove the environment:

conda remove --name leafwax --all

More information about managing conda environments can be found here.

Installing leafwaxtools

Once the leafwax environment is activate, simply run:

pip install leafwaxtools

THis will install the latest official release, which you can view here. To install the latest version, which contains the most up-to-date features, you can install diectly from the GitHub source:

pip install git+https://github.com/kurtlindberg/leafwaxtools.git

This version may contain bugs not caught by our continuous integration test suite; if so, please report them via github issues.

If you would like to use Spyder for code development:

conda install spyder

If you intent on using leafwaxtools within a Jupyter Notebook, we recommend using ipykernel.

conda install ipykernel
python -m ipykernel install --user --name=leafwax

The first line will install ipykernel and its dependencies, including IPython, Jupyter, etc. The second line will make sure the leafwax environment is visible to Jupyter (see this page for context).