Links: 📣 Announcements | 📘 Manual | ⏱ Changelog | 🎓 Starter Guide

👋 Introduction

Unprompted is a powerful templating language and Swiss Army knife for the Stable Diffusion WebUI.

Built around [shortcodes], Unprompted is uniquely designed for maximum readibility with natural language. This makes it easy to learn and use, even for those with no prior programming experience.

Now also available as a ComfyUI node.

📦 Features

• Free
• Includes 70+ shortcodes out of the box - there are [if] conditionals, powerful [file] imports, [choose] blocks for flexible wildcards, and everything else the prompting enthusiast could possibly want
• Easily extendable with custom shortcodes
• Numerous Stable Diffusion features such as [txt2mask] and Bodysnatcher that are exclusive to Unprompted
• Ability to organize your .txt templates into folders and subfolders according to your own preferences
• As a modern language, Unprompted supports recursion, nested shortcodes, advanced logic operators, custom configs, pretty much all the good stuff one might expect from the 21st century
• You can programmatically read and write any Stable Diffusion variable exposed by the WebUI, such as negative_prompt and cfg_scale
• Supports natural language processing features such as auto-pluralization, finding synonyms, and even verb conjugation
• Includes a growing list of examples that demonstrate advanced functionality, such as customizing the weight of a choice list and applying emphasis to a random part of your prompt
• Comprehensive documentation that is always up-to-date
• Made by an organic human lifeform

🔧 Installation

We provide three methods of installation:

How to install directly... (click to expand)

1. Visit the Extensions tab of Automatic's WebUI.
2. Visit the Install from URL subtab.
3. Paste this repo's URL into the first field: https://github.com/ThereforeGames/unprompted
4. Click Install.

How to install through extensions index... (click to expand)

1. Visit the Extensions tab of Automatic's WebUI.
2. Visit the Available subtab.
3. Uncheck the "ads" filter and press the Load from button.
4. Scroll down to Unprompted and press the Install button. (Or use CTRL+F for convenience)

(NEW) How to install via pip for standalone use... (click to expand)

1. In your terminal, run pip install unprompted@git+https://github.com/ThereforeGames/unprompted
2. Refer to unprompted_dry.py for details on implementing Unprompted in your own Python projects

With either method, please be sure to restart your WebUI after installing. This allows Unprompted to download its Python dependencies.

📚 Usage

First, let's verify that your installation was successful by trying out an included template. Add this to your prompt:

[call common/examples/human/main]

This is a simple "person generator" that automatically chooses characteristics like hair color, race, and posture.

The [call] shortcode will look in unprompted/templates for the specified text file (so in this case unprompted/templates/common/examples/human/main.txt.) You do not need to enter the file extension.

Example output:

🚀 Next Steps

Now that you have verified Unprompted is installed and running correctly, you have a couple options:

1. Visit the 🎓 Guides page and follow our walkthrough on creating your own templates
2. Explore the comprehensive 📘 Manual and figure things out at your own pace

---

🛒 Premium Templates

While Unprompted is completely free to use, we do offer Premium Template packs that demonstrate some of the software's more advanced functionality.

Beautiful Soul Template

A highly expressive character generator for the A1111 WebUI. With thousands of wildcards and direct ControlNet integration, this is by far our most powerful Unprompted template to date.

DemonCrawl Avatar Generator

Generate pixel art in the style of DemonCrawl with this custom Stable Diffusion model! Trained on more than 50 avatars from the game. Create your very own character portraits even if you're not an artist!

Fantasy Card Template

Generate a wide variety of creatures and characters in the style of a fantasy card game. Perfect for heroes, animals, monsters, and even crazy hybrids.






_{Note: For context, I am a solo developer who is not associated with any commercial entities (beyond my own LLC), nor have I received any grants for this project. Unprompted was funded completely out-of-pocket. Your generosity helps justify the 100s of hours I spent developing this software. ❤️}

---

🙏 Acknowledgements

We would like to thank the authors of the following libraries, which are used by Unprompted:

• Python Shortcodes by Darren Mulholland
• Simple Eval by @danthedeckie
• Casefy by @dmlls
• CLIPseg by uddecke, Timo and Ecker, Alexander
• CLIP Surgery by Yi Li and Hualiang Wang and Yiqun Duan and Xiaomeng Li
• NLTK by Bird, S., Klein, E., & Loper, E., O'Reilly Media, Inc.
• pattern by Tom De Smedt and Walter Daelemans
• Moby Thesaurus II by Grady Ward
• Insightface by Jia Guo, Jiankang Deng, Xiang An, Jack Yu, Baris Gecer
• Ghost by A. Groshev, A. Maltseva, D. Chesakov, A. Kuznetsov and D. Dimitrov
• FaceFusion by Henry Ruhs
• GPEN by Tao Yang, Peiran Ren, Xuansong Xie, and Lei Zhang
• IQA-Pytorch by Chaofeng Chen and Jiadi Mo

---

🐛 Found a bug? Open an Issue.

💬 For discussion and template sharing, use the Discussion Board.

⭐ Like my work? Please consider giving the repo a "star" for visibility.