Kiwi is a Hikari Lightbulb discord bot for prompting stable diffusion models through Hugging Face's Diffusers library.
I created Kiwi because I wanted to have a "multiplayer" alternative to AUTOMATIC1111's webui
- Models: Supports huggingface diffusers models and automatically converts .ckpt models to that format
- Text to image: Enter a detailed prompt to generate an image. Optionally use a negative prompt of features to avoid
- Image to image: Enter a detailed prompt and an image to generate a new one like it, strength changes the power of the input image over whats generated.
- Animation: guickly generate animated gifs driving certain parameters each frame, optionally upload a gif to run img2img on each frame
-
Inpainting: Enter a detailed prompt, an input image, and a black and white image mask, the white parts of the mask will be painted over with diffusion, high strength means the inpainting area will mostly be the same as the input image.
-
Textual inversion inference: Automatically loads TI embeds placed in the embeddings folder, must be in hugging face concepts .bin or the folder containing it from their repository, does not currently support .pt embeds because I am not smart enough to implement them.
-
Prompt weighting: You can multiply prompt focus in line with parenthesis eg: (1girl) or (1girl:1.3) Default: 1.1 You can reduce focus in line like negative prompts with square brackets eg: [1girl] or [1girl:1.3] Default: 1.1
WINDOWS
- Install python 3.10.9 - Warning: Kiwi was made by a girl who's not really a programmer, things could break, things might not work, and your house might burn down or worse... - Clone kiwi to a directory on your machine. - Place model weights .ckpt file or the repository folder containing a diffusers format model in the kiwi/models folder, .ckpt models will take a moment to convert the first time. - go to the discord applications page [Here](https://discord.com/developers/applications), create a new application, give it a unique name - Go to the "bot" section -> click "add bot" -> click "reset token", this token can only be viewed once without having to reset it so take note of it. **disable public bot unless you know what you're doing**, tick the intent switches on - Go to "OAuth2" section -> URL Generator -> click "bot" -> click administrator permission, or specific permissions if you know them -> copy and paste generated link into your browser or message it to who has permission to invite the bot to your discord. - paste your token into the bottoken field of config/kiwitoken.json *or* set a kiwitoken environment variable to the token - Enter your discord's ID into the "guildID" field of config/kiwitoken.json (id's can usually be accessed via right click in discord) - copy your user id to the AdminList field of config/kiwiconfig.json or config/kiwiconfigdefault.json to allow you access to change **/adminsettings** options - start the bot with **start.bat** - Enter **/changemodel** and select your model to load - Enter **/generate** to start prompting
LINUX
- Warning: Kiwi was made by a girl who's not really a programmer, things could break, things might not work, and your house might burn down or worse...
- KIWI WAS LARGELY MADE AND TESTED ON WINDOWS
- SOME WEIRD SHIT HAPPENS WHEN FIRST RUNNING ON LINUX BUT IT WORKS MAYBE IN THE END?
- If you're using linux, you're probably smarter than me and will be able to figure it out.
- Clone kiwi to a directory on your machine.
- Create a venv or pip install straight on your main python install
- pip install -r src/requirements.txt
- Place model weights .ckpt file or the repository folder containing a diffusers format model in the kiwi/models folder, .ckpt models will take a moment to convert the first time.
- go to the discord applications page Here, create a new application, give it a unique name
- Go to the "bot" section -> click "add bot" -> click "reset token", this token can only be viewed once without having to reset it so take note of it. disable public bot unless you know what you're doing, tick the intent switches on
- Go to "OAuth2" section -> URL Generator -> click "bot" -> click administrator permission, or specific permissions if you know them -> copy and paste generated link into your browser or message it to who has permission to invite the bot to your discord.
- paste your token into the bottoken field of kiwitoken.json or set a kiwitoken environment variable to the token, (idk how this works on linux, or if its setup correctly, if not just use the json... sorry...)
- Enter your discord server's ID into the "guildID" field of kiwitoken.json
- copy your user id to the AdminList field of kiwiconfig.json or kiwiconfigdefault.json to allow you access to change /adminsettings options
- python3 kiwi.py
- I had issues with wget module without sudo, but then other shit doesnt work, if you're using linux, you're a bigger nerd than me so you might be able to figure it out, either way, should run if u try sudo once, and then back to normal?, if not, manually copy kiwiconfigdefault and userconfigdefault to same file name without the "default" part
- Enter /changemodel and select your model to load
- Enter /generate to start prompting
- /generate: Generates a image from a detailed description, or booru tags separated by commas. optionally input an image for image to image generation, or a mask and an image for inpainting, note inpainting works poorly with default sampler, use klms instead
- /changemodel: changes the loaded model, must be used after bot is started if a default model is not set
- /togglequalityprompt: toggles whether or not to use the user's default quality prompt.
- /togglenegativeprompt: toggles whether or not to use the user's default negative prompt.
- /settings: displays a list of settings and optionally change them
- /generategif: Generates a gif given input options, if file is too big to upload to discord, is saved in kiwi/animation, also attempts to save video if ffmpeg is installed in path, can allow non admin to generate gif in adminsettings.
- /adminsettings: displays a list of admin settings and optionally changes them. Your discord user id (just a bunch of numbers) must be in config/kiwiconfig.json to modify these.
- /adminupdatecommands: refreshes commands
- /help: displays command list
- /imagetocommand: takes an input image or image link / message id and gives you the written command you can paste in for the same result
- /metadata: displays image metadata of an input image or image link / message id
- /styles: displays a list of loaded textual inversion embeddings
- /styleinfo: displays the training images of a TI if they are in the concept_images folder of the embed
This project abides by all exteral package licenses and makes use of multiple third party resources. Kiwi's non derivative source and contents are licensed under the MIT license.
| Package | Usage | Link | License |
|---|---|---|---|
| Kiwi | This Project | https://github.com/PuddlePumpkin/KiwiSD | MIT |
| Hugging Face Diffusers | Modified conversion script, pip-git | https://github.com/huggingface/diffusers | Apache 2.0 |
| Gidole Font | Loads via WGET | https://github.com/larsenwork/Gidole/ | OFL/MIT |
| Hikari | pip | https://github.com/hikari-py/hikari/ | MIT |
| Hikari-Lightbulb | pip | https://github.com/tandemdude/hikari-lightbulb | LGPLv3 |
| Real ESRGAN | pip-git | https://github.com/ai-forever/Real-ESRGAN | BSD 3-Clause |
| Real ESRGAN | ai-forever implementation is derivative | https://github.com/xinntao/Real-ESRGAN | BSD 3-Clause |
| Pytorch (CUDA) | pip | https://github.com/pytorch/pytorch | Custom |
See src/requirements.txt to view other used packages and find their licenses.
This project is not endorsed by or affiliated with any third party entity.