Stability Matrix Documentation

Stability Matrix is a multi-platform package manager for Stable Diffusion and related AI image/video generation tools. This documentation covers all major features and sections of the application.

This documentation is intended to provide a detailed guide and explanation of the many functions of Stability Matrix, its installation and use for both new and current users, and also more detailed and technical material for advanced users. While it contains information on a vast majority of application specific functions, it also contains information that applies to AI image, video, and related generation aspects that can be useful both inside and outside of Stability Matrix. While not all encompassing on every minute detail, it is intended to be updated as new features and changes are released to the project as well as new ecosystem/model/usage information as-needed.

Current Status: In-progress - Structure is in-place and planned docs are currently being progressively created and added.

Table of Contents

Getting Started

• Overview — What Stability Matrix is and what it can do and minimal requirements/recommendations on hardware
• Installation — Installing on Windows, macOS, and Linux
• First Launch — Walking through the setup wizard
• Data Directory — Choosing and managing your data directory

Package Manager

• Overview — Managing AI packages in Stability Matrix
• Supported Packages — Full list of supported inference and training packages
• Installing Packages — One-click install, hardware selection, GPU backends
• Managing Packages (planned) — Launching, monitoring, updating, and deleting installed packages
• Launch Arguments (planned) — Configuring launch arguments per package
• Extensions (planned) — Browsing and managing package plugins and extensions

Inference

• Overview — The Inference UI, panel layout, and project files
• Text to Image (planned) — Generating images from text prompts
• Image to Image (planned) — Using an image as a generation starting point
• Image Upscale (planned) — Upscaling images with AI upscaler models
• Video Generation (planned) — Generating video with WAN and SVD models
• Advanced Controls (planned) — ControlNet, FaceDetailer, FreeU, LayerDiffuse, and more

Checkpoint Manager

• Overview (planned) — Centralized model storage shared across all packages
• Model Categories (planned) — All supported model folder types explained
• Metadata Editing (planned) — Importing CivitAI metadata and editing model info

Model Browser

• Overview (planned) — Multi-source model browser and download queue
• CivitAI (planned) — Browsing and downloading from CivitAI
• HuggingFace (planned) — Browsing and downloading from HuggingFace
• OpenModelDB (planned) — Browsing upscaler models from OpenModelDB

Outputs

• Overview (planned) — Image gallery, sorting, filtering, and batch operations
• Image Metadata (planned) — Reading embedded generation parameters and ComfyUI node data

Workflows

• Overview (planned) — Browsing and managing ComfyUI workflows
• Community Workflows (planned) — Browsing community workflows via OpenArt

Settings

• Settings — All application settings covering General, Accounts, Checkpoint Manager, Package Environment, Model Browser, Workflow Browser, Console, Appearance, System, and Debug Options

Advanced

• Overview — Advanced configuration and technical reference
• Building from Source and Contributing (planned) — Local builds, runtime targets, and where to start for code or docs contributions
• Shared Folders (planned) — Folder structure, symlinks, and cross-package model sharing
• Hardware Support — CUDA, ROCm, DirectML, MPS, ZLUDA, IPEX, and CPU backends
• Python Environment (planned) — Virtual environments, uv, pip, and Python version management
• ComfyUI Integration — ComfyUI node API, WebSocket protocol, and custom nodes
• Environment Variables — Per-package environment variable configuration

Tips and Tricks

• Overview — Tips and Tricks index
• Terminology — Common image generation terms and what they mean
• Inference UI Tips (planned) — Effective use of the built-in Inference UI
• Per-Package Tips (planned) — Package-specific tips and links to upstream documentation
• AMD GPU Workflow (planned) — Getting image and video generation working on AMD hardware
• Model Dependencies (planned) — Required secondary files for modern models (text encoders, VAEs, etc.)
• VRAM Optimization (planned) — Reducing VRAM usage without sacrificing too much quality or speed

Troubleshooting

• Common Issues — Symptom-first fixes for install, launch, GPU, and Inference problems