ShiftHackZ / Stable-Diffusion-Android

Stable Diffusion AI client app for Android
https://sdai.moroz.cc
GNU Affero General Public License v3.0
534 stars 56 forks source link
ai android automatic1111 clean-architecture compose compose-ui foss gson koin kotlin material3 multimodule-android-app mvi retrofit2 room-database rxjava3 stable-diffusion stable-diffusion-mobile stable-diffusion-webui viewmodel

Header

Stable-Diffusion-Android

Google Play F-Droid

Google Play F-Droid 4pda

Stable Diffusion AI is an easy-to-use app that lets you quickly generate images from text or other images with just a few clicks. With this app, you can communicate with your own server and generate high-quality images in seconds.

Features

Setup instruction

Option 1: Use your own Automatic1111 instance

This requires you to have the AUTOMATIC1111 WebUI that is running in server mode.

You can have it running either on your own hardware with modern GPU from Nvidia or AMD, or running it using Google Colab.

  1. Follow the setup instructions on Stable-Diffusion-WebUI repository.
  2. Add the arguments --api --listen to the command line arguments of WebUI launch script.
  3. After running the server, get the IP address, or URL of your WebUI server.
  4. On the first launch, app will ask you for the server URL, enter it and press Connect button. If you want to change the server URL, go to Settings tab, choose Configure option, and repeat the setup flow.

If for some reason you have no ability to run your server instance, you can toggle the Demo mode swith on server setup page: it will allow you to test the app and get familiar with it, but it will return some mock images instead of AI-generated ones.

Option 2: Use AI Horde

AI Horde is a crowdsourced distributed cluster of Image generation workers and text generation workers.

AI Horde requires to use API KEY, this mobile app alows to use either default API KEY (which is "0000000000"), or type your own. You can sign up and get your own AI Horde API KEY here.

Option 3: Hugging Face Inference

Hugging Face Inference API allows to test and evaluate, over 150,000 publicly accessible machine learning models, or your own private models, via simple HTTP requests, with fast inference hosted on Hugging Face shared infrastructure. This service is free, but is rate-limited.

Hugging Face Inference requires to use API KEY, which can be created in Hugging Face account settings.

Option 4: OpenAI

OpenAI provides a service for text to image generation using DALLE-2 or DALLE-3 models. This service is paid,

OpenAI requires to use API KEY, which can be created in OpenAI API Key settings.

Option 5: StabilityAI

StabilityAI is the image generation service provided by DreamStudio.

StabilityAI requires to use API KEY, which can be created in API Keys page.

Option 6: Local Diffusion (Beta)

Only txt2img mode is supported.

Allows to use phone resources to generate images.

Supported languages

App uses the language provided by OS default settings.

User interface of the app is translated for languages listed in this table:

Language Since version Status
English 0.1.0 Translated
Ukrainian 0.1.0 Translated
Turkish 0.4.1 Translated
Russian 0.5.5 Translated

Any contributions to the translations are welcome.

Difference between builds from Google Play and F-Droid/GitHub releases

As Google Play has some policies that app needs to be compliant with in order to be allowed to publist on Google Play there are some differences between builds distributed via Google Play and F-Droid/GitHub releases, listed in table.

Feature Google Play build F-Droid/GitHub build Reason
Sideloading LocalDiffusion custom model Google Play does not allow publishing apps with android.permission.MANAGE_EXTERNAL_STORAGE permission, which is required to read custom model files from external storage directly.

Donate

This software is open source, provided with no warranty, and you are welcome to use it for free.

In case you find this software valuable, and you'd like to say thanks and show a little support, here is the button:

"Buy Me A Coffee"