eehlss/hemapath-optimized

HemaPath Interpreter v2.0 is an offline-first, federated AI for hematopathology. It scales from $50 smartphones (Tier 1) to digital centers (Tier 4). Using foundation model ensembles and a shared clinical protocol, it delivers expert PBF, BMA, and histology insights in low-resource settings. Global care, simplified. # HemaPath Interpreter v2.0 — Master Install & Usage Guide > **A tiered, offline-first, federated hematopathology AI platform > for low- and middle-income settings and beyond.** > EEHLSS / Alafia AI · Apache 2.0 · April 2026 --- ## 0. What is HemaPath Interpreter v2.0? HemaPath Interpreter v2.0 is an integrated clinical-AI platform for **peripheral blood film (PBF/PBS)**, **bone marrow aspirate (BMA)**, **bone marrow trephine biopsy**, and **lymph node histology** interpretation. It pairs a **protocol-driven reasoning skill** with an **ensemble of state-of-the-art open-source pathology foundation models** (TRIDENT · UNI-v2 · CONCH-v1.5 · TITAN · DINOBloom · RedDino · CellViT++ · HoVer-NeXt · YOLO26), and is deployable from **a $50 smartphone** up to a **$200K+ comprehensive digital-pathology centre**. It supersedes two earlier reference architectures: | Predecessor | Strength | Weakness | |---|---|---| | **HemaPath v1 skill** (this repo) | Rich clinical reasoning protocol | No deployment paths for low-resource sites | | **PathologyAI deploy bundle** (React/Node/K8s + OpenAI) | Full web app + K8s auto-scale | Online-only; OpenAI-dependent; wrong fit for LMIC edge | v2.0 merges the clinical depth of v1 with a **tier-aware deployment fabric** that runs **offline-first at Tier 1–2**, **hybrid at Tier 3**, and **fully orchestrated at Tier 4**. See `docs/01_ARCHITECTURE_COMPARISON.md` for the full three-way comparison. --- ## 1. Pick your tier ``` ┌──────────────────────────────────────────────────────────────────────────┐ │ WHICH TIER IS RIGHT FOR ME? │ ├──────────────────────────────────────────────────────────────────────────┤ │ │ │ Do you have any computer with a GPU or can you buy a $250 Jetson? │ │ │ │ No ─► Tier 1 (Smartphone) …