minrk / ijulia.jl Goto Github PK

Prototype native Julia kernel for IPython, which allows you to use the IPython front-end interface for the Julia back-end (instead of the native Julia REPL).

Requires:

• Latest (git master) ZMQ.jl, JSON.jl, REPL.jl, and GnuTLS.jl packages.
• Latest (git master as of 27 July 2013) Julia.
• Possibly 1.0dev version of IPython (we haven't tested it with IPython 0.13)

Basic usage: First, run julia kernel.jl to start the Julia kernel. This will print something like connect ipython with --existing /path/to/profile-XXXXX.json. Copy this string and run IPython with ipython console --existing /path/to/profile-XXXXX.json.

Even better, create a julia IPython profile:

$ ipython profile create julia
[ProfileCreate] WARNING | Generating default config file: u'~/.ipython/profile_julia/ipython_config.py'
[ProfileCreate] WARNING | Generating default config file: u'~/.ipython/profile_julia/ipython_qtconsole_config.py'
[ProfileCreate] WARNING | Generating default config file: u'~/.ipython/profile_julia/ipython_notebook_config.py'

then edit $HOME/.ipython/profile_julia/ipython_config.py with the contents:

c = get_config() # should already be at top of the file

c.KernelManager.kernel_cmd = ["julia", "/...PATH.../IJulia/src/kernel.jl", "{connection_file}"]

(replacing ...PATH... with the path to your IJulia directory). This tells IPython how to launch the kernel itself, allowing you to simply run ipython notebook --profile julia or ipython qtconsole --profile julia in order to launch IPython's browser-notebook or Qt interface with Julia.

Please refer to IPython documentation for other config options of IPython frontend themselves. We, for example, strongly recommend to run Notebook over https with password when on a public port, or even localhost if your machine have several users.