Skip to content

jupyter-xeus/xeus-r

Repository files navigation

xeus-r

Build Status Documentation Status Binder lite-badge

xeus-r is a Jupyter kernel for the R programming language.

Installation

xeus-r has been packaged for the mamba package manager on the Linux, Windows, and OS X platforms.

Installation with mamba or conda

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

mamba create -n xeus-r
mamba activate xeus-r

Then you can install in this environment xeus-r and its dependencies

mamba install xeus-r -c conda-forge

Installing from source

Xeus-r can be built from sources. We recommend installing the dependencies with mamba.

mamba install cmake cxx-compiler xeus-zmq nlohmann_json jupyterlab r-base r-evaluate r-rlang r-jsonlite r-glue r-cli r-repr r-irdisplay -c conda-forge

Then you can compile the sources (replace $CONDA_PREFIX with a custom installation prefix if need be)

mkdir build && cd build
cmake .. -D CMAKE_PREFIX_PATH=$CONDA_PREFIX -D CMAKE_INSTALL_PREFIX=$CONDA_PREFIX -D CMAKE_INSTALL_LIBDIR=lib
make && make install

Trying it online

To try out xeus-r interactively in your web browser, just click on the Binder link.

Binder

To use a WebAssembly build of xeus-r in JupyterLite, follow the link.

lite-badge

Documentation

To get started with using xeus-r, check out the full documentation

http://xeus-r.readthedocs.io

Dependencies

xeus-r depends on

xeus-r xeus-zmq nlohmann_json
main >=3.0,<4.0 >=3.11.3
0.2.x >=3.0,<4.0 >=3.11.3

Contributing

See CONTRIBUTING.md to know how to contribute and set up a development environment.

License

This software is licensed under the GNU General Public License v3.

See the LICENSE file for details.