domitry / iruby

Ruby kernel for IPython Notebook

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

IRuby

This is a Ruby kernel for IPython/Jupyter and is part of SciRuby. You can try it at try.jupyter.org.

Quick start

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 iruby

Now you can run iruby with:

iruby
iruby notebook

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.

Required dependencies

• IPython/Jupyter >= 3.0.0
• libzmq >= 3.2
• Ruby >= 2.1.0

Authors

See the CONTRIBUTORS file.

License

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.