Skip to content

DeepHistoImageAI Desktop Documentation

Windows-first digital pathology workstation for whole-slide viewing, QuPath annotation workflows, semantic-segmentation dataset curation, model training, and inference.

Core Workflows

1. Manage Projects & Slides

Create local workspace projects, import whole-slide images (WSIs) or QuPath projects, recover missing high-resolution slide paths, and manage project metadata in Projects.

2. Inspect & Annotate WSIs

Navigate gigapixel slides in Viewer, paint or draw class-labeled regions, toggle prediction overlays, import/export QuPath GeoJSON, and trigger slide or ROI inference.

3. Build Dataset Versions

Launch the guided wizard in Datasets to extract normalized image/mask patches with WSI-level train/val/test separation and semantic class preservation.

4. Train, Register & Run Inference

Launch and pause/resume training jobs in Training, track queued jobs in Tasks, manage portable packages in Models, monitor runs in Inference, and configure SSH nodes in Remote Workers.

Architecture & Desktop Responsibilities

flowchart LR
    WSI["Local Whole-Slide Images (.svs, .vsi, .ndpi, ...)"] --> Desktop["DeepHistoImageAI Desktop (PySide6 / QML)"]
    Desktop --> LocalDB["Per-Project SQLite + Annotations + Caches"]
    Desktop --> Backend["Backend"]
    Backend --> Auth["Auth app with users and organizations"]
    Backend --> ObjectStore["Server Object Storage (S3 compatible)"]
    Backend --> Worker["Universal CPU / CUDA Worker & SSH Nodes"]
Full desktop window showing TopBar, 13-route SidebarNav, Projects Overview page, and BottomStatusBar.

Desktop Sidebar Tabs

Section Tab Purpose Guide
Main Projects Create, open, rename, delete projects and import QuPath workspaces Projects
Main Viewer Multi-resolution WSI canvas, annotations, prediction overlays, inference trigger Viewer
Main Datasets Guided WSI-split dataset curation, version inspection, and export Datasets
Main Tasks Background desktop and server task queue, logs, cancel/force-stop Tasks
Main Training Launch, monitor, pause/resume model training and metric curves Training
Main Models Portable model versions, metrics inspection, package import, sharing Models
Main Inference Monitor inference runs across all projects with status and timings Inference
Main Remote Workers Register, probe, configure, and reboot SSH GPU compute nodes Remote Workers
Admin Settings Workspace folders, QuPath/Java/Bio-Formats, memory, environment profiles Settings
Admin Logs Inspect, copy, clear, and open desktop diagnostic logs Logs
Admin Organizations Sign in, switch personal/organization tenant, accept invitations Organizations
Admin Storage Cloud storage quota, artifact breakdown, downloads, deletion retries Storage
Admin About Desktop and connected server release versions and application overview About