diffusion-rs

Crates.iodiffusion-rs
lib.rsdiffusion-rs
version0.1.3
sourcesrc
created_at2024-11-02 12:26:06.92221
updated_at2024-11-14 11:41:25.700082
descriptionHigh level API for stable-diffusion.cpp
homepage
repositoryhttps://github.com/newfla/diffusion-rs
max_upload_size
id1432825
size50,189
Flavio Bizzarri (newfla)

documentation

https://docs.rs/diffusion-rs

README

diffusion-rs

Latest version Documentation

Rust bindings to https://github.com/leejet/stable-diffusion.cpp

Features Matrix

Windows Mac Linux
vulkan ✅️ ✅️ ✅️
metal ❌️ ✅️ ❌️
cuda ✅️ ❌️ ✅️
rocm ❔️ ❌️ ✅️
sycl ❔️ ❌️ ✅️

❔️: Not tested, should be supported

Usage

use diffusion_rs::{api::txt2img, preset::{Preset,PresetBuilder}};
let config = PresetBuilder::default()
            .preset(Preset::SDXLTurbo1_0Fp16)
            .prompt("a lovely duck drinking water from a bottle")
            .build()
            .unwrap();
txt2img(config).unwrap();

Troubleshooting

  • Something other than Windows/Linux isn't working!
    • I don't have a way to test these platforms, so I can't really help you.
  • I get a panic during binding generation build!
    • You can attempt to fix it yourself, or you can set the DIFFUSION_SKIP_BINDINGS environment variable. This skips attempting to build the bindings whatsoever and copies the existing ones. They may be out of date, but it's better than nothing.
      • DIFFUSION_SKIP_BINDINGS=1 cargo build
    • If you can fix the issue, please open a PR!

Roadmap

  1. Ensure that the underline cpp library compiles on supported platforms
  2. Build an easy to use library with model presets
  3. Automatic library publishing on crates.io by gh actions
  4. Maybe prebuilt CLI app binaries
Commit count: 26

cargo fmt