Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/justjake/Gauss
Stable Diffusion macOS native app
https://github.com/justjake/Gauss
Last synced: about 1 month ago
JSON representation
Stable Diffusion macOS native app
- Host: GitHub
- URL: https://github.com/justjake/Gauss
- Owner: justjake
- License: gpl-3.0
- Created: 2022-12-06T05:06:25.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-01-19T10:28:25.000Z (almost 2 years ago)
- Last Synced: 2024-08-01T16:43:16.587Z (4 months ago)
- Language: Swift
- Size: 30.9 MB
- Stars: 1,367
- Watchers: 13
- Forks: 32
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-stable-diffusion - Gauss - Native MacOS Stable Diffusion App. (Actively Maintained Forks and Containers)
- project-awesome - justjake/Gauss - Stable Diffusion macOS native app (Swift)
README
# Gauss
A Stable Diffusion app for macOS built with SwiftUI and Apple's [ml-stable-diffusion](https://github.com/apple/ml-stable-diffusion) CoreML models.
[Download the latest release][releases]!
 
[releases]: https://github.com/justjake/Gauss/releases
## Usage
- Gauss is document-based. To get started, create a new document.
- All the images you generate are stored locally inside your `.gaussnb` (Gauss Notebook) files.
- If it's your first time using Gauss, you'll need to install Stable Diffusion models to start generating images. Each model is about 2.5gb.
- Write prompt text and adjust parameters in the composer view at the bottom of the document window.
- To export an image, just drag it to Finder or any other image editor.
- You can always generate more images from an existing prompt.
## Project Status
This software is under development and is alpha quality. Builds are available on the [releases] page.
Alternatives:
- [DiffusionBee](https://github.com/divamgupta/diffusionbee-stable-diffusion-ui) is a Stable Diffusion UI built with Electron & Python. It's probably slower than Gauss but has many more features.
## System requirements
- macOS 13.1+
- Recommended: an Apple Silicon CPU. Intel hardware may work, but is untested by the primary developer and could be slow.
## Developer setup
If you'd like to contribute, you can build the project by following the instructions for developers below.
### System requirements
- macOS 13.1+
- Xcode 14.2+
- `git-lfs` is used to fetch pre-built models from HuggingFace.
- If you have `brew`: `brew install git-lfs`, then `git lfs install`.
- Otherwise, [download the installer here](https://git-lfs.com/), then `git lfs install`.
- At least 10gb of free disk space.
- Recommended: [set up Xcode to format code when you save](https://luisramos.dev/xcode-format-and-save).
### Building Gauss
1. Clone this repo: `git clone https://github.com/justjake/Gauss`
1. Open the project file (Gauss.xcodeproj) with Xcode: `open Gauss.xcodeproj`
1. You should be able to run (Cmd-R) the project.
As with end-users, the first time you run Gauss you'll need to download models.
### Adding or updating models
To release model data, we pack the models into archive files, split the archive files into parts no larger than 2gb, and then publish everything via Github release. 2gb is the [file size limit for Github releases](https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases#:~:text=Each%20file%20included%20in%20a,a%20release%2C%20nor%20bandwidth%20usage.).
We use Apple Archive (.aar) format instead of something common like Zip because .aar unpacking is available from built-in libraries, and zip is not.
1. To create the `.aar` files: `make aars`
1. Serve the newly-built .aar files locally: `make serve`
1. Switch to installing models locally:
1. Run the project in Xcode, then open the Models window (Window > Models).
1. Open the "Advanced" dropdown and choose "Custom Host"
1. Remove existing model files: `make uninstall-models`
### Publishing releases to Github
This is done manually.