Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/maastrichtu-ids/jupyterlab

🪐 JupyterLab + VisualStudio Code workspaces for data science and knowledge graphs
https://github.com/maastrichtu-ids/jupyterlab

cloud-computing dsri jupyter jupyter-notebook jupyterhub jupyterlab kubernetes openshift visual-studio-code vscode

Last synced: 1 day ago
JSON representation

🪐 JupyterLab + VisualStudio Code workspaces for data science and knowledge graphs

Host: GitHub
URL: https://github.com/maastrichtu-ids/jupyterlab
Owner: MaastrichtU-IDS
License: mit
Created: 2020-09-30T09:29:01.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2024-10-16T12:14:16.000Z (2 months ago)
Last Synced: 2024-12-16T00:14:09.853Z (7 days ago)
Topics: cloud-computing, dsri, jupyter, jupyter-notebook, jupyterhub, jupyterlab, kubernetes, openshift, visual-studio-code, vscode
Language: Dockerfile
Homepage:
Size: 693 KB
Stars: 40
Watchers: 7
Forks: 22
Open Issues: 1
Metadata Files:
- Readme: README.ipynb
- License: LICENSE

Awesome Lists containing this project

README

{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# 📊 Workspace for Data Science\n",
"\n",
"You can use either JupyterLab or VisualStudio Code through your browser to access the workspace, switch to VSCode by clicking on its button on the JupyterLab Launcher page.\n",
"\n",
"Use the `persistent` folder in the workspace to store data and code persistently. Note that on some system, like the DSRI, it is slower to read and write data in this folder. So you might want to use another folder in the workspace for faster read/write. The data stored in other folders will be lost if the notebook container is restarted or stopped.\n",
"\n",
"## 📥️ Install dependencies\n",
"\n",
"We highly recommend to store the dependencies you install in files in the `persistent` folder (e.g. `env.yml`, `requirements.txt`), and to have a `install.sh` script in the persistent folder to reinstall everything easily in case the container is restarted. \n",
"\n",
"### 🐍 Install conda packages\n",
"\n",
"You can use `conda` or `mamba` to install conda packages. Mamba is a reimplementation of conda in C++ that makes it much faster, every commands used in conda work in mamba, you just need to replace conda by mamba at the start of the command. \n",
"\n",
"```bash\n",
"mamba install plotly\n",
"```\n",
"\n",
"⚠️ If `mamba` does not work for you, then use `conda`\n",
"\n",
"If you need to use a different python version than the one used by default in the container you can create a new environment with the python version you need. Note that you will be able to easily start notebooks using installed conda environments from the JupyterLab Launcher page if you install `nb_conda_kernels` and `ipykernel` in the new environment.\n",
"\n",
"For example, to use python 3.6 a new env named `py36`, your `env.yml` should look like this, you can add more conda and pip packages to install:\n",
"\n",
"```yaml\n",
"name: py36\n",
"channels:\n",
" - defaults\n",
" - conda-forge\n",
" - anaconda\n",
"dependencies:\n",
" - python=3.6\n",
" - ipykernel \n",
" - nb_conda_kernels\n",
" - pip\n",
"```\n",
"\n",
"You can add more `pip` packages by adding this to the dependencies:\n",
"\n",
"```yaml\n",
" - pip:\n",
" - your-pip-package\n",
"```\n",
"\n",
"Once your environment has been defined, you can create it:\n",
"\n",
"```bash\n",
"mamba env create -f env.yml\n",
"```\n",
"\n",
"A new tile to create a notebook with your custom conda environment should appear after a minute in the JupyterLab launcher page.\n",
"\n",
"⚠️ You cannot use `conda activate` in a Docker container, so you will need to either open a notebook using the kernel for your conda env, or use `conda run` to run scripts in the new environment:\n",
"\n",
"```bash\n",
"mamba run -n py36 python --version\n",
"```\n",
"\n",
"\n",
"### 🐍 Install pip packages\n",
"\n",
"Install Python packages with `pip`:\n",
"\n",
"```bash\n",
"pip install -r requirements.txt\n",
"```\n",
"\n",
"### 📦️ Install apt packages\n",
"\n",
"If `sudo` has been enabled in the container you can install packages with the `apt` package manager:\n",
"\n",
"```bash\n",
"sudo apt install -y wget\n",
"```\n",
"\n",
"## ℹ️ About the image\n",
"\n",
"You can find more details about this container image at https://github.com/MaastrichtU-IDS/jupyterlab"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3.10.5 64-bit",
"language": "python",
"name": "python3"
},
"language_info": {
"name": "python",
"version": "3.10.5"
},
"orig_nbformat": 4,
"vscode": {
"interpreter": {
"hash": "767d51c1340bd893661ea55ea3124f6de3c7a262a8b4abca0554b478b1e2ff90"
}
}
},
"nbformat": 4,
"nbformat_minor": 2
}