fonsp / pluto-on-binder

How to run Pluto on binder

You can use binder to run notebooks for free on the web.

Step 1

Upload your notebook to the web, and copy the link to your notebook file. An easy way to put notebook files online is using https://gist.github.com/

Step 2

Go to https://pluto-on-binder.glitch.me/ and paste your notebook link into the box. This will generate a binder link for your notebook that you can share with your friends!

https://pluto-on-binder.glitch.me/

Automatic Binder and HTML exports

If you have a repository with Pluto notebooks and you want to automatically generate HTML exports with a Binder button using GitHub Actions and GitHub Pages, take a look at our template repository.

👀 Note

This is the public repository that gets launched behind the scenes when you use a link generated by https://pluto-on-binder.glitch.me/.

You probably do not want to fork this repository and use it for another project, these instruction will come soon. This is also not the recommended way to install Pluto as a jupyter extension. For this, we are working on https://github.com/fonsp/pluto-on-jupyterlab.

Reading the source code of this repository might be confusing! But to Pluto's developers: have a look at the different branches, the master branch is for the demo link, all other branches are for other experiments.

pluto-on-binder's Issues

Why is this link broken hlep

Notebook:

https://github.com/fonsp/disorganised-mess/blob/master/language%20detection.jl

Direct binder link:

https://mybinder.org/v2/gh/fonsp/pluto-on-binder/master?urlpath=pluto/open?url=https%3A%2F%2Fgist.githubusercontent.com%2Ffonsp%2Fd88b3adc8c958dce780cf7c4df8fa437%2Fraw%2F2a8a5bdc6d8b1bcb4462006f62ead2f52fec17bf%2Fturtles.jl

is broken :(

But if you open the binder to the main menu, and paste the notebook link the blue box, it works.

Maybe the URL needs to be encoded twice?

Failed to precompile Plots on opening notebook on binder

I used http://pluto-on-binder.glitch.me/ to generate a link to a Pluto notebook, but it failed to run/initialize with this error:

Distributed.ProcessExitedException(2)

The code that generated this error is:

begin
	using Pkg
	Pkg.activate(mktempdir())
	Pkg.add([Pkg.PackageSpec(name="PlutoUI",version="0.7"),
		 Pkg.PackageSpec(name="Plots"),])
	using PlutoUI, Plots
end

The full notebook is here. Am I doing something wrong?

---

EDIT: I changed this block into two blocks:

begin
	using Pkg
	Pkg.activate(mktempdir())
end

This block ran without error.

begin
	Pkg.add("PlutoUI")
	Pkg.add("Plots")
	using PlutoUI, Plots
end

This block now failed with the following error:

Failed to precompile Plots [91a5bcdd-55d7-5caf-9e0b-520d859cae80] to /srv/julia/pkg/compiled/v1.5/Plots/ld3vC_L1MAE.ji.

error(::String)@error.jl:33
compilecache(::Base.PkgId, ::String)@loading.jl:1305
_require(::Base.PkgId)@loading.jl:1030
require(::Base.PkgId)@loading.jl:928
require(::Module, ::Symbol)@loading.jl:923
top-level scope@Local: 4

Pkg registry issues with Pluto on Binder

Not sure where this issue belongs, but trying to track it down.

I am trying to use Pluto on Binder to load Manifest and Project files from an online repository.

When I download, activate, and instantiate these files, I get the error:
expected package QOI [4b34888f] to be registered

See this Discourse post for more details.

Not sure if this is an issue with QOi itself, Pluto on Binder, or something else?

pluto-on-binder.glitch.me not working with Safari

Under macOs (version 11.6 (20G165)), Safari (Version 15.0 (16612.1.29.41.4, 16612)) does not allow navigating to pluto-on-binder.glitch.me, despite stopping any ad blocker (i.e. ADGUARD).

Instead it works fine with Chrome, even with Ad Blocker on.

File is not a Pluto.jl notebook error

I have a Pluto notebook here which creates the following binder link.

It is definitely a Pluto notebook, so I don't understand where the error comes from. Is the version of Pluto too old/new?

"Package Plots not found in current path"

Despite I see in setup.py the line

os.system('julia -e "import Pkg; Pkg.add([\\"DataFrames\\", \\"CSV\\", \\"Plots\\"]); Pkg.precompile()"')

when I launch a Pluto notebook on Binder, "Plots" is not found and requires (several minutes) to be installed after clicking on the "cloud icon" next to the 'using Plots' line.

DifferentialEquations failed to precompile [BUG]

Given the disscusions in PlutoUtils.jl I don't know how relevant this is, but I tried using pluto-on-binder to add a Binder button to a test repo with a Pluto notebook. It works just fine, but the code

begin
	
	# We set up a new environment for this notebook
	import Pkg
	Pkg.activate(mktempdir())
	
	
	# This is how you add a package:
	Pkg.add("Plots")
	Pkg.add("DifferentialEquations")
	
	using DifferentialEquations
	using Plots
	
end

produces an error (clearly DifferentialEquations.jl is breaking something):

Failed to precompile DifferentialEquations [0c46a032-eb83-5123-abaf-570d42b7fbaa] to /srv/julia/pkg/compiled/v1.5/DifferentialEquations/UQdwS_AZyCc.ji.

    error(::String)@error.jl:33
    compilecache(::Base.PkgId, ::String)@loading.jl:1305
    _require(::Base.PkgId)@loading.jl:1030
    require(::Base.PkgId)@loading.jl:928
    require(::Module, ::Symbol)@loading.jl:923
    top-level scope@Local: 12

Everything else worked, the testing repo is test_pluto_notebook where the binder button should reproduce the error. I will probably keep it up until this works or the whole thing is deprecated.

How to build docker image for faster rendering on binder online?

It seems that github repository with Pluto notebooks take longer time to build on binder because it builds a docker image everytime we click the binder link.

Would it be possible to create docker image itself of the julia environment we are working with Pluto notebook, and push it to the github repository to host it online for faster rendering??

If yes, can you help me how to create docker image that is binder-pluto friendly??

doesn't work

try the example notebook link:

https://mybinder.org/v2/gh/fonsp/pluto-on-binder/v0.19.12?urlpath=pluto/open?url=https%253A%252F%252Fgist.githubusercontent.com%252Ffonsp%252Fd88b3adc8c958dce780cf7c4df8fa437%252Fraw%252F65d760ccb3da5d8be6307b85e40d94a2896ed7b6%252Fturtles.jl

403 forbidden for jupyter-server-proxy cross-origin

Posting an issue to record this for future googlers

This took me a long time to fix: we use jupyter-server-proxy to run Pluto (custom IDE) on binder, which works fine. But for this project all requests need to be done cross-origin (very similar thebe).

By setting the header acess-allow-cross-origin to * on our server, all HTTP requests work (jupyter-server-proxy and binder ingress don't change this header), but a websocket connection still failed, with a 403 response.

Easier deployment

Wondering if this could be added to PyPI or jupyter-server-proxy's contrib to make it easy for people to create their own Pluto Binder setup with custom Julia Manifest or other custom Binder settings.