metadata

title: Core ML Models
emoji: 🐱
pinned: false
tags:
  - coreml
  - stable-diffusion

↓↓↓ Scroll down to see models ↓↓↓

Core ML Models Repository

Thanks to Apple engineers, we can now run Stable Diffusion on Apple Silicon using Core ML!
However, it is hard to find compatible models, and converting models isn't the easiest thing to do.
By organizing Core ML models in one place, it will be easier to find them and for everyone to benefit.

Conversion Flags

The models were converted using the following flags:
--convert-vae-decoder --convert-vae-encoder --convert-unet --convert-text-encoder --bundle-resources-for-swift-cli --attention-implementation {SPLIT_EINSUM or ORIGINAL}

`split_einsum` vs `original` Models

Depending on what compute unit you select, you will need to use the correct model version:

split_einsum is compatible with all compute unit
original is only compatible with CPU & GPU

Contributing

We encourage you to have at least one model converted (that this community doesn't already have) under your account that you would be able to contribute before joining. This will help us see those who can actually contribute back to the community.
We also encourage you to follow models and repo naming schemes accordingly.

Attention: Apple introduced Image-to-image capabilities in the ml-stable-diffusion 0.2.0 release. All the models that do not have a VAE encoder (hence, not will be able to use Image-to-image), will have a no-i2i suffix right after the model name.
For example: stable-diffusion-2-1_no-i2i_original.
From now on, only models with a VAE encoder will be accepted.

Models Name

Models have the following naming scheme:

Original model name
Model version (split-einsum or original)
Model size (only if different from 512x512)
VAE name (only if different from the original VAE)

Each label is separated by an underscore _, and all capitalization from the original name is preserved.
For example: stable-diffusion-2-1_original_512x768_ema-vae.

Repo Name

Repos are named with the original diffusers Hugging Face / Civitai repo name prefixed by coreml-.
For example: coreml-stable-diffusion-2-1.

Repo README Contents

You can copy the beginning template for the README from one of the repo models that already exists here.
Then copy the original model's README as the body.

Repo Directory Structure

coreml-stable-diffusion-2-1
├── README.md
├── original
│   ├── 512x768
│   │   ├── stable-diffusion-2-1_original_512x768.zip
│   │   └── ...
│   ├── 768x512
│   │   ├── stable-diffusion-2-1_original_768x512.zip
│   │   └── ...
│   ├── stable-diffusion-2-1_original.zip
│   └── ...
└── split_einsum
    ├── stable-diffusion-2-1_split-einsum.zip
    └── ...