Skip to content

About

LabScribber is a Python-based scientific analysis platform for processing spectra, detecting and fitting peaks, performing multivariate analysis, and generating publication-ready figures and reports.

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

LabScribber — scientific spectroscopy workstation

CI License: MIT Tests Node Cite

Download  ·  Quick start  ·  Capabilities  ·  Quality  ·  Roadmap  ·  Citing


LabScribber is a browser-based, Electron-packaged workstation for academic spectroscopy. It takes instrument data through baseline correction, peak deconvolution, chemometrics and journal-grade export in one application, and is backed by an automated suite of 187 tests covering numerical routines and UI behaviour.


Analysis workflow: import, baseline, peaks, deconvolve, chemometrics, report

DOI

Techniques

UV-Vis, FTIR, Raman, NMR, XPS, PL, XRD, CV, EIS

Capabilities

Signal processing Baseline correction, smoothing and peak detection across all supported techniques
Peak deconvolution Multi-peak fitting with covariance-based parameter uncertainty
Solid-state analysis Scherrer and Williamson–Hall XRD analysis; Tauc bandgap extraction
Chemometrics PCA, MCR-ALS, PLS and hierarchical clustering
NMR ¹H, ¹³C and 2D COSY
Electrochemistry Cyclic voltammetry and impedance (EIS)
Reproducibility Session files (.lsb), provenance tracking and methods-section text generation
Export Publication-oriented figures and PDF output

Download

Desktop installers are attached to every release:

Platform File
Windows Labscribber-<version>-win-x64.exe (installer) or .zip (portable)
macOS Labscribber-<version>-mac-arm64.dmg (Apple Silicon) or -mac-x64.dmg (Intel)
Linux Labscribber-<version>-linux-x86_64.AppImage (chmod +x, then run)

The installers are not code-signed yet. Windows: if SmartScreen appears, choose More info → Run anyway. macOS: right-click the app and choose Open the first time. The source is open and the build runs in public CI, so you can verify what you install.

Prefer the browser? See Quick start to run it locally.

Quick start

Requires Node.js ≥ 20.19

git clone https://github.com/asifverse4/LabScribber.git
cd LabScribber
npm install
npm run dev

Open http://localhost:3000.

Desktop app, tests, production build
npm run electron:dev      # desktop app (Electron)
npm test                  # full test suite
npm run test:coverage     # coverage report -> coverage/index.html
npm run build             # production build
npm run electron:dist     # Windows / macOS / Linux installers

electron:dist expects build/icon.ico, build/icon.icns and build/icon.png (PNG at least 512×512). Add them before packaging. See CONTRIBUTING.md for the developer guide and docs/SESSION_FORMAT.md for the .lsb session format.

Quality & reproducibility

  • 187 automated tests across the numerical core and the UI.
  • Continuous integration runs type-check, tests and a production build on every push and pull request (workflow).
  • Verified on synthetic data with known ground truth; see the accompanying paper (paper.md).

Future Scope & Roadmap

LabScribber is evolving into a comprehensive, multi-technique open-source spectroscopy workstation. See ROADMAP.md for our detailed multi-phase engineering plan.

Phase Milestone Focus Key Capabilities
Phase 1 High-Performance Compute Web Worker solver offloading, Levenberg-Marquardt with analytical Jacobians, Rust/WASM matrix kernels
Phase 2 Technique Expansion 2D hyperspectral Raman/FTIR mapping, EIS equivalent circuit modeling (CNLS), Rietveld/Le Bail PXRD, TRPL lifetimes
Phase 3 Vendor Interoperability Native binary decoders for Bruker OPUS, Thermo Galactic SPC, Renishaw WDF, VAMAS XPS, and NeXus/HDF5
Phase 4 FAIR Science & Ecosystem labscribber-io Python package, Jupyter widgets, direct Zenodo/ELN export, journal composite figure studio
Phase 5 Edge AI & Live Hardware 100% on-device ONNX spectral matching (FTIR/Raman), WebSerial/WebUSB live spectrometer acquisition

Known Limitations (Current Release)

  • Tauc auto-window selection is noise-sensitive, even with the manual wavelength-range safeguard set correctly (paper §2.3). A scoped fix is planned for v1.3.
  • AI-assisted interpretation is planned, not implemented. No AI features or cloud dependencies are included in this version.
  • Real-instrument validation is ongoing. Validation on non-synthetic datasets is in progress.

Full release history: CHANGELOG.md · Comprehensive roadmap: ROADMAP.md.

Citing

If you use LabScribber in your research, please cite it using CITATION.cff. GitHub's Cite this repository button reads it directly. A draft JOSS paper is included (paper.md, paper.bib) but has not been submitted.

Raza, A., & Basheer, H. (2026). LabscribberPro (v1.1.1) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.23689725


Developed at the School of Chemical and Life Sciences, Jamia Hamdard University, New Delhi, India.
Created by Asif Raza · Contributor: Huma Basheer · Supervision: Imran A. Khan · Released under the MIT License

About

LabScribber is a Python-based scientific analysis platform for processing spectra, detecting and fitting peaks, performing multivariate analysis, and generating publication-ready figures and reports.

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages