Vector Watcher

Architecture

Vector Watcher is packaged as a single desktop application containing:

React and TypeScript frontend
Tauri application shell
Rust application runtime
Python FastAPI backend
PyInstaller packaged backend runtime

Application Flow

When the packaged desktop application starts:

Tauri starts.
Tauri launches the packaged Python backend sidecar.
The backend starts Uvicorn on 127.0.0.1:8765.
The frontend communicates with the backend through localhost.

When the application closes, Tauri terminates the backend process.

Architecture Diagram

┌──────────────────────────────────────────────┐
│                Vector Watcher                │
│                                              │
│  ┌────────────────────────────────────────┐  │
│  │            Tauri Frontend              │  │
│  │                                        │  │
│  │         React / TypeScript UI          │  │
│  └────────────────────┬───────────────────┘  │
│                       │ HTTP                 │
│                       ▼                      │
│            http://127.0.0.1:8765             │
│                       │                      │
│  ┌────────────────────▼───────────────────┐  │
│  │          Python Backend Sidecar        │  │
│  │                                        │  │
│  │         FastAPI / Uvicorn              │  │
│  │                                        │  │
│  │       Packaged with PyInstaller        │  │
│  └────────────────────────────────────────┘  │
│                                              │
└──────────────────────────────────────────────┘

Frontend

The desktop UI is built using:

React TypeScript Tauri

The frontend communicates with the local backend using HTTP.

Backend

The backend uses:

Python FastAPI Uvicorn

The backend listens only on:

127.0.0.1:8765

It is started automatically by the Tauri application.

Backend Lifecycle

Application Starts
        │
        ▼
Tauri Starts
        │
        ▼
Python Sidecar Starts
        │
        ▼
FastAPI / Uvicorn Starts
        │
        ▼
Port 8765 Available
        │
        ▼
Frontend Communicates with Backend
        │
        ▼
Application Closes
        │
        ▼
Tauri Terminates Backend