Installation

Installation

The PyPI distribution name is quantized-lab (plain quantized was squatted by an unrelated abandoned package). Everything else — the importable package and the commands — is plain quantized / qz.

Pick one

Method	Command	Notes
pipx (recommended)	pipx install quantized-lab	isolated env, qz on PATH
uv tool	uv tool install quantized-lab	same idea, via uv
pip	pip install quantized-lab	into the active environment
Native installer	Releases	Windows .exe (auto-updating NSIS), macOS .dmg, Linux .deb — no Python needed

Requires Python ≥ 3.11 for the pip routes. Optional extras: quantized-lab[desktop] (native pywebview window), quantized-lab[office] (.docx/.pptx report export), quantized-lab[bumps] (DREAM posterior fitting), quantized-lab[origin-com] (Windows-only live "Send to Origin").

Running

qz                 # serve on :8000 + open a browser tab
qz --port 9000     # different port
qz --no-browser    # headless server (never auto-exits)
qz --desktop       # native window (needs the [desktop] extra)
qz --dev           # contributor mode: Vite HMR + reloading backend
diraculator        # the materials calculators, standalone
diraculator --desktop   # ...as a small native window

Behavior worth knowing:

• Closing the last browser tab shuts the server down (a refresh doesn't). Opt out with QZ_AUTO_SHUTDOWN=0, or use --no-browser.
• A busy port falls back to a free one automatically (with a printed note) unless you passed --port explicitly — so the full app and a standalone DiraCulator run side by side without fuss.
• The Windows installer adds two Start Menu entries: Quantized and DiraCulator. Installed apps pick up new releases on next launch (auto-update).