Difoosion - A Simple Web-Interface for Stable Diffusion Modelsby@d4vid
128 reads

Difoosion - A Simple Web-Interface for Stable Diffusion Models

by DavidJune 17th, 2024
Read on Terminal Reader
Read this story w/o Javascript
tldt arrow

Too Long; Didn't Read

This is a simple web interface for Stable Diffusion, built using the Python-only Rio framework. This article provides step-by-step instructions on how to build your own Stable Diffusion web interface.
featured image - Difoosion - A Simple Web-Interface for Stable Diffusion Models
David HackerNoon profile picture

With Stable Diffusion 3 freshly released, I thought it would be nice to make a simple Web-Interface for it. About a month ago, me and a couple of friends released a library for making websites with Python, and this just seemed like too good of an opportunity to pass up.

The interface includes support for the classic SD1, SDXL, and the new SD3. Inference is done using the diffusers library from Huggingface, and the interface is built with Rio. Given how new SD3 is in diffusers, you'll spot the odd issue here and there, but I'm sure that'll improve now with thousands of people using it.

stable diffusion web interface built with Rio

This is a simple Web-Interface for Stable Diffusion, based on our new Rio framework. We've gotten a lot of requests for larger sample projects, so given the highly anticipated release of Stable Diffusion 3, I figured this would be a great example. With all of that out of the way, let's get started! Install at least one model from the list below to begin using Difoosion. Rio:

This makes use of Stable Diffusion, which is a sizable AI model. While it can technically run on the CPU, an Nvidia GPU with at least 8GB of VRAM is highly recommended. You can find installation instructions in the project's README:

Get Started

  1. Clone this repository
git clone [email protected]:Vivern/difoosion.git

  1. Install the project and its dependencies (Use a venv if you like)
cd difoosion
python -m pip install -e .

This will download some large packages like diffusers and torch. Give it a few minutes to complete.

  1. Run the interface
python -m rio run --release

After a few seconds, this will display a URL in the console. Open this URL in your browser to start using the interface.

  1. Install Models

When you first connect, you won't have any models installed yet. The site will automatically allow you to download one of the built-in ones.

diffusers doesn't seem to offer any way to track the download progress of models. That's why you won't be able to see how far the download has progressed in the interface. Check the terminal to see updates.

  1. Get cracking!

Type a prompt of what you'd like to see, click "Generate," and wait for your masterpiece to be created :)

Tech Stack

  • The web interface is built with Rio, a new web framework that is designed to be 100% Python, and as easy to use as possible. I'm one of the Rio developers, and this project was meant to both test Rio out in a bigger project, as well as be a showcase & reference to other Rio developers.

  • Dependencies are managed with rye.


Stable Diffusion 3 is still very new, and support in diffusers immature. This has led to a couple of known problems:

  • Generating non-square images can lead to errors from pytorch. Stick to aspect ratios of 1:1 for now.

  • Freeing up memory is very unreliable. On some of my devices, the model keeps gobbling up more and more RAM as time goes on, while on others, it seems to free up just fine. Keep a close eye on your memory usage.