To run Jupyter with an R kernel, you need at least the following:

• Jupyter. If you already have a Python environment set up, install Jupyter using your preferred tools. If not, installing Anaconda is the quickest way to get everything you need.
• A current R installation.

Installing from source needs additionally header files (see below).

We provide Windows and Mac OS X binary packages of all the needed packages. The packages and the kernel spec can be installed for the current user with the following lines in an R console:

install.packages(c('rzmq','repr','IRkernel','IRdisplay'),
                 repos = c('http://irkernel.github.io/', getOption('repos')))
IRkernel::installspec()

To install system-wide, set user to False in the installspec command:

IRkernel::installspec(user = FALSE)

To update packages, you have to either add the repo to your default ones in your R startup file and update afterwards as normal:

r <- getOption('repos')
r$IRkernel <- 'http://irkernel.github.io/'
options(repos = r)

Or use the repo option to update.packages() directly:

update.packages(repos = c('http://irkernel.github.io/', getOption('repos')))

Please note that during the initial development, these packages can be updated without changing the version number, which prevents updating via update.packages(). In that case, updated packages can be installed by re-running the above install.packages() line.

You'll need zmq development headers to compile rzmq.

• Ubuntu/Debian

  sudo apt-get install libzmq3-dev

• Arch

  sudo pacman -S zeromq

• Homebrew

  xcode-select --install
  brew install zmq
  # or upgrade
  brew update
  brew upgrade zmq

• MacPorts

  1. make sure an X server is installed, open a terminal and do the following:

     xcode-select --install
     sudo port install zmq

  2. Direct the compiler to use MacPorts libraries using:

     export CPATH=/opt/local/include
     export LIBRARY_PATH=/opt/local/lib

• Windows

  See this bugreport for instruction on how to compile on windows.

Start R in the same terminal, and proceed as below.

You can install snapshot packages and the kernel spec via

install.packages(c('rzmq','repr','IRkernel','IRdisplay'),
                 repos = c('http://irkernel.github.io/', getOption('repos')),
                 type = 'source')
IRkernel::installspec()

To update your source installation, repeat the install.packages step.

If you want to compile the latest and greatest (and maybe buggiest…) from git, the easiest way is via the devtools package.

On Ubuntu/Debian, a header package is needed to compile RCurl:

sudo apt-get install libcurl4-openssl-dev

Start a R session and run:

install.packages('devtools')
# Need RCurl for install_github
install.packages('RCurl')
library(devtools)
# Install the packages
install_github('IRkernel/repr')
install_github('IRkernel/IRdisplay')
install_github('IRkernel/IRkernel')
# Install the kernel spec
IRkernel::installspec()

To update the git versions, repeat the install_github('IRkernel/...') steps.

If you have Jupyter installed, you can create a notebook using IRkernel from the dropdown menu.

You can also start other interfaces with an R kernel:

# “ir” is the kernel name installed by the above 'IRkernel::installspec()'
jupyter qtconsole --kernel=ir
jupyter console --kernel=ir

What is now Jupyter was once a part of the IPython project. If your operating system doesn’t yet have Jupyter, but instead IPython version 3 packages (IPython 1 and 2 are not supported), you can substitute ipython for jupyter in above commands and it will work.