Skip to content

Latest commit

 

History

History
135 lines (104 loc) · 6.63 KB

README.md

File metadata and controls

135 lines (104 loc) · 6.63 KB
Raw

AIYA

A Discord bot interface for Stable Diffusion

Usage

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.

image

Currently supported options

  • negative prompts
  • swap model/checkpoint (see 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

Bonus features

  • /settings command - set per-channel defaults for supported options (see Notes!):
    • also can set maximum steps limit and max batch count limit
    • refresh (update AIYA'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.
  • 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
  • configuration file - can change some of AIYA's operational aspects.

Setup requirements

  • Set up AUTOMATIC1111's Stable Diffusion AI Web UI.
    • AIYA is currently tested on commit 20ae71faa8ef035c31aa3a410b707d792c8203a3 of the Web UI.
  • Run the Web UI as local host 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 AIYA by running launch.bat (or launch.sh for Linux)

Deploy with Docker

AIYA can be deployed using Docker.

The docker image supports additional configuration by adding environment variables or config file updates detailed in the wiki.

Docker run

docker run --name aiyabot --network=host --restart=always -e TOKEN=your_token_here -e TZ=America/New_York -v ./aiyabot/outputs:/app/outputs -v ./aiyabot/resources:/app/resources -d ghcr.io/kilvoctu/aiyabot:latest

Note the following environment variables work with the docker image:

  • TOKEN - [Required] Discord bot token.
  • URL - URL of the Web UI API. Defaults to http://localhost:7860.
  • TZ - Timezone for the container in the format America/New_York. Defaults to America/New_York
  • APIUSER - API username if required for your Web UI instance.
  • APIPASS - API password if required for your Web UI instance.
  • USER - Username if required for your Web UI instance.
  • PASS - Password if required for your Web UI instance.

Docker compose

  • Clone the repo and refer to the docker-compose.yml file in the deploy directory.
  • Rename the /deploy/.env.example file to .env and update the TOKEN variable with your bot token (and any other configuration as desired).
  • Run docker-compose up -d to start the bot.

Notes

Credits

Foundation

AIYA only exists thanks to these awesome people:

Great Contributors

These people played a large role in AIYA's development in some way:

  • solareon, for developing a more sensible way to display and interact with batches of images.
  • danstis, for dockerizing AIYA.
  • ashen-sensored, for developing a workaround for Discord removing PNG info to image uploads. edit Discord is no longer doing this at the moment, but credit is still due.
  • gingivere0, for PayloadFormatter class for the original API. Without that, I'd have given up from the start. Also has a great Discord bot as a no-slash-command alternative.
  • You, for using AIYA and contributing with PRs, bug reports, feedback, and more!

TODOs

  • support more options/extensions? (VAE, animateddiff?)