Installation

With mamba (or conda)

xeus-lua has been packaged for the mamba (or conda) package manager.

To ensure that the installation works, it is preferable to install xeus-lua in a fresh environment. It is also needed to use a miniforge or miniconda installation because with the full anaconda you may have a conflict with the zeromq library which is already installed in the anaconda distribution.

The safest usage is to create an environment named xeus-lua

mamba create -n xeus-lua
source activate xeus-lua

Then you can install in this freshly created environment xeus-lua and its dependencies

mamba install xeus-lua jupyterlab -c conda-forge

From Source

You can install xeus-lua from source with cmake. This requires that you have all the dependencies installed in the same prefix.

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/path/to/prefix ..
make install

On Windows platforms, from the source directory:

mkdir build
cd build
cmake -G "NMake Makefiles" -DCMAKE_INSTALL_PREFIX=/path/to/prefix ..
nmake
nmake install

Installing the Kernel Spec

When installing xeus-lua in a given installation prefix, the corresponding Jupyter kernelspecs are installed in the same environment and are automatically picked up by Jupyter if it is installed in the same prefix.

However, if Jupyter is installed in a different location, it will not pick up the new kernel. The xeus-lua can be registered with the following command:

jupyter kernelspec install PREFIX/share/jupyter/kernels/xlua --sys-prefix

For more information on the jupyter kernelspec command, please consult the jupyter_client documentation.