InsightInSAR
Windows desktop + WSL all-in-one InSAR deformation monitoring
Overview
InsightInSAR combines a PySide6 desktop client, FastAPI backend, and Celery task orchestration for a complete deformation monitoring experience on Windows. All InSAR compute (ISCE2 / MintPy) runs only inside WSL while the desktop and backend handle configuration, progress bridging, and result browsing — no ISCE2 build on Windows.
Features
Native desktop app
PySide6 UI for task management, ROI selection, product browsing, and parameter setup — not a browser-based frontend.
Backend orchestration
FastAPI REST API with Celery for long-running InSAR jobs and Redis as the message broker.
InSAR via WSL only
S1 import, topsStack, MintPy, and related steps are invoked through wsl; the desktop only bridges parameters and progress.
Production-ready deployment
InSAR WSL setup wizard for importing WSL images and config; packaged builds can run without Docker.
Logging and monitoring
Task progress and logs are persisted; the desktop can inspect status and errors.
Visualization
Embedded Matplotlib and chart widgets for time series and profile views.
Architecture
The desktop talks to local FastAPI over HTTP; FastAPI hands jobs to Celery, which uses wsl_runner to run run_s1_extract_wsl, run_stack_wsl, run_mintpy_wsl, and similar scripts inside WSL. Project paths may live on Windows and are converted before WSL invocation.
Tech Stack
| Category | Stack |
|---|---|
| Desktop | PySide6, Qt Widgets, Matplotlib |
| Backend | FastAPI, Celery, Redis |
| InSAR engine (WSL) | ISCE2, MintPy |
Requirements
- Windows 10/11 with WSL 2 enabled
- Host Python 3.10+ for desktop and backend (ISCE2 not required on Windows)
- ISCE2 and MintPy configured inside WSL with INSAR_USE_WSL=1 and related variables
Quick start
1. Create environment
conda create -n insight-insar python=3.10 && git clone https://github.com/BitterSnow/InsightInSAR.git
2. Install dependencies
pip install -r packaging/requirements.txt
3. Configure WSL
Use scripts/start_desktop_wsl.bat or the InSAR WSL setup wizard to set INSAR_USE_WSL and INSAR_WSL_PROJECT_ROOT
4. Start services
Launch uvicorn backend, celery worker, and python -m desktop — or use start_desktop_wsl.bat
Downloads
v2026-07
Packages below are hosted on Baidu Netdisk — use the extraction code after download. WSL 2 with ISCE2/MintPy inside WSL is required. International mirror links will be added later.
Insight InSAR Desktop
File: Insight InSAR Desktop.zip
Type: Desktop application
Updated: 2026-07-01
Extraction code: rhur
What changed: Improved progress reload when the window restarts while a task is running
InSAR WSL image
File: insar-wsl.zip
Type: WSL image archive
Updated: 2026-06-02
Extraction code: wswv
InSAR WSL Deploy Wizard
File: InSAR WSL Deploy Wizard.zip
Type: WSL image deployment wizard
Updated: 2026-06-02
Extraction code: mmpr