This package is based on a fork of Pluto.jl
Neptune originated as a fork of the Notebook platform Pluto, for those (like Data Scientists) who have requirements which conflict with the 'reactive' aspect of Pluto (where all cells re-evaluate every time a single cell is evaluated or re-evaluated), and instead prefer linear, sequential execution.
Unlike Jupyter, saved Neptune files are executeable as Julia scripts, so Neptune may also be seen as a 'one-stop' IDE for developing and debugging script code, which cannot be said of either Jupyter (which separates notebooks and scripts) or Pluto (for which notebook execution would not necessarily correspond to script execution).
In terms of position within the Julia Community, the relationship between Neptune and Pluto might be thought of as analogous to Gnome and KDE in the Linux community - in open source, when different developers and users and researchers have different vision and priorities, forks are the natural outcome.
Explore models and share results in a notebook that is
- lightweight - Neptune is based on the package Pluto. Both are written in pure Julia and is easy to install.
- simple - no hidden workspace state; friendly UI.
- sequential - only executes the cells you choose (like Jupyter notebooks)
Neptune is an experiment, offered with a hope for progress and increased convenience.
A Neptune notebook is made up of small blocks of Julia code (cells) and together they form a notebook.
Notebook cells can contain arbitrary Julia code, and you can use external libraries. There are no code rewrites or wrappers, Neptune just looks at your code once before evaluation.
Like in Pluto, your notebooks are saved as pure Julia files (sample), which you can then import as if you had been programming in a regular editor all along. You can also export your notebook with cell outputs as attractive HTML and PDF documents. By reordering cells and hiding code, you have full control over how you tell your story (except for the reactivity, which is only available in Pluto). Notebooks are intended to be fully compatible with Pluto.
Run Julia and add the package:
julia> ] (v1.5) pkg> add Neptune
julia> ] (v1.5) pkg> add https://github.com/compleathorseplayer/Neptune.jl
Using the package manager for the first time can take a few minutes - hang in there!
To run the notebook server:
julia> using Neptune julia> Neptune.run()
Neptune will open in your browser, and you can get started!
Cells will execute like Jupyter Notebooks.
Please note also that some of the printout from some packages (like Flux) will appear on the REPL where you invoked Neptune (there are utilities described on the Pluto site to print more of it in the Notebook)
Follow these instructions to start working on the package.
Neptune.jl is open source! Specifically, it is MIT Licensed.
Neptune.jl is built by gluing together open source software:
Your notebook files are yours, you do not need to credit us. Have fun!
From the authors
We would like to thank the developers of Pluto for their work and talent in creating the beautiful project that is Pluto.jl, and to apologise for any conflicts with their vision. There is no attempt to claim credit here - any successes you may have with Neptune are largely due to the great work of the developers on Pluto.
Created by David Edelman . Inspired by Pluto.jl