Packaging Jupyter notebooks as installable desktop apps using LabConstrictor
Iván Hidalgo-Cenalmor, Marcela Xiomara Rivera Pineda, Bruno M. Saraiva, Ricardo Henriques, Guillaume Jacquemet · 2026
Read Packaging Jupyter notebooks as installable desktop apps using LabConstrictor by Iván Hidalgo-Cenalmor, Marcela Xiomara Rivera Pineda, Bruno M. Saraiva, Ricardo Henriques, Guillaume Jacquemet (2026) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2603-10704.txt.
Introduction
Iván Hidalgo-Cenalmor and co-authors present LabConstrictor, a tool that packages Jupyter notebooks as desktop apps for life sciences researchers. Notebooks are popular and fast to develop in, but fragile setups and hard sharing keep academic software underused. LabConstrictor brings CI/CD-style automation to developers with no DevOps background: a GitHub pipeline checks setups and builds one-click installers. After installation, a start page gathers documentation, links, and version checks, while hidden code cells and widgets give an app-like feel.
Catalog record
| CREATOR | Iván Hidalgo-Cenalmor, Marcela Xiomara Rivera Pineda, Bruno M. Saraiva, Ricardo Henriques, Guillaume Jacquemet |
|---|---|
| YEAR | 2026 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 24271 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2603.10704
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
Packaging Jupyter notebooks as installable desktop apps using LabConstrictor Iván Hidalgo-Cenalmor, Marcela Xiomara Rivera Pineda, Bruno M. Saraiva, Ricardo Henriques, Guillaume Jacquemet Abstract Life sciences research depends heavily on open-source academic software, yet many tools remain underused due to practical barriers. These include installation requirements that hinder adoption and limited developer resources for software distribution and long-term maintenance. Jupyter notebooks are popular because they combine code, documentation, and results into a single executable document, enabling quick method development. However, notebooks are often fragile due to reproducibility issues in coding environments, and sharing them, especially for local execution, does not ensure others can run them successfully. LabConstrictor closes this deployment gap by bringing CI/CD-style automation to academic developers without needing DevOps expertise. Its GitHub-based pipeline checks environments and packages notebooks into one-click installable desktop applications. After installation, users access a unified start page with documentation, links to the packaged notebooks, and version checks. Code cells can be hidden by default, and run-cell controls combined with widgets provide an app-like experience. By simplifying the distribution, installation, and sharing of open-source software, LabConstrictor allows faster access to new computational methods and promotes routine reuse across labs. \leadauthor Hidalgo-Cenalmor LabConstrictor keywords Jupyter Notebook | Reproducibility | Software Packaging | User-Friendly {corrauthor} (G. Jacquemet) Introduction Open-source academic software has become essential to life sciences research. It facilitates the collection, storage, analysis, visualisation, and sharing of data. Microscopy is a key example: modern imaging routinely produces large, complex datasets, including 3D volumes, multiplexed acquisitions, and time-lapse movies. The amount of information that can be extracted from these data continues to grow as image analysis methods advance. Extracting quantitative biological insights from data involves navigating a broad, rapidly evolving software ecosystem, ranging from well-known graphical applications such as Fiji ( 12 ) or QuPath ( 2 ) to research code available as Python toolboxes ( 16 ; 14 ; 13 ) . State-of-the-art image analysis algorithms, especially AI-driven methods, are often implemented in Python because it allows quick iteration and easy reuse of community libraries. However, Python-based tools can be hard for non-experts to use in practice because they often require installing and managing complex dependencies across different operating systems. At the same time, many academic developers lack the resources to package, distribute, and maintain user-friendly software, which widens the gap between rapid method development and everyday real-world application. Therefore, the impact of software depends not only on creating better algorithms but also on making sure others can easily install it and that it continues to work over time. Figure 1: LabConstrictor overview. High-level schema showing how developer inputs (Jupyter notebooks, optional external Python code, and dependency specifications) populate a GitHub template repository to produce OS-specific installers, a desktop application, and a guided notebook experience in JupyterLab. Jupyter notebooks offer a practical balance between rapid development and dissemination. By combining code, narrative explanations, and outputs within a single executable document, notebooks facilitate the presentation of the full analysis workflow and support more guided interaction ( 7 ) . Tools such as ipywidgets, EZInput ( 11 ) , and marimo enable developers to expose parameters and controls, thereby minimising the need for users to modify code directly. Consequently, notebooks have become a common format for sharing computational approaches in data science and increasingly in the life sciences. However, “sharing a notebook” does not necessarily mean it is reusable: a notebook that functions for its author might not work elsewhere due to differences in operating systems, Python versions, or library dependencies ( 9 ; 8 ; 10 ) . Cloud platforms such as Binder ( 5 ) and Google Colab lower initial barriers by providing ready-to-use environments in the browser. Tools built on Google Colab, including ZeroCostDL4Mic ( 15 ) , CellTracksColab ( 3 ) , and ColabFold ( 6 ) , have supported many research projects. However, cloud execution is not always feasible when clinical data and other sensitive microscopy datasets cannot leave institutional firewalls due to privacy, governance, or compliance requirements. In addition, many imaging datasets are simply too large and complex to upload to cloud resources (e.g., 3D volumes or entire pathology slides). In these cases, researchers still require reliable methods for running notebook-based workflows reproducibly on local or institutional infrastructure. Several efforts aim to enhance the local reproducibility and accessibility of notebook workflows, including DL4MicEverywhere ( 4 ) , JupyterLab Desktop, and album ( 1 ) . DL4MicEverywhere packages notebooks using Docker to improve stability and portability, but Docker can introduce setup and operational complexity (e.g., resource management and GPU configuration) and is sometimes constrained by institutional IT and security policies. JupyterLab Desktop makes it easy to launch notebooks, but users still need to manage Python environments. Album supports cross-platform sharing of scientific software, yet preparing tools for distribution can still require significant developer time and familiarity with packaging conventions. Here, we present LabConstrictor, a framework that reduces practical barriers by packaging and distributing Jupyter notebooks as installable desktop applications (Fig. 1 ). For developers, LabConstrictor offers a well-documented, zero-command-line workflow built around Continuous Integration (CI) and Continuous Deployment (CD) automation for validation, packaging, and releases (Fig. 2 A). For end users, it delivers an installation and launch experience that feels more like using a standalone application than managing a Python environment (Fig. 2 B). Making notebooks easy to package and install Figure 2: LabConstrictor workflow for developers and end-users. ( A ) Authors prepare notebooks (and optional assets), initialize a custom repository from the LabConstrictor template, generate or curate requirements, and submit notebooks and dependencies through web forms (steps 1–5). GitHub Actions automate validation, notebook formatting, and environment setup (step A), and handle release packaging and generate installers for Windows, macOS, and Linux (step B). ( B ) End users install the desktop app via a standard installer, launch a local JupyterLab session with a welcome notebook for navigation, and run notebooks with reduced code exposure and simple execution controls. LabConstrictor is designed for notebook authors who want to distribute a functional workflow without converting it into a full software project with a dedicated graphical interface. It is shared as a GitHub template repository with a predefined structure, starter documentation, and automated GitHub Actions that manage most validation and packaging steps (see Automation in Fig. 2 A). Developers mainly interact with the setup and packaging processes via the GitHub web interface and a web-based configuration form. These interfaces are used to set repository-specific options (including basic branding), manage notebooks and their dependencies, and create releases with the corresponding executables (see Developer pipeline in Fig. 2 A). Converting a notebook into an installable app requires minimal direct code editing and follows simple, guided steps. Additionally, to support dependency specification, which is often one of the most time-consuming parts, LabConstrictor provides a helper notebook that assesses the environment where the notebook runs (locally or online) to generate an initial requirements file, which can then be refined and validated. LabConstrictor also offers documentation and suggestions to adapt notebooks originally built for Google Colab (e.g., handling paths and environment-specific user interfaces) so they can run smoothly in a local environment. Finally, LabConstrictor enables developers to include external Python code alongside notebooks to share functionality across multiple workflows. A