New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Enable Notebooks to Run Online Without Local Installation #62

Merged
merged 1 commit into from Nov 12, 2017

Conversation

Projects
None yet
4 participants
@hydrosquall
Copy link
Contributor

hydrosquall commented Nov 12, 2017

Context

  • Installing Docker and Anaconda can take a long time, especially with beginners. I wanted to be able to run these example notebooks with a classroom of beginning coders, even on public computers.
  • mybinder.org lets you run GitHub repositories with .ipynb notebooks for free! However, it's designed with Python3 in mind. It is a freely usable instance of jupyterhub's binderhub project.
  • The branch naming breaks the git-flow convention temporarily since mybinder.org doesn't support branches with / in them, this is addressed in jupyterhub/binderhub#264
  • This should fix #61

Changelog

  • Most importantly: you can try the notebooks out here!
  • I pinned the requirements.txt to versions that are compatible with the existing notebooks (I tested manually to make sure that each notebook runs to completion). I didn't specify the libraries that are implicitly included by mybinder.org, such as tornado and ipython.
  • I added 2 links to the README.md so people can find the live notebooks easily.
  • runtime.txt and the binder/ folder are necessary so that mybinder.org can build the Docker images properly.

Before Merging

  • The mybinder URL should be updated to point to the jvns repo instead my own repository, it's only this way so that people can test the PR conveniently.

Thanks for putting together this wonderful resource for people to learn with data and pandas!

cc @jvns

@hydrosquall hydrosquall changed the title Setup binder deployment Enable Notebooks to Run Online Without Local Installation Nov 12, 2017

@hydrosquall hydrosquall force-pushed the hydrosquall:feature-deploy-to-binder branch 4 times, most recently from 71161ce to 50c4d5f Nov 12, 2017

@hydrosquall hydrosquall force-pushed the hydrosquall:feature-deploy-to-binder branch from 50c4d5f to 2a72ff8 Nov 12, 2017

@jvns

This comment has been minimized.

Copy link
Owner

jvns commented Nov 12, 2017

Thanks so much @hydrosquall, this is an extremely awesome contribution -- I didn't know that binder existed and I'm so happy to be able to link to it. I'll fix up the links!

@jvns jvns merged commit 88765f8 into jvns:master Nov 12, 2017

@hydrosquall

This comment has been minimized.

Copy link
Contributor

hydrosquall commented Nov 13, 2017

Yea, I learned of it fairly recently, and had been itching to test it out on a live project. Appreciate the quick merge :)!

The project used to be backed by the Freeman Lab, but I believe the Jupyter project/foundation has adopted it. There's a bit more background about the state of the project here: http://ivory.idyll.org/blog/2016-mybinder.html

@choldgraf

This comment has been minimized.

Copy link

choldgraf commented Nov 16, 2017

FWIW, that post is now 100% out-of-date in terms of the technology behind Binder :-) all of the jupyterhub backend stuff is brand new as of this year, so whichever number you believed (90% or 95%), it's now incremented by a few percentage points ;-)

@mkcor

This comment has been minimized.

Copy link

mkcor commented Jan 12, 2018

@hydrosquall hydrosquall deleted the hydrosquall:feature-deploy-to-binder branch Jan 14, 2018

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment