achesnais / clj-jupyter

A Clojure Kernel for Jupyter Notebooks
Eclipse Public License 1.0
43 stars 12 forks source link

CLJ-Jupyter

UPDATE 2017-02-12: I actually won't have time to maintain this project for the foreseeable future. Feel free to fork.

This is a basic implementation of a Clojure kernel for Jupyter. It should in theory support most of what you'd expect of a basic Clojure Jupyter experience.

You can read this if you're wondering why I chose to build my own.

Usage

Vanilla kernel

Navigate to the root of the project and run make to compile the uberjar and set it up in the relevant folder. Unfortunately this process will only work on Macs for now, but I'm happy to take pull requests to implement the process for other OSes.

Once the build/install is done, Jupyter should now offer a Clojure kernel as an option when creating a notebook.

Custom kernel

You can of course add any dependency you want, or add new namespaces to be able to reference them from your notebook.

Outstanding issues

Roadmap

Inspirations

This project would not have been possible without the work/proof of concept done by Rory Kirchner on his Clojupyter project.

License

Copyright © 2016 Antoine Chesnais

Distributed under the Eclipse Public License version 1.0.