Skip to content

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:

  1. Select a local Application Folder where DeepHistoImageAI stores default projects, local cache indices, and logs.
  2. Once confirmed, AppShell initializes the project library and checks if a project is open.
  3. 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
Modal dialog displayed on first launch when no persistent application folder has been configured yet.