Teaching remotely with Jupyter: tips, resources, and best-practices

Now that many of us have had to move our classes, learning groups, etc to a “remote-only” setup, many people may be wondering how can I effectively teach remotely with Jupyter?. This is a thread to share resources, guides, ideas, etc.

here’s one resource that covers teaching in general with Jupyter (not explicitly remote teaching):

and if anyone is interested in running their own lightweight JupyterHub on cloud resources, I’d recommend checking out:

However I know there are many more resources out there! Please share anything that you’ve found useful below.


On a related post, we kicked some of this conversation off in the geophysics community: the main topic over there is on delivery of notebooks. I will cross-post any new ideas over here!


Thanks Chris! A resource that includes some relevant ideas (in section 4) is this new paper by @labarba: Engineers Code: reusable open learning modules for engineering computations.

1 Like

Not necessarily Jupyter related, but a couple of resources about teaching online that I found on twitter

Blog post about teaching online at short notice: https://education.rstudio.com/blog/2020/03/teaching-online-on-short-notice/

Chapter on teaching online: http://teachtogether.tech/#s:online

1 Like

I use github to deliver assignments.
Student can clone the assignment repo to their space on their TLJH account; everyone uses Jupyterlab on the server as it has a great github extension.
Then, I make a dropbox “file request” folder with a due date/time for submission. Works great if you (as I do) have a dropbox pro account.

As of next week, I will conduct class via zoom and introduce coding ideas in real time. The challenge is that students cannot work together in teams in person and I cannot use my LA’s (learning assistants) to sit down with students.

1 Like

I am a new user to this forum (!?) and can only post 2 links. :grimacing: I’ve posted the reply I prepared (composed of multiple other replies to similar questions) here: https://gist.github.com/westurner/c721e5034aca7449208bbd7d1fb4f396

1 Like

There’s some really cool stuff here - thanks!

1 Like

I’m still doing things in a fairly old-fahsioned way with specific labs. During the labs students can query me using Piazza, which is a forum-based service designed for Higher Ed. requirements. I haven’t tried it yet but there is also a polling feature in it.

CoCalc has chat w/ @ mentions, LaTeX, edit history, emoji, etc built-in: https://doc.cocalc.com/chat.html

AFAIK, it doesn’t have polls. I’ll ask @wstein389 @Ha_Sch about polls.
They just posted a comparison table comparing CoCalc with other Jupyter implementations: https://cocalc.com/doc/compare.html

1 Like

Aha! I leveled up! Here’s those resources in full:

From “Options for giving math talks and lectures online”
https://news.ycombinator.com/item?id=22539537 :

One option: screencast development of a Jupyter notebook.

Jupyter Notebook supports LaTeX (MathTeX) and inline charts. You can create graded notebooks with nbgrader and/or with CoCalc (which records all (optionally multi-user) input such that you can replay it with a time slider).

Jupyter notebooks can be saved to HTML slides with reveal.js, but if you want to execute code cells within a slide, you’ll need to install RISE: https://rise.readthedocs.io/en/stable/

Here are the docs for CoCalc Course Management; Handouts, Assignments, nbgrader: https://doc.cocalc.com/teaching-course-management.html

Here are the docs for nbgrader: https://nbgrader.readthedocs.io/en/stable/

You can also grade Jupyter notebooks in Open edX:

Auto-grade a student assignment created as a Jupyter notebook, using the nbgrader Jupyter extension, and write the score in the Open edX gradebook


Or just show the Jupyter notebook within an edX course: https://github.com/ibleducation/jupyter-edx-viewer-xblock

There are also ways to integrate Jupyter notebooks with various LMS / LRS systems (like Canvas, Blackboard, etc) “nbgrader and LMS / LRS; LTI, xAPI” on the “Teaching with Jupyter Notebooks” mailing list: https://groups.google.com/forum/#!topic/jupyter-education/_UP-VjBYXJE

“Teaching and Learning with Jupyter” (“An open book about Jupyter and its use in teaching and learning.”) https://jupyter4edu.github.io/jupyter-edu-book/

TLJH: “The Littlest JupyterHub” describes how to setup multi-user JupyterHub with e.g. Docker spawners that isolate workloads running with shared resources like GPUs and TPUs: http://tljh.jupyter.org/en/latest/

“Zero to BinderHub” describes how to setup BinderHub on a k8s cluster: https://binderhub.readthedocs.io/en/latest/zero-to-binderhub

If you create a git repository with REES-compatible dependency specification file(s), students can generate a container with all of the same software at home with repo2docker or with BinderHub.

REES is one solution to reproducibility of the computational environment.

BinderHub ( https://mybinder.org/ ) creates docker containers from {git repos, Zenodo, FigShare,} and launches them in free cloud instances also running JupyterLab by building containers with repo2docker (with REES (Reproducible Execution Environment Specification)). This means that all I have to do is add an environment.yml to my git repo in order to get Binder support so that people can just click on the badge in the README to launch JupyterLab with all of the dependencies installed.

REES supports a number of dependency specifications: requirements.txt, Pipfile.lock, environment.yml, aptSources, postBuild. With an environment.yml, I can install the necessary CPython/PyPy version and everything else.

REES: https://repo2docker.readthedocs.io/en/latest/specification.html

REES configuration files: https://repo2docker.readthedocs.io/en/latest/config_files.html

Storing a container built with repo2docker in a container registry is one way to increase the likelihood that it’ll be possible to run the same analysis pipeline with the same data and get the same results years later.

… from https://mail.python.org/archives/list/edu-sig@python.org/message/KZZU63POPUIGBEC4N6SKJBT7SDDSAB5J/ :

Pull Request reviews support line-by-line commenting and optional revision right granting:

GitHub Classroom runs CI tests for student assignments:

For learning git branching (for pull requests), https://learngitbranching.js.org/ is excellent and interactive

Notebooks on Colab can be shared as editable and support comments

Notebooks on CoCalc have a (collaborative) time slider replay, chat, course assignments, nbgrader, …


https://reddit.com/r/learnpython has moderators

Phrasing the question for search is maybe the most useful skill for learning and professionally doing programming:

  • find the docs and bookmark them
  • find the source and bookmark it
  • list every possible word for the thing you’re describing
  • try adding “double quotes” around certain terms and error messages
  • exclude with minus: -“this or that”


Asynchronous and logged scales.


Well-designed tutorials don’t require much searching for answers from people on the interwebs.


Has anyone tried integrating nbgrader with GitLab Classroom yet?

Pull Requests should work well with jupytext configured to auto-write the .py when the .ipynb is saved:

CoCalc may be the most complete solution for courses with lectures and assignments as notebooks:

1 Like

Hi everyone, this setup consists of JupyterHub + nbgrader + docker-compose with the shared grader account setup. More details are available in the readme. We plan on pushing more updates soon to support dynamic course configuration setups, etc. We hope everyone and their families are staying safe!


Thank you for this helpful post. I found it useful as a very good example of well prepared interactive notebooks

1 Like

I worked with Jupyter in education and wrote down the experience at https://insights.tuhh.de/de/?p=19331&preview=false in German - sorry for that but I hope in case you are interested you can find a translator such as deepl. In the article there is also a link to the university GitLab instance which has a simple docker setup for exams.

For exercises, our distribution and collection goes through a standard Learning Management System, so nothing fancy there. Unit Tests such as in nbgrader are reasonable if there is a simple right and wrong but less suitable if you want students to interpret results and explain underlying principles (both exams and exercises). Pen & paper have the great advantage that the students can visualize whatever is on their mind without focussing on some drawing software.

1 Like

I wonder if that “local garage” post is spam. Feels like it copied @1kastner’s reply and replaced some words with “synonyms”. It even has the slightly weird sentence construction “whatever is in their mind”. I reckon a native speaker would have changed it to “on their mind”. I’ve reported it as spam.

I think you’re right - it feels SEO spam to me, thanks for noticing that, it was quite difficult to spot!

Thanks for pointing that out, I have not seen such kind of spam before.

I’ve not seen this before either. A new level of sophistication! Seems like a smart idea to be honest. Though the bots don’t seem to know that links in this forum use nofollow so it isn’t all that useful for SEO.

It just struck me how similar the post was to one “I had read earlier, I am sure, somewhere”. Took me a moment to realise it was your post a few pixels above :slight_smile:

1 Like

Yeah, teaching remotely with Jupyter is good. Additionally, one can also conduct online classes and teach remotely using tools like Webex, R-HUB HD video conferencing servers, Gotomeeting etc. They work well.

1 Like