# lykosai/stabilitymatrix architecture

> Architecture diagram of the GitHub repository lykosai/stabilitymatrix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lykosai/stabilitymatrix
- Repository: https://github.com/lykosai/stabilitymatrix

## Overview

Stability Matrix is a cross-platform package manager and inference UI for Stable Diffusion. The principal workflow is to install and configure a supported generation package, launch it, connect the built-in inference interface, and generate or manage images and models. The graph also preserves the README’s model browsing, shared checkpoint management, and extension-management capabilities. Several subsystems are represented at directory level because their implementation files were not sampled; those documented links cite the README rather than implying source inspection.

Main entry points: [`StabilityMatrix.Avalonia/App.axaml.cs`](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Avalonia/App.axaml.cs) (Desktop application), [`StabilityMatrix.Avalonia/ViewModels/PackageManager`](https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia/ViewModels/PackageManager) (Package manager UI), [`StabilityMatrix.Avalonia/Controls/Inference`](https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia/Controls/Inference) (Inference workspace), [`StabilityMatrix.Avalonia/Services/InferenceClientManager.cs`](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Avalonia/Services/InferenceClientManager.cs) (Generation client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and settings"]
  node_app["Desktop application<br/>[App.axaml.cs]"]
  node_settings["Settings manager<br/>[SettingsManager.cs]"]
  node_settingsdata["Settings data<br/>[Settings.cs]"]
end

subgraph group_packages["Package lifecycle"]
  node_packageui["Package manager UI<br/>[PackageManager]"]
  node_packagecore["Package implementations<br/>[BasePackage.cs]"]
  node_installed["Installed packages"]
  node_python["Python runtime manager<br/>[UvManager.cs]"]
  node_launcher["Package launcher"]
  node_extensions["Extension management<br/>[Extensions]"]
end

subgraph group_inference["Inference and images"]
  node_inferenceui["Inference workspace<br/>[Inference]"]
  node_generation["Generation client"]
  node_comfy["Comfy client<br/>[ComfyClient.cs]"]
  node_project["Inference projects<br/>[Inference]"]
  node_imageui["Image and gallery UI"]
end

subgraph group_models["Models and downloads"]
  node_checkpoint["Checkpoint manager"]
  node_browser["Model browser"]
  node_civit["CivitAI model API"]
  node_modelindex["Model index service<br/>[Services]"]
  node_downloads["Download progress"]
end

subgraph group_support["Shared services"]
  node_events["Application events<br/>[EventManager.cs]"]
  node_logs["Log viewer<br/>[LogViewer]"]
end

node_user(("User"))
node_packageservice{{"External packages"}}
node_civitservice{{"CivitAI"}}
node_huggingface{{"Hugging Face"}}

node_user -->|"uses"| node_app
node_app -->|"opens"| node_packageui
node_packageui -->|"installs or updates"| node_packagecore
node_packagecore -->|"records installation"| node_installed
node_packagecore -->|"uses runtime"| node_python
node_packageui -->|"configures launch"| node_launcher
node_launcher -->|"launches"| node_packageservice
node_packageui -->|"manages extensions"| node_extensions
node_app -->|"loads settings"| node_settings
node_settings -->|"persists"| node_settingsdata
node_user -->|"configures generation"| node_inferenceui
node_inferenceui -->|"submits inference"| node_generation
node_generation -->|"uses client"| node_comfy
node_generation -->|"connects to"| node_packageservice
node_inferenceui -->|"saves workspace"| node_project
node_inferenceui -->|"shows gallery"| node_imageui
node_user -->|"manages models"| node_checkpoint
node_user -->|"browses models"| node_browser
node_browser -->|"imports from"| node_civit
node_browser -->|"imports from"| node_huggingface
node_browser -->|"tracks downloads"| node_downloads
node_checkpoint -->|"indexes models"| node_modelindex
node_generation -->|"observes model changes"| node_events
node_app -.->|"provides diagnostics"| node_logs

click node_app "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Avalonia/App.axaml.cs"
click node_settings "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Services/SettingsManager.cs"
click node_settingsdata "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Models/Settings/Settings.cs"
click node_packageui "https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia/ViewModels/PackageManager"
click node_packagecore "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Models/Packages/BasePackage.cs"
click node_installed "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Models/InstalledPackage.cs"
click node_python "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Python/UvManager.cs"
click node_launcher "https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia"
click node_extensions "https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Core/Models/Packages/Extensions"
click node_inferenceui "https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia/Controls/Inference"
click node_generation "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Avalonia/Services/InferenceClientManager.cs"
click node_comfy "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Inference/ComfyClient.cs"
click node_project "https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia/Models/Inference"
click node_imageui "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Avalonia/Controls/Inference/ImageGalleryCard.axaml.cs"
click node_checkpoint "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix/ViewModels/CheckpointManagerViewModel.cs"
click node_browser "https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia"
click node_civit "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Api/CivitCompatApiManager.cs"
click node_modelindex "https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Core/Services"
click node_downloads "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Avalonia/ViewModels/Progress/ProgressManagerViewModel.cs"
click node_events "https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Helper/EventManager.cs"
click node_logs "https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia.Diagnostics/LogViewer"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_settings,node_settingsdata,node_user toneBlue
class node_packageui,node_packagecore,node_installed,node_python,node_launcher,node_extensions toneAmber
class node_inferenceui,node_generation,node_comfy,node_project,node_imageui toneMint
class node_checkpoint,node_browser,node_civit,node_modelindex,node_downloads toneRose
class node_events,node_logs,node_packageservice,node_civitservice,node_huggingface toneIndigo
```

## Components

### Application and settings

- [Desktop application](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Avalonia/App.axaml.cs): `StabilityMatrix.Avalonia/App.axaml.cs`
- [Settings manager](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Services/SettingsManager.cs): `StabilityMatrix.Core/Services/SettingsManager.cs`
- [Settings data](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Models/Settings/Settings.cs): `StabilityMatrix.Core/Models/Settings/Settings.cs`

### Package lifecycle

- [Package manager UI](https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia/ViewModels/PackageManager): `StabilityMatrix.Avalonia/ViewModels/PackageManager`
- [Package implementations](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Models/Packages/BasePackage.cs): `StabilityMatrix.Core/Models/Packages/BasePackage.cs`
- [Installed packages](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Models/InstalledPackage.cs): `StabilityMatrix.Core/Models/InstalledPackage.cs`
- [Python runtime manager](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Python/UvManager.cs): `StabilityMatrix.Core/Python/UvManager.cs`
- [Package launcher](https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia): `StabilityMatrix.Avalonia`
- [Extension management](https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Core/Models/Packages/Extensions): `StabilityMatrix.Core/Models/Packages/Extensions`

### Inference and images

- [Inference workspace](https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia/Controls/Inference): `StabilityMatrix.Avalonia/Controls/Inference`
- [Generation client](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Avalonia/Services/InferenceClientManager.cs): `StabilityMatrix.Avalonia/Services/InferenceClientManager.cs`
- [Comfy client](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Inference/ComfyClient.cs): `StabilityMatrix.Core/Inference/ComfyClient.cs`
- [Inference projects](https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia/Models/Inference): `StabilityMatrix.Avalonia/Models/Inference`
- [Image and gallery UI](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Avalonia/Controls/Inference/ImageGalleryCard.axaml.cs): `StabilityMatrix.Avalonia/Controls/Inference/ImageGalleryCard.axaml.cs`

### Models and downloads

- [Checkpoint manager](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix/ViewModels/CheckpointManagerViewModel.cs): `StabilityMatrix/ViewModels/CheckpointManagerViewModel.cs`
- [Model browser](https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia): `StabilityMatrix.Avalonia`
- [CivitAI model API](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Api/CivitCompatApiManager.cs): `StabilityMatrix.Core/Api/CivitCompatApiManager.cs`
- [Model index service](https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Core/Services): `StabilityMatrix.Core/Services`
- [Download progress](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Avalonia/ViewModels/Progress/ProgressManagerViewModel.cs): `StabilityMatrix.Avalonia/ViewModels/Progress/ProgressManagerViewModel.cs`

### Shared services

- [Application events](https://github.com/lykosai/stabilitymatrix/blob/main/StabilityMatrix.Core/Helper/EventManager.cs): `StabilityMatrix.Core/Helper/EventManager.cs`
- [Log viewer](https://github.com/lykosai/stabilitymatrix/tree/main/StabilityMatrix.Avalonia.Diagnostics/LogViewer): `StabilityMatrix.Avalonia.Diagnostics/LogViewer`

### Other components

- **User**
- **External packages**
- **CivitAI**
- **Hugging Face**

## Connections

- User → Desktop application: uses (evidence: `README.md`)
- Desktop application → Package manager UI: opens (evidence: `README.md`)
- Package manager UI → Package implementations: installs or updates (evidence: `README.md`)
- Package implementations → Installed packages: records installation (evidence: `README.md`)
- Package implementations → Python runtime manager: uses runtime (evidence: `README.md`)
- Package manager UI → Package launcher: configures launch (evidence: `README.md`)
- Package launcher → External packages: launches (evidence: `README.md`)
- Package manager UI → Extension management: manages extensions (evidence: `README.md`)
- Desktop application → Settings manager: loads settings (evidence: `StabilityMatrix.Avalonia/App.axaml.cs`)
- Settings manager → Settings data: persists (evidence: `StabilityMatrix.Core/Services/SettingsManager.cs`)
- User → Inference workspace: configures generation (evidence: `README.md`)
- Inference workspace → Generation client: submits inference (evidence: `README.md`)
- Generation client → Comfy client: uses client (evidence: `StabilityMatrix.Avalonia/Services/InferenceClientManager.cs`)
- Generation client → External packages: connects to (evidence: `README.md`)
- Inference workspace → Inference projects: saves workspace (evidence: `README.md`)
- Inference workspace → Image and gallery UI: shows gallery (evidence: `README.md`)
- User → Checkpoint manager: manages models (evidence: `README.md`)
- User → Model browser: browses models (evidence: `README.md`)
- Model browser → CivitAI model API: imports from (evidence: `README.md`)
- Model browser → Hugging Face: imports from (evidence: `README.md`)
- Model browser → Download progress: tracks downloads (evidence: `README.md`)
- Checkpoint manager → Model index service: indexes models (evidence: `README.md`)
- Generation client → Application events: observes model changes (evidence: `StabilityMatrix.Avalonia/Services/InferenceClientManager.cs`)
- Desktop application → Log viewer: provides diagnostics
