LabConstrictor turns your Jupyter notebooks into desktop apps that anyone can install. Your users download an installer, double-click, and work. They need no Python, no pip and no terminal.
This repository is a GitHub template. You bring the notebooks; it builds the installers for Windows, macOS and Linux, and gives the app a Welcome page that lists your notebooks.
Website, guides and ready-made apps: https://cellmigrationlab.github.io/LabConstrictor-Site/
- Researchers who want colleagues to run an analysis without setting up Python.
- Developers who ship interactive notebooks to people who do not code.
- Teachers who want a workshop to start with a double-click.
Looking for an app to use, not to build? Go to the App Centre.
- An installer for their system:
.exe(Windows),.pkg(macOS) or.sh(Linux). - A Welcome notebook that opens in the browser and lists the app's notebooks.
- Notebooks with the code hidden, so they look like an app. The code can be shown again.
- A notice when a newer version of the app is available.
You need a GitHub account and the notebooks you want to share. Read Before getting started first, then:
- Create a new repository from this template
- Enable automatic template updates
- Initialise your repository with the web form
- Upload external code (optional)
- Upload your notebooks
- Create the installers
The same guides, with pictures and a search box, are on the website.
- List your app in the App Centre
- Offer your app's functions in napari, Fiji and QuPath
- Write notebooks that run in both Colab and JupyterLab
- All guides
Bug fixes and improvements are welcome: read the contributing guidelines. Using LabConstrictor, or stuck? Open an issue.
If you use LabConstrictor in your research, please cite the project to support its development:
Iván Hidalgo-Cenalmor, Marcela Xiomara Rivera Pineda, Bruno M. Saraiva, Ricardo Henriques, and Guillaume Jacquemet. Packaging Jupyter notebooks as installable desktop apps using LabConstrictor. arXiv preprint 2026 DOI: https://doi.org/10.48550/arXiv.2603.10704

