About pyparamgui

PyParamGUI is a first attempt to bring the interactive teaching experience of the R-based paramGUI package into the Python ecosystem. It uses pyglotaran as its backend and provides Jupyter notebook widgets for simulating data, visualising results, and generating model files.

Rough draft. PyParamGUI is pre-alpha and not yet published to PyPI. It was created as a minimum-viable concept during a student project and should be considered experimental. Expect missing features and breaking changes.

Relationship to paramGUI

paramGUI is the stable, CRAN-published R/Shiny application for teaching parameter estimation — built on top of TIMP. PyParamGUI aims to eventually offer a similar experience using pyglotaran instead of TIMP, but it is not yet a replacement.

Running with uv

Because the package is not yet on PyPI, install it directly from GitHub. The easiest way is a one-off ephemeral session with uv:

uv run --with "pyparamgui @ git+https://github.com/glotaran/pyparamgui" --with jupyter jupyter lab

Then inside a notebook:

from pyparamgui import Widget

widget = Widget()
widget

Alternatively, add it to a project environment:

uv pip install "pyparamgui @ git+https://github.com/glotaran/pyparamgui"