FlaxeoUI

A Front End for stable-diffusion.cpp. Built with Electron and Node.js, I made it to be simple to interact with the stable difussion cpp cli

I created this Front End to quickly test models on my PC. Currently, it has only been tested using Vulkan on Linux and Windows.

Please use the master-418-200cb6f branch of stable-diffusion.cpp that is the one that works with this version of FlaxeoUI, or you will have issues. for Z Image turbo use the resolution 512x768 a bigger resolution will cause issues like generating white images in my case.

Disclaimer

This project hasn’t been fully tested. I ran into VRAM limitations when trying larger models, so testing was pretty limited.

I mostly developed and tested this on Windows. The first version did work on Ubuntu, but after the latest changes, I have no idea if it still works on Linux, since I haven’t tested it there again. Same goes for the build created by the GitHub Action, I haven’t tested it at all

Getting Started

Prerequisites

• Node.js: v16 or higher (Tested with v22.20.0).
• stable-diffusion.cpp: Tested with version master-418-200cb6f.
• NPM: Included with Node.js.

Installation

Clone the repository

git clone https://github.com/yourusername/flaxeo-ui.git
cd flaxeo-ui

Install dependencies

npm install

Run the application

npm start

Installation Windows Build

Clone the repository

git clone https://github.com/yourusername/flaxeo-ui.git
cd flaxeo-ui

Install dependencies

npm install

Run the application

npm run build:win

Development

To run the application in debug mode with hot-reloading for the frontend:

npm run dev

Architecture

• Frontend: Vue 3, TypeScript, Tailwind CSS
• Backend: Node.js (Express) handling API requests and managing the sd-server and sd-cli subprocess.
• Core: Electron for the desktop application wrapper.
• Inference: Relies on sd-server and sd-cli (based on stable-diffusion.cpp) for efficient local inference.

Credits

This project is a UI to stable-diffusion.cpp by @leejet.

License

MIT License