Swift app demonstrating Core ML Stable Diffusion
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Pedro Cuenca 2bdfcc593d
Update performance measures.
2 years ago
Diffusion Add simple metadata for a couple of models. 2 years ago
Diffusion.xcodeproj Add simple metadata for a couple of models. 2 years ago
DiffusionTests Diffusion app. 2 years ago
DiffusionUITests Diffusion app. 2 years ago
config Move code-signing to minimal xcconfig file. 2 years ago
.gitignore Ignore .DS_Store 2 years ago
LICENSE Diffusion app. 2 years ago
README.md Update performance measures. 2 years ago
screenshot.jpg Add screenshot to README. 2 years ago

README.md

Diffusion

This is a simple app that shows how to integrate Apple's Core ML Stable Diffusion implementation in a native Swift UI application. It can be used for faster iteration, or as sample code for other use cases.

This is what it looks like: App Screenshot

On first launch, the application downloads a zipped archive with a Core ML version of Runway's Stable Diffusion v1.5, from this location in the Hugging Face Hub. This process takes a while, as several GB of data have to be downloaded and unarchived.

For faster inference, we use a very fast scheduler: DPM-Solver++ that we ported to Swift. Since this scheduler is still not available in Apple's GitHub repository, the application depends on the following fork instead: https://github.com/pcuenca/ml-stable-diffusion. Our Swift port is based on Diffusers' DPMSolverMultistepScheduler, with a number of simplifications.

Compatibility

  • macOS Ventura 13.1, iOS/iPadOS 16.2, Xcode 14.2.
  • Performance (after the initial generation, which is slower)
    • ~8.3s in macOS on MacBook Pro M1 Max (64 GB). Model: Stable Diffusion v2-base, ORIGINAL attention implementation, CPU + GPU.
    • 23 ~ 30s on iPhone 13 Pro. Model: Stable Diffusion v2-base, SPLIT_EINSUM attention, CPU + Neural Engine, memory reduction enabled.

Performance on iPhone is somewhat erratic, sometimes it's ~20x slower and the phone heats up. This happens because the model could not be scheduled to run on the Neural Engine and everything happens in the CPU. We have not been able to determine the reasons for this problem. If you observe the same, here are some recommendations:

  • Kill apps you are not using.
  • Let the iPhone cool down before repeating the test.
  • Reboot your device.

How to Build

If you clone or fork this repo, please update common.xcconfig with your development team identifier. Code signing is required to run on iOS, but it's currently disabled for macOS.

Limitations

  • The UI does not expose a way to configure the scheduler, number of inference steps, or generation seed. These are all available in the underlying code.
  • A single model (Stable Diffusion v1.5) is considered. The Core ML compute units have been hardcoded to CPU and GPU, since that's what gives best results on my Mac (M1 Max MacBook Pro).
  • Sometimes generation returns a nil image. This needs to be investigated.

Next Steps

  • Improve UI. Allow the user to select generation parameters.
  • Allow other models to run. Provide a recommended "compute units" configuration based on model and platform.
  • Implement other interesting schedulers.
  • Implement negative prompts.
  • Explore other features (image to image, for example).