Skip to content

Stability Matrix Guide (2026): One-Click ComfyUI, Forge and More With Shared Models

6–9 minutes
Laughing platinum-blonde woman in a white coat and blue turtleneck in a neon server room holding a card reading MATRIX, with the text One-Click AI Image Apps

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.

TL;DR

  • 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
  1. Download only from the official GitHub releases page or lykos.ai. The README warns these and the official Discord are the only official sources.
  2. Extract the zip (Windows/Linux) to a folder with plenty of free space, ideally on an SSD.
  3. 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

  1. Follow the welcome screens on first launch.
  2. Choose where to keep data. The Data Directory holds your packages, models and settings, so pick a drive with lots of space.
  3. 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)

  1. Open Packages and click Add Package.
  2. Choose a package, for example ComfyUI.
  3. Review the install options (the defaults suit most people) and confirm.
  4. Wait while Stability Matrix sets up Python and dependencies for that package.
  5. 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

  1. Open the Model Browser and choose Civitai or Hugging Face.
  2. Search for a model and pick a version.
  3. Start the download. It downloads into the right folder for that model type, with metadata and a preview image.
  4. 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 .smproj project 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

  1. Close Stability Matrix and any running packages.
  2. Copy or move the Data Directory to the new drive or computer.
  3. 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.

Sources

Free weekly email

Get new AI guides every week

One short weekly email with our newest local AI, ComfyUI and AI tool guides. No spam, no pop-ups, just the good stuff.

Free. Unsubscribe anytime in one click. We only use your email to send this newsletter. See our privacy policy.

Laughing platinum-blonde woman in a white coat and blue turtleneck in a neon server room holding a card reading MATRIX, with the text One-Click AI Image Apps