A Discord bot interface for Stable Diffusion
To generate an image from text, use the /draw command and include your prompt as the query.
To generate a prompt from a couple of words, use the /generate command and include your text as the query.
- face swap (ReActor) (Install it, if you haven't)
- live preview
- negative prompts
- swap model/checkpoint (see origial wiki)
- sampling steps
- width/height
- CFG scale
- sampling method
- seed
- Web UI styles
- extra networks (hypernetwork, LoRA)
- face restoration
- high-res fix
- CLIP skip
- img2img
- denoising strength
- batch count
- /settings command - set per-channel defaults for supported options (see Notes!):
- also can set maximum steps limit and max batch count limit
- refresh (update Marusya's options with any changes from Web UI)
- /identify command - create a caption for your image.
- /generate command - generate a prompt from text, using https://huggingface.co/Gustavosta/MagicPrompt-Stable-Diffusion
- /stats command - shows how many /draw commands have been used.
- /queue command - shows the size of each queue.
- /info command - basic usage guide, other info, and download batch images.
- /upscale command - resize your image.
- buttons - certain outputs will contain buttons.
- 🖋 - edit prompt, then generate a new image with same parameters.
- 🎲 - randomize seed, then generate a new image with same parameters.
- 📋 - view the generated image's information.
- ⬆️ - upscale the generated image with defaults. Batch grids require use of the drop downs
- ❌ - deletes the generated image. In Live preview this button interrupts generation process
- ➡️ - skips the current image generation in live preview and go to next batch (if there's more than 1)
- dropdown menus - batch images produce two drop down menus for the first 25 images.
- The first menu prompts the bot to send only the images that you select at single images
- The second menu prompts the bot to upscale the selected image from the batch.
- context menu options - commands you can try on any message.
- Get Image Info - view information of an image generated by Stable Diffusion.
- Quick Upscale - upscale an image without needing to set options.
- Batch Download - download all images of a batch set without needing to specify batch_id and image_id
- mark image as spoiler
- Per image (on
/draw
) - Set channel-wide default or force based on role with
/settings
- Per image (on
- configuration file - can change some of Marusya's operational aspects.
- Set up AUTOMATIC1111's Stable Diffusion AI Web UI.
- Marusya is currently tested on commit
cf2772fab0af5573da775e7437e6acdca424f26e
of the Web UI.
- Marusya is currently tested on commit
- Run the Web UI with API (
COMMANDLINE_ARGS= --api
). - Clone this repo.
- Create a file in your cloned repo called ".env", formatted like so:
# .env
TOKEN = put your bot token here
- Run Marusya by running launch.bat (or launch.sh for Linux)
- See original wiki for notes on additional configuration.
- See original wiki for notes on swapping models.
- 📋 requires a Web UI script. Please see original wiki for details.
- Ensure Marusya has
bot
andapplication.commands
scopes when inviting to your Discord server, and intents are enabled. - As /settings can be abused, consider reviewing who can access the command. This can be done through Apps -> Integrations in your Server Settings. Read more about /settings here.
- Marusya uses Web UI's legacy high-res fix method. To ensure this works correctly, in your Web UI settings, enable this option:
For hires fix, use width/height sliders to set final resolution rather than first pass
Marusya only exists thanks to these awesome people:
- AUTOMATIC1111, and all the contributors to the Web UI repo.
- harubaru, my entryway into Stable Diffusion (with Waifu Diffusion) and foundation for the AIYA Discord bot.
- Kilvoctu, for making the main repo
- FoxxMD, for Live preview optimizations
- Gourieff for ReActor extension
- You, for using Marusya and contributing with PRs, bug reports, feedback, and more!