How sidd-bme/loci-app works
Loci is a local-first desktop workspace for scientific images. The main path runs from a researcher opening images, through project-scoped viewing and annotation, to segmentation, quantitative review, and export. The Electron renderer communicates through the desktop main process with a JSON-lines Python engine; the engine provides project/workbench orchestration and specialized image-analysis capabilities. The README also describes histology, volume viewing, Cellpose, studies, and figures. Unsampled capability links are documented or left out where wiring is not evidenced.
Main entry points: workbench.py Workbench orchestration · worker.py Engine protocol · App.tsx Workspace UI · training.py Model training
Components 24
Desktop workspace
- Workspace UI
desktop/src/renderer/App.tsx - Shared contracts
desktop/src/shared/contracts.ts - Desktop IPC
desktop/src/main.ts - Engine client
desktop/src/main/worker-client.ts
Analysis engine
- Engine protocol
engine/src/loci_engine/worker.py - Workbench orchestration
engine/src/loci_engine/workbench.py - Image viewing
engine/src/loci_engine/viewer_image.py - Medical volumes
engine/src/loci_engine/viewer_medical.py - Volume viewing
engine/src/loci_engine/viewer_volume.py - Segmentation
engine/src/loci_engine/segment.py - Cellpose models
engine/src/loci_engine/cellpose_backend.py - Quantification
engine/src/loci_engine/quantitative.py - Analysis results
engine/src/loci_engine/results.py - Crash recovery packs
engine/src/loci_engine/working_result.py - Tables and figures
engine/src/loci_engine/export.py
Research workflows
- Study project store
engine/src/loci_engine/research_project.py - Annotations
engine/src/loci_engine/research_annotations.py - Research interchange
engine/src/loci_engine/research_interchange.py - Remote compute
engine/src/loci_engine/remote_compute.py - Remote worker
engine/src/loci_engine/remote_worker.py
Modeling
- Model training
modeling/src/loci_modeling/training.py - Training data
modeling/src/loci_modeling/data.py - Model inference
modeling/src/loci_modeling/inference.py
Other components
- Researcher
Connections 23
- Researcher → Workspace UI: uses
README.md - Workspace UI → Desktop IPC: invokes IPC
desktop/src/renderer/App.tsx - Workspace UI → Shared contracts: uses types
desktop/src/renderer/App.tsx - Desktop IPC → Engine client: sends requests
desktop/src/main.ts - Engine client → Engine protocol: JSON-lines calls
desktop/src/main/worker-client.ts - Engine protocol → Workbench orchestration: dispatches research
engine/src/loci_engine/worker.py - Workbench orchestration → Study project store: reads study
engine/src/loci_engine/workbench.py - Workbench orchestration → Image viewing: serves image views
engine/src/loci_engine/workbench.py - Workbench orchestration → Medical volumes: serves medical views
engine/src/loci_engine/workbench.py - Workbench orchestration → Volume viewing: serves volume views
engine/src/loci_engine/workbench.py - Workbench orchestration → Annotations: dispatches operations
- Workbench orchestration → Segmentation: runs analysis
- Workbench orchestration → Cellpose models: runs Cellpose
- Workbench orchestration → Quantification: requests measurements
engine/src/loci_engine/workbench.py - Workbench orchestration → Analysis results: records results
- Engine protocol → Crash recovery packs: publishes recovery
engine/src/loci_engine/worker.py - Engine protocol → Tables and figures: dispatches export
engine/src/loci_engine/worker.py - Workbench orchestration → Research interchange: supports study exchange
engine/src/loci_engine/research_interchange.py - Workbench orchestration → Remote compute: routes remote tasks
engine/src/loci_engine/workbench.py - Remote compute → Remote worker: stages requests
engine/src/loci_engine/remote_worker.py - Researcher → Model training: trains models
README.md - Model training → Training data: loads data
modeling/src/loci_modeling/training.py - Model training → Model inference: uses inference
modeling/src/loci_modeling/training.py