README.md

IRacket

IRacket is a Racket kernel for Jupyter. IRacket enables interactive notebook-style programming with Racket.

Requirements

• Racket
• Jupyter
• ZeroMQ
  • on Debian/Ubuntu Linux: install the libzmq5 package
  • on RedHat/Fedora (Linux): install the zeromq package
  • on MacOS with Homebrew: run brew install zmq
  • on Windows, automatically installed by Racket's zeromq-r-lib package
  • for other systems, see http://zeromq.org

Installation

First install the iracket package:

raco pkg install iracket

Then register the iracket kernel with Jupyter:

raco iracket install

Using Jupyter with Racket

Run the Jupyter notebook server as you usually do, e.g.

jupyter notebook

and create a new notebook with the Racket kernel, or open examples/getting-started.ipynb in the iracket source directory.

Examples

See the examples subdirectory for example notebooks.

Acknowledgments

The first version of IRacket was by Theo Giannakopoulos (then at BAE Systems), for the PPAML program.