Installation
Overview
DeepHistoImageAI Desktop is a Windows-first workstation application built with PySide6 and QML (apps/desktop/). It runs locally on your computer to provide high-performance whole-slide pathology viewing, QuPath project integration, dataset extraction, and local/remote ML workflows.
Launching the Desktop Client
| Launch Method | Usage Context | Notes |
|---|---|---|
Windows Installer (DeepHistoImageAI Setup) |
Standard end-user workstation install | Packaged Windows executable built via scripts/build_desktop.ps1 with synced version metadata |
Developer uv Run |
Running from source repository | uv run --project apps/desktop python -m deephisto on Windows with Python 3.12+ |
First-Launch Initialization
When starting with an uninitialized application folder, App.qml opens the mandatory initialAppFolderPrompt modal before unlocking workspace tabs:
- Select a local Application Folder where DeepHistoImageAI stores default projects, local cache indices, and logs.
- Once confirmed,
AppShellinitializes the project library and checks if a project is open. - Open Admin → Settings at any time to configure QuPath console integration, Java 11+ (for Bio-Formats slides such as
.vsi), memory budgets, or backend connection profiles.
GS-01
First-Run Application Folder Prompt
16/9
Screenshot Placeholder
First-Run Application Folder Prompt
public/screenshots/getting-started/initial-app-folder-prompt.png