[{"_1":2,"_182":-5,"_183":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_157":158},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_98":-5,"_99":100,"_146":-5,"_147":11,"_148":21,"_149":11,"_150":-5,"_151":11,"_152":-5,"_153":154,"_155":101,"_156":-7},"canonicalUrl","https://hub.docker.com/r/sahajs59/labx/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","sahajs59","reponame","labx","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_53":54,"_56":57,"_58":59,"_60":11,"_61":62,"_63":64,"_65":66,"_43":35,"_32":33,"_68":69,"_70":-5,"_71":72,"_73":74,"_75":76,"_77":-5,"_78":72,"_79":80,"_81":11,"_82":33,"_83":84,"_89":11,"_90":91,"_95":33,"_96":97},"categories",[42,47,50],{"_43":44,"_45":46},"name","Languages & frameworks","slug","languages-and-frameworks",{"_43":48,"_45":49},"Machine learning & AI","machine-learning-and-ai",{"_43":51,"_45":52},"Data science","data-science","content_types",[55],"image","date_registered","2026-08-11T18:46:33.366244Z","description","Self-contained Python lab with JupyterLab + VS Code IDE in a single Docker container.","is_private","last_updated","2026-08-11T18:46:34.933439Z","last_modified","2026-08-12T00:49:50.893122Z","media_types",[67],"application/vnd.oci.image.index.v1+json","pull_count",83,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

LabX

\n\n

A self-contained, Docker-powered Python development environment combining JupyterLab and a VS Code-compatible browser IDE in a single container.

\n\n

\n $\"Python$ \n $\"JupyterLab$ \n $\"code-server$ \n $\"Docker\"/$ \n $\"MIT$ \n

\n\n\n---\n\n## 🧪 What is LabX?\n\n**LabX** is a batteries-included Python lab environment that runs entirely inside Docker. With a single command you get:\n\n| Tool | URL | Purpose |\n|---|---|---|\n| **JupyterLab** | `http://localhost:5959` | Interactive notebooks & data exploration |\n| **LabX-Server** (code-server) | `http://localhost:5960` | Full VS Code IDE in the browser |\n\nBoth services share the same Python environment and `/workspace` directory, so code you write in one is immediately available in the other.\n\n---\n\n## ✨ Features\n\n- 🐍 **Python 3.11.9** on a slim Debian (Bookworm) base\n- 📓 **JupyterLab 4.6.2** with the *Simpledark* theme pre-configured\n- 🖥️ **LabX-Server** (code-server 4.132.0) with custom branding, login strings, and a curated set of pre-installed VS Code extensions\n- 📦 **Rich Python package stack** — NumPy, Pandas, Scikit-learn, PyTorch-ready (Keras, Transformers, Accelerate), OpenCV, NLTK, spaCy, MLflow, W&B, Stable-Baselines3, Gymnasium, and more\n- 🔑 **Password-protected** — both services require authentication (default password configurable via env var)\n- 🎨 **Custom branding** — LabX logo replaces all code-server icons and favicons\n- 🔧 **17 pre-bundled VS Code extensions** installed offline from `.vsix` files, including Python, Jupyter, Prettier, Rainbow CSV, Database Client, Code Runner, and several themes\n- 🏗️ **Multi-arch** — supports `linux/amd64` and `linux/arm64`\n- 📁 **Persistent workspace** — mount a host directory to `/workspace` and your files persist across container restarts\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- [Docker](https://docs.docker.com/get-docker/) installed and running\n\n### 1 — Pull & Run (once published to a registry)\n\n```bash\ndocker run -d \\\n --name labx \\\n -p 5959:5959 \\\n -p 5960:5960 \\\n -v \"$(pwd)/workspace:/workspace\" \\\n -e LABX_PASSWORD=mysecretpassword \\\n labx:latest\n```\n\n### 2 — Build from Source\n\n```bash\ngit clone https://github.com//labx.git\ncd labx\n\ndocker build -t labx:latest .\n```\n\nThen run the container:\n\n```bash\ndocker run -d \\\n --name labx \\\n -p 5959:5959 \\\n -p 5960:5960 \\\n -v \"$(pwd)/workspace:/workspace\" \\\n -e LABX_PASSWORD=mysecretpassword \\\n labx:latest\n```\n\n### 3 — Open in your browser\n\n| Service | URL |\n|---|---|\n| JupyterLab | [http://localhost:5959](http://localhost:5959) |\n| LabX-Server | [http://localhost:5960](http://localhost:5960) |\n\nLogin with the password you set via `LABX_PASSWORD` (default: `labx@123`).\n\n---\n\n## ⚙️ Configuration\n\n| Environment Variable | Default | Description |\n|---|---|---|\n| `LABX_PASSWORD` | `labx@123` | Shared password for both JupyterLab and LabX-Server |\n\n> **Tip:** Always set a strong custom password in production. Pass it with `-e LABX_PASSWORD=` when running the container.\n\n---\n\n## 🐳 Docker Compose (recommended)\n\nCreate a `docker-compose.yml` in your project directory:\n\n```yaml\nservices:\n labx:\n image: labx:latest\n container_name: labx\n ports:\n - \"5959:5959\" # JupyterLab\n - \"5960:5960\" # LabX-Server\n volumes:\n - ./workspace:/workspace\n environment:\n - LABX_PASSWORD=mysecretpassword\n restart: unless-stopped\n```\n\nThen start with:\n\n```bash\ndocker compose up -d\n```\n\n---\n\n## 📦 Pre-installed Python Packages\n\n

Click to expand full package list

\n\n| Category | Packages |\n|---|---|\n| **Core Science** | NumPy, SciPy, SymPy, Pandas |\n| **Visualisation** | Matplotlib, Seaborn, Plotly |\n| **Machine Learning** | Scikit-learn, MLflow, W&B (Weights & Biases) |\n| **Deep Learning** | Keras, Transformers, Tokenizers, SentencePiece, Accelerate, Evaluate, Datasets |\n| **Reinforcement Learning** | Gymnasium, Stable-Baselines3 |\n| **Computer Vision** | OpenCV, Pillow, scikit-image, imageio |\n| **NLP** | NLTK, spaCy, Gensim |\n| **Utilities** | tqdm, joblib, requests, PyYAML, openpyxl, h5py, ipywidgets |\n\n

\n\n---\n\n## 🔌 Pre-installed VS Code Extensions\n\n| Extension | Purpose |\n|---|---|\n| `ms-python.python` | Python language support |\n| `ms-toolsai.jupyter-hub` | JupyterHub integration |\n| `ms-toolsai.jupyter-renderers` | Rich notebook output renderers |\n| `formulahendry.code-runner` | Run code snippets in terminal |\n| `esbenp.prettier-vscode` | Code formatter |\n| `mechatroner.rainbow-csv` | Colourised CSV editing |\n| `cweijan.vscode-database-client2` | Universal database GUI |\n| `buvan.sql-crack` | SQL query runner |\n| `ChristofKaufmann.dataframe-viewer` | DataFrame visual explorer |\n| `julien-.terminal-file-actions` | File actions from terminal |\n| `yandeu.five-server` | Live HTML/Markdown preview |\n| `tuld01061.md-live-server` | Markdown live server |\n| `the-long-ride.markdown-them` | Markdown theme |\n| `Rafael-Avalos.dark-colors-theme` | Dark colour theme |\n| `darkmusic.carbon-rewind-theme` | Carbon rewind theme |\n| `mszylkowski.materialsymbols` | Material symbols icon font |\n| `ryohidaka.github-actions-branding-preview` | GitHub Actions branding preview |\n\n---\n\n## 📁 Repository Structure\n\n```\nlabx/\n├── Dockerfile # Main multi-stage Docker build\n├── start.sh # Container entrypoint — starts JupyterLab & LabX-Server\n├── requirements.txt # Top-level Python package list (unpinned)\n├── requirements-linux.txt # Fully pinned package list for Linux/Docker\n├── branding/\n│ └── logo.png # LabX logo (applied to code-server UI)\n├── jupyter/\n│ └── overrides.json # JupyterLab default theme settings\n└── vscode/\n ├── settings.json # Default VS Code / code-server user settings\n └── vsix/ # Pre-bundled VS Code extensions (.vsix)\n```\n\n---\n\n## 🛠️ Ports Reference\n\n| Port | Service | Notes |\n|---|---|---|\n| `5959` | JupyterLab | Mapped to the same host port |\n| `5960` | LabX-Server | Mapped to the same host port |\n\n---\n\n## 🏗️ Building for Multiple Architectures\n\nUse Docker Buildx to build for both `amd64` and `arm64`:\n\n```bash\ndocker buildx build \\\n --platform linux/amd64,linux/arm64 \\\n -t labx:latest \\\n --push .\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Here are a few ways to help:\n\n1. **Fork** the repository\n2. **Create** a feature branch (`git checkout -b feature/my-feature`)\n3. **Commit** your changes (`git commit -m \"feat: add my feature\"`)\n4. **Push** to your branch (`git push origin feature/my-feature`)\n5. **Open** a Pull Request\n\nPlease keep commits focused and descriptive.\n\n---\n\n## 📄 License\n\nThis project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.\n\n---\n\n

\n _{Built with ❤️ by the LabX Contributors}\n

\n","has_starred","hub_user","immutable_tags_settings",{"_85":11,"_86":87},"enabled","rules",[88],".*","is_automated","permissions",{"_92":21,"_93":11,"_94":11},"read","write","admin","user","storage_size",4185583834,"orgData","recentTags",[101],{"_102":55,"_103":104,"_105":106,"_107":108,"_109":110,"_111":112,"_61":135,"_136":104,"_137":33,"_138":67,"_43":139,"_140":141,"_142":120,"_143":135,"_144":76,"_145":21},"content_type","creator",43878604,"digest","sha256:116059236835e6ced7649a71f222b71979c09e1387d5be00a8f6fffb0b9b2fbc","full_size",4185557679,"id",1266886967,"images",[113,129],{"_114":115,"_105":116,"_117":118,"_119":120,"_121":122,"_123":124,"_125":118,"_126":-5,"_127":108,"_73":76,"_128":-5},"architecture","amd64","sha256:c7dff343494f0e1216011139c53a0febd5f371f003d8c43f6cb1ab2214c957ac","features","","last_pulled","2026-10-04T07:29:04.296876571Z","last_pushed","2026-08-11T18:46:32.924337839Z","os","linux","os_features","os_version","size","variant",{"_114":130,"_105":131,"_117":118,"_119":132,"_121":133,"_123":130,"_125":118,"_126":-5,"_127":134,"_73":76,"_128":-5},"unknown","sha256:0d497d95f96fb2051cffea7ffa85eb3d6cbfebf4dfd3493fdaa019e813456a96","2026-09-27T20:40:46.432048782Z","2026-08-11T18:46:32.906754935Z",1411,"2026-08-11T18:46:34.345476Z","last_updater","last_updater_username","media_type","v1.0","repository",32113534,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":159,"_169":170,"_153":180,"_181":11},{"_40":160,"_53":164,"_56":57,"_58":59,"_60":11,"_61":62,"_63":64,"_65":165,"_43":35,"_32":33,"_68":69,"_70":-5,"_71":72,"_73":74,"_75":76,"_77":-5,"_78":72,"_79":80,"_81":11,"_82":33,"_83":166,"_89":11,"_90":168,"_95":33,"_96":97},[161,162,163],{"_43":44,"_45":46},{"_43":48,"_45":49},{"_43":51,"_45":52},[55],[67],{"_85":11,"_86":167},[88],{"_92":21,"_93":11,"_94":11},"tags",{"_171":74,"_172":-5,"_173":-5,"_174":175},"count","next","previous","results",[176],{"_102":55,"_103":104,"_105":106,"_107":108,"_109":110,"_111":177,"_61":135,"_136":104,"_137":33,"_138":67,"_43":139,"_140":141,"_142":120,"_143":135,"_144":76,"_145":21},[178,179],{"_114":115,"_105":116,"_117":118,"_119":120,"_121":122,"_123":124,"_125":118,"_126":-5,"_127":108,"_73":76,"_128":-5},{"_114":130,"_105":131,"_117":118,"_119":132,"_121":133,"_123":130,"_125":118,"_126":-5,"_127":134,"_73":76,"_128":-5},[],"canDeleteTags","actionData","errors"]

sahajs59/labx

Tags for sahajs59/labx