A Jupyter kernel for Clojure - run Clojure code in Jupyter Lab, Notebook and Console.

Table of Contents

• Getting Started
• Installation
  • Usage Scenarios - check here to see options for using Clojupyter
  • Using Clojupyter Plugins
  • Clojupyter and Conda
  • Conda-installing Clojupyter
  • Docker Image
• To do
• Collaboration

Getting Started

In the examples folder of the repository are there 3 example notebooks showing some of the features of clojupyter. See this notebook showing examples of how you can display HTML and use external Javascript:

There are 3 example notebooks because Jupyter offers several distinct user interfaces - Jupyter Lab, Jupyter Notebook and Jupyter Console - which have different feature sets for which clojupyter offers different support. We have one example notebook showing the features shared by Lab and Notebook and for each showing their distinct features. According to the Jupyter development roadmaps, Jupyter Notebook will eventually be phased out and completely replaced by Jupyter Lab.

You can also use existing JVM charting libraries since you can render any Java BufferedImage.

Installation

Clojupyter can be used in several ways, please read Usage Scenarios to find out which type of use model best fits you needs, and how to install Clojupyter in that scenario.

Running Jupyter with Clojupyter

Jupyter Notebook

To start Jupyter Notebook do:

jupyter notebook

and choose 'New' in the top right corner and select 'Clojure (clojupyter...)' kernel.

Jupyter Lab

To start Jupyter Lab do:

jupyter lab

Jupyter Console

You can also start the Jupyter Console by:

jupyter-console --kernel=<clojupyter-kernel-name>

Use jupyter-kernelspec list to list all available kernels. So e.g. in case of installing clojupyter using conda the start command is:

jupyter-console --kernel=conda-clojupyter

TODO

Development progress is based on voluntary efforts so we can't make any promises, but the wish list for clojupyter development looks something like this:

• [ ] Front-end: Support reindentation, Parinfer, syntax highlighting in code blocks
• [ ] Connect running kernel to running Clojure instances
• [ ] Clarify/simplify external access to rendering - eliminate dependency from Oz to clojupyter
• [X] Support interactive Jupyter Widgets

Feed-back on development priorities is welcome, use the issue list for input and suggestions.

Collaboration

If you submit a pull request that ends up getting merged, we will give you commit access.