# Teachbooks: jupyter-book based interactive notebooks

**URL:** <https://forum.csdms.io/t/teachbooks-jupyter-book-based-interactive-notebooks/32>\
**Category:** General\
**Tags:** education, tools, python, bmi\
**Created:** [November 22, 2024, 12:12pm UTC](https://forum.csdms.io/t/teachbooks-jupyter-book-based-interactive-notebooks/32 "2024-11-22T12:12:17Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![BSchilperoort](https://yyz2.discourse-cdn.com/flex012/user_avatar/forum.csdms.io/bschilperoort/32/14_2.png) [@BSchilperoort](https://forum.csdms.io/u/BSchilperoort)\
**Post date:** [November 22, 2024, 12:12pm UTC](https://forum.csdms.io/t/teachbooks-jupyter-book-based-interactive-notebooks/32/1 "2024-11-22T12:12:17Z")

</div>

At Delft University of Technology, teachers and TAs have been working on a system they call “[teachbooks](https://teachbooks.io/)”. It’s a flavor of jupyter-book, packaged with some extras and modifications.

What they have done really nicely;

- they made [a github template](https://github.com/TeachBooks/template) so you can get started in minutes
- created a [github workflow](https://github.com/TeachBooks/deploy-book-workflow) that will publish your jupyter-book to github pages: no other hosting necessary. The workflow even builds different branches so you can view the in-progress book.
- they made using a browser-based Python kernel easier to integrate, so you can have code examples that students can run/modify on their own machine, no jupyter lab required (for basic/standard pages). [Try this book chapter as example](https://interactivetextbooks.tudelft.nl/risk-reliability/reliability-component/contamination.html)

I’ve used it to setup a [tutorial during a workshop](https://excited-co2.github.io/workshop_tutorial/main/intro.html), but could not use the interactive elements as it needed asyncio which is not possible yet. I did link the book to a jupyter hub we had running during the workshop.

It should also be possible to create a BMI focussed interactive tutorial with teachbooks, where you can play with BMI toy models in the browser. No installing needed.

---

_[View the full topic](https://forum.csdms.io/t/teachbooks-jupyter-book-based-interactive-notebooks/32)._