{"id":32955213,"url":"https://github.com/rlan/notebooks","last_synced_at":"2026-01-17T06:45:00.147Z","repository":{"id":42077904,"uuid":"128279875","full_name":"rlan/notebooks","owner":"rlan","description":"A docker-based starter kit for machine learning via jupyter notebooks. Designed for those who just want a runtime environment and get on with machine learning. Docker Hub:","archived":false,"fork":false,"pushed_at":"2025-11-13T17:00:08.000Z","size":525,"stargazers_count":33,"open_issues_count":4,"forks_count":6,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-13T19:05:27.617Z","etag":null,"topics":["data-science","deep-learning","docker","docker-image","gpu-computing","gpu-ready","jupyter","jupyter-notebook","keras","machine-learning","notebook","python","pytorch","pytorch-lightning","scikit-learn","starter-kit","tensorboard","tensorflow"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/wqael/notebooks/","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rlan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"patreon":"ricklan","ko_fi":"ricklan","buy_me_a_coffee":"rick.lan"}},"created_at":"2018-04-06T00:33:00.000Z","updated_at":"2025-11-13T17:00:13.000Z","dependencies_parsed_at":"2022-07-28T23:08:59.152Z","dependency_job_id":"300f6897-a570-41f4-95b1-77a5a0aa10ae","html_url":"https://github.com/rlan/notebooks","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/rlan/notebooks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rlan%2Fnotebooks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rlan%2Fnotebooks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rlan%2Fnotebooks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rlan%2Fnotebooks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rlan","download_url":"https://codeload.github.com/rlan/notebooks/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rlan%2Fnotebooks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28502854,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T04:31:57.058Z","status":"ssl_error","status_checked_at":"2026-01-17T04:31:45.816Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-science","deep-learning","docker","docker-image","gpu-computing","gpu-ready","jupyter","jupyter-notebook","keras","machine-learning","notebook","python","pytorch","pytorch-lightning","scikit-learn","starter-kit","tensorboard","tensorflow"],"created_at":"2025-11-12T22:00:41.103Z","updated_at":"2026-01-17T06:45:00.141Z","avatar_url":"https://github.com/rlan.png","language":"Dockerfile","funding_links":["https://patreon.com/ricklan","https://ko-fi.com/ricklan","https://buymeacoffee.com/rick.lan"],"categories":["Tools"],"sub_categories":["General-Purpose Machine Learning"],"readme":"# Notebooks\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.11311585.svg)](https://doi.org/10.5281/zenodo.11311585)\n![Docker Pulls](https://img.shields.io/docker/pulls/wqael/notebooks)\n![Docker Stars](https://img.shields.io/docker/stars/wqael/notebooks)\n\nA docker-based starter kit for machine learning via jupyter notebooks. Designed for those who just want a runtime environment and get on with machine learning.\n\n![notebooks_screenshot](assets/notebooks.jpg)\n\n## Docker Images\n\nTo support both old and new environments, [docker images](https://hub.docker.com/r/wqael/notebooks/) cover various combinations of\n* machine learning frameworks ([Keras](https://keras.io/), [TensorFlow](https://www.tensorflow.org/), [PyTorch](https://pytorch.org/))\n* [CUDA](https://developer.nvidia.com/cuda-zone) v8, v9, v10 and v11.\n\nCheck this [compatibility chart](https://docs.nvidia.com/cuda/cuda-toolkit-release-notes/index.html)\nfor the required version of Nvidia graphics driver for your host system.\n\n[Python](https://www.python.org/) 3 only as Python 2 is [end-of-life](https://pythonclock.org), so [deprecated](deprecated/deprecated.md).\n\nAll of the images include:\n* [JupyterLab](https://jupyterlab.readthedocs.io/en/stable/)\n* [scikit-learn](https://scikit-learn.org/stable/)\n* [pandas](https://pandas.pydata.org)\n\nVisualization libraries:\n* [matplotlib](https://matplotlib.org)\n* [seaborn](https://seaborn.pydata.org)\n\nVision-centric libraries:\n* [OpenCV](https://opencv.org/)\n* [scikit-image](http://scikit-image.org/)\n\nNLP libraries:\n* [Natural Language Toolkit](https://www.nltk.org)\n\n## Tags\n\nIf you are reading this on [Docker Hub](https://hub.docker.com/r/wqael/notebooks/), the links to Dockefile's will not work. Please start from [project page](https://github.com/rlan/notebooks) instead.\n\nNote: the default 'latest' tag does not exist. This is a design choice. Please choose a tag from below.\n\n### [PyTorch](https://pytorch.org/)\n\nImages of PyTorch version 1.5 and higher include [PyTorch Lightning](https://github.com/PyTorchLightning/pytorch-lightning).\n\n| Tag (OS-based python) | Comment | Dockerfile | Info |\n| --------------------- | ------- | ---------- | ---- |\n| `pytorch2.9.1` | CPU-only, Python 3.13.9 | [Dockerfile](build/Dockerfile.pytorch2.9.1) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch2.9.1) |\n| `pytorch2.9.1-cuda13.0` | Python 3.11.14 | [Dockerfile](build/Dockerfile.pytorch2.9.1-cuda13.0) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch2.9.1-cuda13.0) |\n| `pytorch2.8.0-cuda12.6` | Minimum required Nvidia Driver \u003e= 525.60.13 (Linux) 528.33 (Windows). Toolkit Driver Version \u003e= 560.28.03 (Linux) 560.76 (Windows). | [Dockerfile](build/Dockerfile.pytorch2.8.0-cuda12.6) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch2.8.0-cuda12.6) |\n| `pytorch2.6.0-cuda12.4` | Minimum required Nvidia Driver \u003e= 525.60.13 (Linux) 528.33 (Windows). Toolkit Driver Version \u003e= 550.54.15 (Linux) 551.78 (Windows). | [Dockerfile](build/Dockerfile.pytorch2.6.0-cuda12.4) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch2.6.0-cuda12.4) |\n| `pytorch2.6.0-cuda11.8` | Minimum required Nvidia Driver \u003e= 450.80.02 (Linux) 452.39 (Windows). Toolkit Driver Version \u003e= 520.61.05 (Linux) 520.06 (Windows). | [Dockerfile](build/Dockerfile.pytorch2.6.0-cuda11.8) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch2.6.0-cuda11.8) |\n| `pytorch2.5.1-cuda12.1` | Minimum required Nvidia Driver \u003e= 525.60.13 (Linux) 528.33 (Windows). Toolkit Driver Version \u003e= 530.30.02 (Linux) 531.14 (Windows). | [Dockerfile](build/Dockerfile.pytorch2.5.1-cuda12.1) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch2.5.1-cuda12.1) |\n| `pytorch2.0.1-cuda11.7` | Nvidia Driver \u003e= 450.80.02 (Linux) 452.39 (Windows) | [Dockerfile](docker/pytorch2.0.1-cuda11.7/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch2.0.1-cuda11.7) |\n| `pytorch1.13.1` | CPU-only | [Dockerfile](docker/pytorch1.13.1/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch1.13.1) |\n| `pytorch1.13.1-cuda11.7` | Nvidia Driver \u003e= 450.80.02 (Linux) 452.39 (Windows) | [Dockerfile](docker/pytorch1.13.1-cuda11.7/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch1.13.1-cuda11.7) |\n| `pytorch1.13.1-cuda11.6` | Nvidia Driver \u003e= 450.80.02 (Linux) 452.39 (Windows) | [Dockerfile](docker/pytorch1.13.1-cuda11.6/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch1.13.1-cuda11.6) |\n| `pytorch1.12.1-cuda11.3.1` | Nvidia Driver \u003e= 450.80.02 (Linux) 452.39 (Windows) | [Dockerfile](docker/pytorch1.12.1-cuda11.3.1/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch1.12.1-cuda11.3.1) |\n| `pytorch1.12.1-cuda10.2` | Nvidia Driver \u003e= 440.33 (Linux) 441.22 (Windows) | [Dockerfile](docker/pytorch1.12.1-cuda10.2/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch1.12.1-cuda10.2) |\n| `pytorch1.9.1-cuda11.1.1` | Nvidia Driver \u003e= 450.80.02 (Linux) 452.39 (Windows) | [Dockerfile](docker/pytorch1.9.1-cuda11.1.1/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch1.9.1-cuda11.1.1) |\n| `pytorch1.7.1-cuda11` | Nvidia Driver \u003e= 450.36.06 (Linux) 451.22 (Windows) | [Dockerfile](docker/pytorch1.7.1-cuda11/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch1.7.1-cuda11) |\n| `pytorch1.7.1-cuda101` | Nvidia Driver \u003e= 418.xx | [Dockerfile](docker/pytorch1.7.1-cuda101/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch1.7.1-cuda101) |\n| `pytorch1.7.1-cuda92` | Nvidia Driver \u003e= 396.xx | [Dockerfile](docker/pytorch1.7.1-cuda92/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/pytorch1.7.1-cuda92) |\n| `jupyter-pytorch1.2-py3-cuda10` | Nvidia Driver \u003e= 410.xx | [Dockerfile](docker/jupyter-pytorch1.2-py3-cuda10/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-pytorch1.2-py3-cuda10) |\n| `jupyter-pytorch1.1-py3-cuda9` | Nvidia Driver \u003e= 384.xx | [Dockerfile](docker/jupyter-pytorch1.1-py3-cuda9/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-pytorch1.1-py3-cuda9) |\n| `jupyter-pytorch1.0-py3-cuda8` | Nvidia Driver \u003e= 375.xx | [Dockerfile](docker/jupyter-pytorch1.0-py3-cuda8/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-pytorch1.0-py3-cuda8) |\n\n\n| Tag (Conda-based python) | Comment | Dockerfile | Info |\n| ------------------------ | ------- | ---------- | ---- |\n| `jupyter-pytorch1.3-conda3` | CPU-only | [Dockerfile](docker/jupyter-pytorch1.3-conda3/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-pytorch1.3-conda3) |\n| `jupyter-pytorch1.3-conda3-cuda92` | Nvidia Driver \u003e= 396.37 | [Dockerfile](docker/jupyter-pytorch1.3-conda3-cuda92/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-pytorch1.3-conda3-cuda92) |\n| `jupyter-pytorch1.1-conda3-cuda9` | Nvidia Driver \u003e= 384.xx | [Dockerfile](docker/jupyter-pytorch1.1-conda3-cuda9/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-pytorch1.1-conda3-cuda9) |\n| `jupyter-pytorch1.0-conda3-cuda8` | Nvidia Driver \u003e= 375.xx | [Dockerfile](docker/jupyter-pytorch1.0-conda3-cuda8/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-pytorch1.0-conda3-cuda8) |\n\n### [TensorFlow](https://www.tensorflow.org/) (including [Keras](https://keras.io/))\n\n\n| Tag (OS-based python) | Comment | Dockerfile | Info |\n| --------------------- | ------- | ---------- | ---- |\n| `tf2.20.0` | CPU-only, Python 3.11.13 | [Dockerfile](build/Dockerfile.tf2.20.0) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/tf2.20.0) |\n| `tf2.19.0-cuda12.3` | Minimum required Nvidia Driver \u003e= 525.60.13 (Linux) 528.33 (Windows). Toolkit driver version \u003e= 545.23.06 (Linux) 545.84 (Windows). | [Dockerfile](build/Dockerfile.tf2.19.0-cuda12.3) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/tf2.19.0-cuda12.3) |\n| `tf2.15.0-cuda11.8` | Nvidia Driver \u003e= 450.80.02 (Linux) 452.39 (Windows) | [Dockerfile](docker/tf2.15.0-cuda11.8/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/tf2.15.0-cuda11.8) |\n| `tf2.11.1-cuda11.2` | Nvidia Driver \u003e= 450.80.02 (Linux) 452.39 (Windows) | [Dockerfile](docker/tf2.11.1-cuda11.2/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/tf2.11.1-cuda11.2) |\n| `tf2.5.0-cuda11` | Nvidia Driver \u003e= 450.36.06 | [Dockerfile](docker/tf2.5.0-cuda11/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/tf2.5.0-cuda11) |\n| `tf2.3.4-cuda101` | Nvidia Driver \u003e= 418.xx | [Dockerfile](docker/tf2.3.4-cuda101/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/tf2.3.4-cuda101) |\n| `tf2.0.4-cuda10` | Nvidia Driver \u003e= 410.xx | [Dockerfile](docker/tf2.0.4-cuda10/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/tf2.0.4-cuda10) |\n| `tf1.15.5` | CPU-only | [Dockerfile](docker/tf1.15.5/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/tf1.15.5) |\n| `tf1.15.5-cuda10` | Nvidia Driver \u003e= 410.xx | [Dockerfile](docker/tf1.15.5-cuda10/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/tf1.15.5-cuda10) |\n| `jupyter-keras-tf1.12.3-py3-cuda9` | Nvidia Driver \u003e= 384.xx | [Dockerfile](docker/jupyter-keras-tf1.12.3-py3-cuda9/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-keras-tf1.12.3-py3-cuda9) |\n| `jupyter-keras-tf1.4.1-py3-cuda8` | Nvidia Driver \u003e= 375.xx | [Dockerfile](docker/jupyter-keras-tf1.4.1-py3-cuda8/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-keras-tf1.4.1-py3-cuda8) |\n\n\n| Tag (Conda-based python) | Comment | Dockerfile | Info |\n| ------------------------ | ------- | ---------- | ---- |\n| `jupyter-keras-tf1.14.0-conda3` | CPU-only | [Dockerfile](docker/jupyter-keras-tf1.14.0-conda3/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-keras-tf1.14.0-conda3) |\n| `jupyter-keras-tf1.14.0-conda3-cuda10` | Nvidia Driver \u003e= 410.xx | [Dockerfile](docker/jupyter-keras-tf1.14.0-conda3-cuda10/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-keras-tf1.14.0-conda3-cuda10) |\n| `jupyter-keras-tf1.12.0-conda3-cuda9` | Nvidia Driver \u003e= 384.xx | [Dockerfile](docker/jupyter-keras-tf1.12.0-conda3-cuda9/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-keras-tf1.12.0-conda3-cuda9) |\n| `jupyter-keras-tf1.4.1-conda3-cuda8` | Nvidia Driver \u003e= 375.xx | [Dockerfile](docker/jupyter-keras-tf1.4.1-conda3-cuda8/Dockerfile) | ![](https://img.shields.io/docker/image-size/wqael/notebooks/jupyter-keras-tf1.4.1-conda3-cuda8) |\n\n\n### Internal Tags\n\nFor intermediate Docker images, from which final images are build from, see [INTERNAL.md](INTERNAL.md).\n\n### Deprecated Tags\n\nFor deprecated tags, see [deprecated/README.md](deprecated/README.md).\n\n\n## Usage\n\n**Step 1**: pull pre-built images:\n\n```sh\ndocker pull wqael/notebooks:\u003ctag\u003e\n```\n\n**Step 2**: launch image:\n\n```sh\ndocker run -it -v $2:/notebooks -p 8888:8888 -p 6006:6006 $1\n```\n\nor, for GPU support\n\n```sh\nnvidia-docker run -it -v $2:/notebooks -p 8888:8888 -p 6006:6006 $1\n```\n\nwhere:\n\n* `$1` is the tag for a docker image, e.g. `wqael/notebooks:latest`.\n* `$2` is the folder containing the notebooks on the host file system, e.g. clone this repo and use `~/notebooks`.\n\n\n**Step 3**: From the log, copy-and-paste the line similar to the following to your favorite browser:\n\n```\n    Copy/paste this URL into your browser when you connect for the first time,\n    to login with a token:\n        http://localhost:8888/?token=\u003ctoken string\u003e\n```\n\n**Bonus step**: Use next generation [Jupyter](http://jupyterlab.readthedocs.io/en/latest/):\n\nAfter jupyter home page is loaded, i.e. `http://localhost:8888/tree`, browse to `http://localhost:8888/lab`.\n\n![jupyter_lab_screenshot](assets/jupyter_lab.jpg)\n\n**Step 4**: How to shutdown the docker image:\n\nIn the running image terminal (step 3), hit Ctrl+C **twice**.\n\n\n## Citation\n\nIf this project helps your research, don't hesitate to spread the word! Click on the badge below and find citation formats (e.g., BibTeX and etc) at the bottom of that page.\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.11311585.svg)](https://doi.org/10.5281/zenodo.11311585)\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frlan%2Fnotebooks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frlan%2Fnotebooks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frlan%2Fnotebooks/lists"}