Skip to content
Go to file
This branch is 2 commits ahead, 607 commits behind gibiansky:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

jupyter IHaskell Build Status


You can now try IHaskell directly in your browser at

Alternatively, watch a talk and demo showing off IHaskell features.

IHaskell is a kernel for the Jupyter project, which allows you to use Haskell inside Jupyter frontends (including the console and notebook). It currently supports GHC 8.

For a tour of some IHaskell features, check out the demo Notebook. More example notebooks are available on the wiki. The wiki also has more extensive documentation of IHaskell features.

IPython Console IPython Notebook

Interactive In-Browser Notebook

Note: IHaskell does not support Windows. To use on Windows, install Virtualbox, install Ubuntu or another Linux distribution, and proceed with the install instructions.



Some prerequisites; adapt to your distribution.

sudo apt-get install -y python3-pip git libtinfo-dev libzmq3-dev libcairo2-dev libpango1.0-dev libmagic-dev libblas-dev liblapack-dev
pip3 install -r requirements.txt
curl -sSL | sh
git clone
cd IHaskell
stack install gtk2hs-buildtools
stack install --fast
ihaskell install --stack


You need to have Homebrew installed. If you do not have it yet run /usr/bin/ruby -e "$(curl -fsSL" in your terminal.

You also need the Xcode command line tools. You can install them by running xcode-select --install in the terminal and following the prompts.

brew install python3 zeromq libmagic cairo pkg-config haskell-stack pango
git clone
cd IHaskell
stack install gtk2hs-buildtools
stack install --fast
ihaskell install --stack

Tested on macOS Sierra (10.12.6)


stack exec jupyter -- notebook


If you have the nix package manager installed, you can create an IHaskell notebook environment with one command. For example:

$ nix-build release.nix --arg packages "haskellPackages: [ haskellPackages.lens ]"
<result path>
$ <result path>/bin/ihaskell-notebook

It might take a while the first time, but subsequent builds will be much faster.

Where are my packages?

Stack manages separate environments for every package. By default your notebooks will only have access to a few packages that happen to be required for ihaskell. To make packages available add them to the stack.yaml in the ihaskell directory and run stack solver && stack install.

Packages should be added to the packages: section and can take the following form (reproduced here from the stack documentation). If you've already installed a package by stack install you can simply list its name even if it's local.

- package-name
- location: .
- location: dir1/dir2
- location:
- location:
- location:
    commit: 6a86ee32e5b869a877151f74064572225e1a0398
- location:
    commit: da39a3ee5e6b4b0d3255bfef95601890afd80709


A Haskell kernel for IPython.




No packages published
You can’t perform that action at this time.