Skip to content
Public template

About

From Jupyter Notebook to Desktop App in One Click

Resources

Contributing

Stars

12 stars

Watchers

0 watching

Forks

Repository files navigation

LabConstrictor

DOI

LabConstrictor Comic

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/

Who is it for?

  • 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.

What your users get

An installed LabConstrictor app: installer, Welcome notebook and a notebook with hidden code

  • 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.

Quick start

You need a GitHub account and the notebooks you want to share. Read Before getting started first, then:

  1. Create a new repository from this template
  2. Enable automatic template updates
  3. Initialise your repository with the web form
  4. Upload external code (optional)
  5. Upload your notebooks
  6. Create the installers

The same guides, with pictures and a search box, are on the website.

Go further

Contributing and questions

Bug fixes and improvements are welcome: read the contributing guidelines. Using LabConstrictor, or stuck? Open an issue.

Citation

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

About

From Jupyter Notebook to Desktop App in One Click

Resources

Contributing

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages