Installing local AI image tools usually means wrestling with Python versions, Git, virtual environments and duplicated model folders. Stability Matrix fixes that.
It’s a free desktop app that installs and updates ComfyUI, Forge, SD.Next, InvokeAI, Fooocus, SwarmUI, training tools like Kohya’s GUI and OneTrainer, and more, each in one click, with one shared model library for all of them.
It also has a built-in model browser for Civitai and Hugging Face, a checkpoint manager and its own Inference interface for generating images without opening a separate UI.
This guide shows how to install Stability Matrix on Windows, Linux and Mac, add packages, share models, download from Civitai and Hugging Face, use launch options, move it to another drive, and fix common problems. It follows the official Stability Matrix README as of November 2026.
- What: a package manager and inference UI for local image AI, by Lykos AI.
- Download: GitHub releases or lykos.ai. Windows x64 zip, Linux x64, macOS Apple Silicon .dmg.
- Mac:
brew install --cask stability-matrix(macOS 12+, Apple Silicon). - No setup pain: embedded Git and Python, so you don’t install either globally.
- One model folder shared by every package you install.
- Portable: move the Data Directory to another drive or PC at any time.
What Stability Matrix Does
| Feature | What it means for you |
|---|---|
| One-click package installs | Install ComfyUI, Forge, SwarmUI and others without touching a terminal |
| Embedded Git and Python | No global Python or Git install, no version conflicts |
| Shared model directory | Download a checkpoint once and use it in every package |
| Model browser | Search and download from Civitai and Hugging Face into the right folder |
| Launch arguments editor | Pick predefined flags or add your own per package |
| Extension manager | Manage plugins for supported packages |
| Inference UI | Generate images inside Stability Matrix itself |
| Portable data | Move everything to a new drive or computer |
Supported Packages
| Type | Packages listed in the README |
|---|---|
| Node and modern UIs | ComfyUI, SwarmUI, InvokeAI, SDFX |
| WebUI family | Stable Diffusion WebUI Forge, reForge, AMDGPU Forge, Automatic 1111, Automatic 1111 DirectML, SD Web UI-UX, SD.Next |
| Simple UIs | Fooocus and its variants (Fooocus MRE, Fooocus ControlNet SDXL, Ruined Fooocus, mashb1t’s 1-Up Edition), SimpleSDXL |
| Training | Kohya’s GUI, OneTrainer, FluxGym |
| Video and others | CogVideo via CogStudio, VoltaML |
Not sure which UI to start with? Read our ComfyUI guide, Forge WebUI guide, SwarmUI guide or InvokeAI guide.
Install Stability Matrix
| Platform | How |
|---|---|
| Windows | Download StabilityMatrix-win-x64.zip from GitHub releases, extract, run the app |
| Linux | Download StabilityMatrix-linux-x64.zip (AppImage) from GitHub releases; Arch users can use the AUR package stabilitymatrix |
| macOS (Apple Silicon) | Download StabilityMatrix-macos-arm64.dmg, or run brew install --cask stability-matrix |
- Download only from the official GitHub releases page or lykos.ai. The README warns these and the official Discord are the only official sources.
- Extract the zip (Windows/Linux) to a folder with plenty of free space, ideally on an SSD.
- Run the app. On Linux, make the AppImage executable first with
chmod +x.
The Homebrew cask lists macOS 12 or later on Apple Silicon. Intel Macs aren’t covered by the official builds.
First Launch and Data Folder
- Follow the welcome screens on first launch.
- Choose where to keep data. The Data Directory holds your packages, models and settings, so pick a drive with lots of space.
- Pick a first package to install, or skip and add one later from the Packages page.
Image models are large (often 2 to 25 GB each), so a fast drive with a few hundred GB free is a good idea.
Install a Package (ComfyUI, Forge and More)
- Open Packages and click Add Package.
- Choose a package, for example ComfyUI.
- Review the install options (the defaults suit most people) and confirm.
- Wait while Stability Matrix sets up Python and dependencies for that package.
- Click Launch. The package’s console opens inside Stability Matrix, and you can open its web UI from there.
You can install several packages side by side, or even two copies of the same one for testing.
Shared Models and the Checkpoint Manager
- One library: the Checkpoint Manager is shared by all package installs, so a model you add once shows up everywhere.
- Drag and drop local model files to import them.
- Metadata: it can look up Civitai metadata and preview thumbnails for new imports, and find metadata for models you already have.
- Folders by type: checkpoints, LoRAs, VAEs, ControlNets and others go into matching subfolders automatically.
Training your own LoRA? See how to train a LoRA locally, then drop the result into the shared LoRA folder.
Download From Civitai and Hugging Face
- Open the Model Browser and choose Civitai or Hugging Face.
- Search for a model and pick a version.
- Start the download. It downloads into the right folder for that model type, with metadata and a preview image.
- Pause and resume downloads whenever you like, even after closing the app.
Prefer the command line or the Hugging Face site? See how to download models from Hugging Face. Always check each model’s license before commercial use.
The Built-In Inference UI
- Prompt editor with auto-completion and syntax highlighting.
- Tabs for workspaces, saved as
.smprojproject files. - Dockable panels you can arrange freely.
- Metadata: images include Inference project, ComfyUI node and A1111-compatible metadata.
- Drag and drop an image from the gallery to load its settings again.
Inference generates through a ComfyUI backend, so install the ComfyUI package first if you plan to use it.
Launch Options, Extensions and Updates
- Launch arguments: each package has an editor with predefined options (for example low-VRAM modes) plus custom flags.
- Environment variables: configurable per install.
- Extensions: manage plugins for Automatic1111, ComfyUI, SD Web UI-UX and SD.Next from the package menu.
- Python dependencies: install or update them per package without a terminal.
- Updates: update packages from the Packages page. On Mac, the Homebrew cask is marked as auto-updating.
Move to Another Drive or PC
- Close Stability Matrix and any running packages.
- Copy or move the Data Directory to the new drive or computer.
- Open Stability Matrix and point it at the new Data Directory location.
The README describes it as fully portable, which makes it handy for moving a big model library to a new SSD.
Stability Matrix vs Installing Each UI by Hand
| Stability Matrix | Manual installs | |
|---|---|---|
| Python and Git | Embedded, per package | You install and manage versions |
| Model storage | One shared library | Copies or manual links per UI |
| Launch flags | Visual editor | Edit .bat or .sh files |
| Model downloads | Built-in Civitai and Hugging Face browser | Browser downloads and manual sorting |
| Control | Good, with some abstraction | Total |
| Best for | Beginners and people running several UIs | Developers and servers |
If you only ever use one tool and are comfortable in a terminal, a manual install keeps things simple. If you want to try ComfyUI today, Forge tomorrow and a LoRA trainer next week without filling your drive with duplicate models, Stability Matrix saves a lot of time and disk space.
Troubleshooting
| Problem | Likely cause | Fix |
|---|---|---|
| Package install fails | Network drop or antivirus blocking | Retry; allow the Data Directory in your antivirus |
| Running out of space | Models and packages on a small drive | Move the Data Directory to a larger drive |
| Model not showing in a package | Wrong model type folder | Re-import with the Checkpoint Manager so it lands in the right folder |
| Out of memory when generating | Not enough VRAM | Add a low-VRAM launch option or use a smaller model |
| Black images in ComfyUI | VAE or precision issue | See our ComfyUI black image fix |
| App won’t open on Mac | Gatekeeper or Intel Mac | Use System Settings > Privacy & Security > Open Anyway; Apple Silicon only |
| Suspicious “Stability Matrix” download site | Unofficial copy | Only use GitHub releases or lykos.ai |
If you later want to remove a package fully, our uninstall ComfyUI guide explains what to keep (your models) and what to delete.
FAQ
Is Stability Matrix free?
Yes. The source code is AGPL-3.0, and release builds come under Lykos AI’s end user license.
Is Stability Matrix made by Stability AI?
No. It’s made by Lykos AI. The name refers to the Stable Diffusion tools it manages.
Which packages can Stability Matrix install?
ComfyUI, SwarmUI, Forge and reForge, Automatic 1111, SD.Next, InvokeAI, Fooocus variants, Kohya’s GUI, OneTrainer, FluxGym and more.
Can I share models between ComfyUI and Forge?
Yes. Stability Matrix uses one shared model directory for all installed packages.
Does Stability Matrix work on Mac?
Yes, on Apple Silicon. Install the .dmg or use brew install –cask stability-matrix.
Do I need Python installed?
No. Stability Matrix embeds Git and Python, so neither needs to be installed globally.
Can I move Stability Matrix to another drive?
Yes. Move the Data Directory to the new drive and point the app at it.



