{"id":16751729,"url":"https://github.com/jakoch/jupyter-devbox","last_synced_at":"2026-01-16T06:54:32.606Z","repository":{"id":142593079,"uuid":"326196377","full_name":"jakoch/jupyter-devbox","owner":"jakoch","description":"A Docker-based devcontainer for Jupyter Notebook's with a focus on Computer Vision, Machine Learning, Finance, Statistics and Visualization.","archived":false,"fork":false,"pushed_at":"2025-02-27T02:02:36.000Z","size":606,"stargazers_count":20,"open_issues_count":2,"forks_count":13,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-18T05:51:14.609Z","etag":null,"topics":["debian","devcontainer","docker","imutils","jupyter-notebook","keras","opencv","pandas","python3","scikit-learn","scipy","seaborn","tensorflow"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","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/jakoch.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"jakoch"}},"created_at":"2021-01-02T14:10:09.000Z","updated_at":"2025-02-27T02:02:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"f92e601b-019f-40f3-9b84-e1da79dd9326","html_url":"https://github.com/jakoch/jupyter-devbox","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakoch%2Fjupyter-devbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakoch%2Fjupyter-devbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakoch%2Fjupyter-devbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakoch%2Fjupyter-devbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jakoch","download_url":"https://codeload.github.com/jakoch/jupyter-devbox/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244880451,"owners_count":20525507,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["debian","devcontainer","docker","imutils","jupyter-notebook","keras","opencv","pandas","python3","scikit-learn","scipy","seaborn","tensorflow"],"created_at":"2024-10-13T02:44:44.844Z","updated_at":"2025-03-21T22:32:09.206Z","avatar_url":"https://github.com/jakoch.png","language":"Jupyter Notebook","funding_links":["https://github.com/sponsors/jakoch"],"categories":[],"sub_categories":[],"readme":"# jupyter-devbox [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/jakoch/jupyter-devbox/release.yml?branch=main\u0026style=flat\u0026logo=github\u0026label=Image%20published%20on%20GHCR)](https://github.com/jakoch/jupyter-devbox) ![Latest Version](https://ghcr-badge.egpl.dev/jakoch/jupyter-devbox/latest_tag?trim=major\u0026label=latest+version\u0026ignore=sha*) ![Image Size](https://ghcr-badge.egpl.dev/jakoch/jupyter-devbox/size?color=%2344cc11\u0026tag=latest\u0026label=image+size\u0026trim=)\n\nA Docker development box for [Jupyter Notebooks][jupyter_website] with a focus on\nComputer Vision, Machine Learning, Finance, Statistics and Visualization.\n\nThe following sections describe the container images, including their packages,\nhow to build or download them, and how to set them up.\n\n#### What is this?\n\nThis is a Docker container supporting multiple architectures based on Debian Linux ([amd64][amd64_dockerfile] \u0026 [arm64][arm64_dockerfile]).\n\nIt sets up an Jupyter Notebook development environment for interactive Python programming for [Visual Studio Code][vscode_website].\n\nIt has preinstalled scientific computing packages (including OpenCV, Tensorflow, Keras, Numpy, Pandas, DuckDB,\nSklearn, Scipy, Matplotlib, Seaborn, Imutils, SqlAlchemy).\n\nThe images of this repository are available on Github Container Registry (GHCR).\n\n#### What is pre-installed?\n\nBase: Debian 12 - Bookworm\n\nOn top of the base image the following tools are installed:\n\n- zsh, git, cmake, nano\n- curl, wget\n- imagemagick, gnuplot, graphviz\n\nThese programming languages are included:\n\n- Python 3 (including  pip, setuptools, wheel, venv)\n- C \u0026 C++ (g++)\n\nThe installed Python libraries are:\n\n- jupyter ipykernel docutils pyyaml pylint\n- h5py\n- tensorflow keras\n- pandas pandas-datareader\n- duckdb\n- numpy scipy sklearn\n- matplotlib seaborn plotly graphviz\n- opencv-python-headless\n- imutils\n- sqlalchemy\n- pyautogui\n- yfinance alpha_vantage nasdaq-data-link\n- financetoolkit financedatabase\n- statsmodels\n- requests_cache\n\nYou can find a list of all installed packages in the [notebooks/check_devbox.ipynb][check_devbox_ipynb_main] Notebook.\n\n#### Prerequisites\n\nYou need the following things to run this:\n\n- Docker\n- Visual Studio Code\n\n#### How to run this?\n\nThere are two ways of setting the container up.\n\nEither by building the container image locally or by fetching the prebuilt container image from the Github container registry.\n\n##### Building the Container Image locally using VSCode\n\n- **Step 1.** Get the source: clone this repository using git or download the zip\n\n- **Step 2. (optional)** The repository contains multiple images.\n\n  You select an image by modifying the `dockerFile` to use in `./devcontainer/devcontainer.json`:\n\n  By default `\"dockerFile\": \"amd64/Dockerfile\"` is set.\n\n  For an image with architecture:\n  - amd64 set `amd64/Dockerfile`\n  - arm64, aarch64, arm64v8 set `arm64v8/Dockerfile`\n\n- **Step 3.** In VSCode open the folder in a container (`Remote Containers: Open Folder in Container`):\n\n  This will build the container image (`Starting Dev Container (show log): Building image..`)\n\n  Which takes a while...\n\n  Then, finally...\n\n- **Step 4.** Open the file `notebooks\\test.ipynb`\n\n- **Step 5.** You might get a warning message for \"untrusted\" Notebook content.\n\n  Click `Trust` to allow running the content of the Notebook.\n\n- **Step 6.** You are now able to edit cells and run their content interactively in VSCode.\n\n  You might also run your scripts inside your browser at http://localhost:8888/\n\n- Enjoy! :sunglasses:\n\n##### Fetching the prebuilt container image\n\nThis container image is published to the Github Container Registry (GHCR).\n\nYou may find the package here: [https://github.com/jakoch/jupyter-devbox/pkgs/container/jupyter-devbox][github_packages].\n\nYou can install the container image from the command line:\n\n```bash\ndocker pull ghcr.io/jakoch/jupyter-devbox:latest\n```\n\nYou might also use this container image as a base image in your own Dockerfile:\n\n```bash\nFROM ghcr.io/jakoch/jupyter-devbox:latest\n```\n\n## Supported CPU Architectures\n\n- x86_64 - linux/amd64\n  - [./devcontainer/amd64/Dockerfile][amd64_dockerfile]\n- aarch64 - linux/aarch64, linux/arm64/v8, linux/arm64v8\n  - [./devcontainer/arm64v8/Dockerfile][arm64_dockerfile]\n- not supported:\n  - armel\n  - armhf, linux/arm64/v7, linux/arm64v7\n\n- You can check your platform and available features with\n  - `dpkg --print-architecture`\n  - `cat /proc/cpuinfo`\n\n\u003c!-- Section for Reference Links --\u003e\n\n[jupyter_website]:https://jupyter.org/\n[vscode_website]:https://code.visualstudio.com/\n[check_devbox_ipynb_main]:https://github.com/jakoch/jupyter-devbox/blob/main/notebooks/check_devbox.ipynb\n[amd64_dockerfile]:https://github.com/jakoch/jupyter-devbox/blob/main/.devcontainer/amd64/Dockerfile\n[arm64_dockerfile]:https://github.com/jakoch/jupyter-devbox/blob/main/.devcontainer/arm64/Dockerfile\n[github_packages]: https://github.com/jakoch/jupyter-devbox/pkgs/container/jupyter-devbox\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakoch%2Fjupyter-devbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjakoch%2Fjupyter-devbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakoch%2Fjupyter-devbox/lists"}