diff --git a/user_guides/templates.md b/user_guides/templates.md new file mode 100644 index 0000000..ef00c03 --- /dev/null +++ b/user_guides/templates.md @@ -0,0 +1,64 @@ +![template examples 1](https://github.com/AIrjen/OneButtonPrompt/assets/130234949/f5b96087-81fb-4a06-83a0-f209d085b5e3) + + +# Templates and "only templates" mode + +There is a small chance, that One Button Prompt generates a prompt based on a template instead of a fully randomized generated prompt. You can also force it to use "only templates". But what does this mean exactly? I hope to answer these questions here. + +This feature was build for beginners. Instead of copy/pasting existing interesting prompts from the web, I've already done so for you. There are currently over 500+ prompt templates available. + +Hopefully, this will inspire you as well. + +### What is a prompt __template__? +A __prompt template__ is a preconfigured prompt which uses One Button Prompt wildcards to be randomized. + +These __prompt templates__ are based on various popular existing prompts, from example civitai, prompthero, promptbook, replicable, openart sources. They try to add randomizition while keeping in line with the original prompt. + +Here is a good example from the [deliberate model](https://civitai.com/images/154634?modelVersionId=15236). This is the original image posted: + +original image + +> a girl, wearing a tie, cupcake in her hands, school, indoors, (soothing tones:1.25), (hdr:1.25), (artstation:1.2), dramatic, (intricate details:1.14), (hyperrealistic 3d render:1.16), (filmic:0.55), (rutkowski:1.1), (faded:1.3) + +This is the wildcarded prompt that is added to the __prompt templates__: + +> a -subject-, wearing a -accessory-, -food- in her hands, school, -minilocation-, (soothing tones:1.25), (hdr:1.25), (artstation:1.2), dramatic, (intricate details:1.14), (hyperrealistic 3d render:1.16), (filmic:0.55), (rutkowski:1.1), (faded:1.3) + +This means that most of the base prompt remains the same, however, some of the parts of the prompt have been replaced by wildcards. These are then replaced by a randomized value during prompt generation. + +Here are some examples of this specific prompt template: + +## Running with "only templates" +The prompt templates with show up once in a while during normal use of One Button Prompt. This can be set under __"type of image"__ . Set this to __"only templates"__. This will force One Button Prompt to only work bsaed of prompt templates instead of its normal randomized generation. + +![only templates option](https://github.com/AIrjen/OneButtonPrompt/assets/130234949/c60e4b5b-d4d4-4939-a1c4-ba8a575b2a7b) + +All prompt templates are classified with a subject type. This means you can use the __"Subject Types"__ field normally. So you can set it to any value such as __"animal"__ or __"humanoid"__, and it will take the prompt templates that match that type. + +I do have to say, that "humanoids" are overrepresented in the dataset, and "concept" are underrepresented. I did try to have as much diversity as possible in the set. + +## Subject Override and prompt templates +You can use __"Overwrite subject"__ as normal with the prompt templates. Meaning that your subject will be inserted in the prompt templates. + +Refer to [guide to override subject](https://github.com/AIrjen/OneButtonPrompt/blob/main/user_guides/override_subject_and_infinite_variations.md) for more information surrounding the override subject. + +__"Smart subject"__ has no effect when using prompt templates. + +Example: +![templates example with custom subject](https://github.com/AIrjen/OneButtonPrompt/assets/130234949/2fdc8835-62d0-4650-90d4-f966bf2de286) + +## Adding new prompt templates +You can add your own prompt templates as well, or even override the entire set with your own templates. This is done through the __custom files__ logic that works for every file in One Button Prompt. + +Refer to the basics here: [guide to custom files](https://github.com/AIrjen/OneButtonPrompt/blob/main/user_guides/custom_files.md) + +Refer to the wildcards here: [guide to using wildcards and Dynamic Prompts](https://github.com/AIrjen/OneButtonPrompt/blob/main/user_guides/wildcards_and_dynamic_prompts_extension.md) + +You can place a __"templates_addon.csv"__ or a __"templates_replace.csv"__ file in the __userfiles__ folder of One Button Prompt. + +Refer to __\csvfiles\templates\templates.csv__ for how the prompt templates are build up. + +The structure is as following: + +_prompt;source;sourcecategory;subjecttype;subjectwildcard_ +