The current master branch and gem version >= 0.2 are compatible with IPython3/Jupyter. If you require IPython2 support, please install an older gem version < 0.2 or use the branch ipython2
This is a Ruby kernel for IPython/Jupyter and is part of SciRuby. You can try it at try.jupyter.org.
The installation instructions are divided according to environments mainly because of ZeroMQ.
At first install IPython/Jupyter. I recommend an installation using virtualenv.
apt-get install python3-dev virtualenv libzmq3-dev
virtualenv -p python3 venv
source venv/bin/activate
pip install 'ipython[notebook]'
After that, install the Ruby gem.
gem install rbczmq
gem install iruby
Now you can run iruby with:
iruby notebook
At first install IPython/Jupyter. I recommend an installation using Enthought Canopy.
After that install libzmq.dll (v3.2.x, x86) from the website of ZeroMQ.
Rename libzmq-v100-mt-3_x_x.dll
to libzmq.dll
.
Add the path to /bin to the PATH system variable.
Run two commands below:
gem install ffi-rzmq
gem install iruby
Now you can run iruby with:
iruby notebook
I recommend an installation using Anaconda. I have not checked the installation to MacOS X, but four lines below were necessary in v0.1.x.
conda remove zeromq (If you installed anaconda)
brew install zeromq
gem install ffi-rzmq
gem install iruby
Send us pull-request if you Mac users successed in installing IRuby in another way.
Take a look at the example notebook and the collection of notebooks which includes a Dockerfile to create a containerized installation of iruby and other scientific gems. You can find the prebuild image at dockerhub.
- IPython/Jupyter >= 3.0.0
- Ruby >= 2.1.0
If you install IRuby with ffi-rzmq instead of rbczmq, libzmq >= 3.2 is added to the list above.
See the CONTRIBUTORS file.
Copyright © 2013-15, IRuby contributors and the Ruby Science Foundation.
All rights reserved.
IRuby, along with SciRuby, is licensed under the MIT license. See the LICENSE file for details.