Ready to run docker images of the e2x project for various use cases.
All images are hosted on ghcr.io and quay.io.
All hub images contain JupyterHub, e2xhub, as well as authenticators.
There are several Jupyter Notebook images for different use cases.
Currently all images are based on notebook==6.5.4.
| Image | Base | Teacher | Student | Exam |
|---|---|---|---|---|
| minimal-notebook | base | |||
| datascience-notebook | base | teacher | student | exam |
| ml-notebook | base | teacher | student | exam |
| nlp-notebook | base | teacher | student | exam |
| sql-notebook | base | teacher | student | exam |
| julia-notebook | base | teacher | student | exam |
| desktop-notebook | base |
The notebook images are:
- Minimal Notebook: Base image used for all other images here.
- Data Science Notebook: Based on Minimal Notebook. Additional Python data science libraries (e.g., numpy, scipy, pandas, sklearn, statsmodels).
- Machine Learning Notebook: Based on Data Science Notebook. Additional Python machine learning libraries (e.g., pytorch, gymnasium).
- Natural Language Processing Notebook: Based on Machine Learning Notebook. Additional Python NLP libraries (e.g., nltk, spacy, gensim, transformers).
- SQL Notebook: Based on Data Science Notebook. Additional SQL libraries and kernels.
- Julia Notebook: Based on Minimal Notebook. Adds a Julia kernel and libraries.
- Desktop Notebook: Based on Minimal Notebook. Customized version of the Minimal Notebook image, with an XFCE desktop installed using Jupyter Remote Desktop Proxy.
- DB Main Notebook (experimental): Based on Desktop Notebook. With the DB Main application installed. Serves as an example for running an application in a desktop image.
Each end-point image comes in four different flavors:
- Vanilla: Basic image without any e2xgrader extensions.
- Teacher: Includes
e2xgraderwith teacher mode activated and is intended for instructors for creating and grading assignments. - Student: Includes
e2xgraderwith student mode activated and is intended for students for working on assignments. - Exam: Includes
e2xgraderwith student_exam mode activated and is intended for students for working on exams, providing a restricted notebook.
The following diagram illustrates the dependencies between the different images:
The dev branch will always reflect ghcr.io/digiklausur/docker-stacks/{image_name}:dev on the GitHub container registry, and the master branch reflects ghcr.io/digiklausur/docker-stacks/{image_name}:latest.
If you'd like to contribute to this repository, please feel free to open an issue or submit a pull request.
The images in this repository are licensed under MIT.