New: Unpaint demonstration on Xbox consoles, see it on YouTube.
This repository contains a fully C++ implementation of Stable Diffusion-based image synthesis tool called Unpaint. It supports basic and ControlNet enhanced implementations of txt2img, img2img, inpainting pipelines and the safety checker. This solution does not depend on Python and runs the entire image generation process in a single process, making deployments significantly simpler and smaller, essentially consisting of a few executable and library files (~30MB), and the model weights (~2.5GB / model). Using the library it is possible to integrate Stable Diffusion into almost any application, which can import C++ or C functions.
For technical details please check the page of the C++ Stable Diffusion library which Unpaint is based on here.
The application uses DirectML and it supports current GPUs of NVidia and AMD, but should work on other DirectML capable hardware as well. We encourage you to try it with different hardware and raise issues on this page if you have problems. Make sure to install the latest Windows updates and especially the latest GPU drivers, as Unpaints benefits from Microsoft's recent Build conference announced optimizations greatly.
Please note that ONNX based pipelines are not yet necessarily as optimized as with using pytorch and CUDA directly, however with latest drivers they are pretty close.
Unpaint is now available in the Microsoft Store, if you do not need the latest dev builds, please install it from there.
You can find the app installers on the releases page.
To install the app the first time follow these steps:
- Download both the
.msix
and.crt
files - Right click the
.crt
file and select install certificate - In the wizard select
Local Machine
and click next - Then select
Place all certificates in following Store
and clickBrowse
- Select
Trusted Root Certification Authorities
and clickOK
- Click
Next
and thenFinish
This installs Unpaint's self-signed security certificate which is required by the new MSIX installer pipeline for test builds, this is not needed if you install the app from the store.
If you feel unsafe consider using SignTool to resign the Unpaint package with your own certificate (you need to import your own one as well), you can refer to the end of this file on how to do it.
After this just open the .msix
file and should install fine and start the app.
To use Unpaint you will need to install at least one image generation model. You can install models from your hard drive, or HuggingFace. We have created a handy tutorial on how to convert existing models, you can find it here.
Development environment
- Install Visual Studio 2022
- Select the following workloads:
- Desktop development with C++
- Universal Windows Platform development
- Game development with C++
- Also select these individual packages:
- C++ (v143) Universal Windows Platform tools
- Select the following workloads:
- Install git from here if you do not have it yet
- I did the project with Windows 11, earlier Windows versions might or might not work
Once you have Visual Studio, for the first build follow these steps:
- Clone the repo with
git clone https://github.com/axodox/unpaint
- Open
Unpaing.sln
with Visual Studio- If Visual Studio prompts you that you still need to install something, then follow its instructions
- You could also get a prompt to enable
Developer Mode
in Windows, which you can do in theSettings
app
- Open the
Config
folder in theUnpaint
project inSolution Explorer
, and double clickPackage.appxmanifest
- Go to the
Packaging
tab, and selectChoose Certificate
- Press
Create
and follow the wizard
After this, you can just start the project and have it be built and run. Enjoy :)