tjm35 / unprompted

Text generator written for Stable Diffusion workflows.

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

Introduction

Unprompted is a powerful templating language written in Python.

Unlike most templating languages, Unprompted was designed for maximum readibility with natural language. It is built around [shortcodes] and inspired by the likes of BBCode.

You can use Unprompted as a standalone library (e.g. unprompted_dry.py) or as an extension for AUTOMATIC1111's Stable Diffusion Web UI. The extension allows you to create expressive, re-usable prompt templates that are both versatile and easy on the eyes.

Features

• Dozens of shortcodes provided out of the box - there are [if] conditionals, powerful [file] imports, [for] loops and everything else the prompting enthusiast could possibly want
• Easily extendable with custom shortcodes
• Simple creation of .txt templates that can be organized according to your preferences
• Supports recursion, nested shortcodes, advanced logic operators, custom configs, pretty much all the good stuff one might expect from a modern language
• Supports numerous Stable Diffusion variables such as negative_prompt and cfg_scale
• 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
• Free
• Developed by a human

Installation

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.

Usage

First, try the included demo template by entering the following as your prompt:

[file human/main]

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

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

Example output:

Next Steps

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

1. You can visit the 🎓 Starter Guide for a crash course on creating your own templates
2. Or dive into the deep end by exploring the comprehensive 📘 Manual

Premium Templates

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

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.







Purchases help fund this project. Your support is greatly appreciated! ❤️

Acknowledgements

A big "thank you" to the authors of the following libraries that Unprompted depends on:

• Python Shortcodes by Darren Mulholland
• Simple Eval by @danthedeckie
• Casefy by @dmlls
• CLIPseg by uddecke, Timo and Ecker, Alexander

🔧 Found a problem? Open an Issue.

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