$git clone https://github.com/HallettVisual/Regional-Prompt-Upscaler-DetailerVersion: 1.3 Author: Matthew Hallett
| 1 | # **Regional Prompt Upscaler and Detailer** |
| 2 | |
| 3 | **Version:** 1.3 |
| 4 | **Author:** [Matthew Hallett](https://hallett-ai.com) |
| 5 | |
| 6 | The **Regional Prompt Upscaler and Detailer** is an upscaler+detailer extension for **Automatic1111 Web UI** and **Forge**, based on [Ultimate Upscale for Automatic1111](https://github.com/Coyote-A/ultimate-upscale-for-automatic1111). This extension enhances the upscaling process by intelligently applying region-specific prompts to each tile before generation, leveraging four different Vision-Language Models (VLMs). The result? Sharper details in key areas while keeping large, smooth regions—like skies—artifact-free and natural-looking. |
| 7 | With easy prompt filtering, quick LoRA selection, and precise feather and overlap controls, this version builds on everything great about Ultimate Upscaler—and takes it even further. If you liked the original, you’ll love this. |
| 8 | |
| 9 | ## **Features** |
| 10 | |
| 11 | - **Auto Prompt Generation Methods Per Tile** |
| 12 | Generate region-specific prompts using **BLIP**, **Florence-2**, **CLIP**, or **ViT-GPT2**, each providing a unique style of image detection. |
| 13 | |
| 14 | - **Easily Remove False Prompts Before Generation** |
| 15 | Remove prompts before generation that you know will cause undesirable hallucinations |
| 16 | |
| 17 | - **Auto Tile Scaling** |
| 18 | Dynamically chooses tile size based on your image dimensions, ensuring efficient tiling and consistent results. |
| 19 | |
| 20 | - **Regional Prompt Export/Import via Excel** |
| 21 | Export tile prompts to a .xlsx file for batch editing, then re-import them to streamline your workflow. |
| 22 | Example of an exported Excel file: |
| 23 | |
| 24 |  |
| 25 | |
| 26 | - **Simple or Complex Prompt Modes** |
| 27 | Quickly switch between short (“Simple”) or in-depth (“Complex”) prompts, depending on the detail level you want. |
| 28 | |
| 29 | - **Advanced Feathering & Overlap** |
| 30 | Control feathering and overlap percentages to blend tiles seamlessly without visible transitions. |
| 31 | |
| 32 | - **Convenient LoRA Selection** |
| 33 | Apply LoRA models via a straightforward dropdown. The script injects these settings into each tile prompt automatically. |
| 34 | |
| 35 | - **No Resolution Limits** |
| 36 | Upscale far beyond 4X by repeatedly applying multi-generation upscaling and prompt control, achieving extremely high resolutions. |
| 37 | |
| 38 | - **Works with Flux, SD, SDXL & SD3** |
| 39 | Fully compatible with modern pipelines, letting you leverage your preferred models and control methods. |
| 40 | |
| 41 | --- |
| 42 | |
| 43 | ## **Benefits** |
| 44 | |
| 45 | 1. **Granular Regional Customization** |
| 46 | Apply unique prompts to specific image regions for ultra-fine control. |
| 47 | |
| 48 | 2. **Integrated & Easy to Use** |
| 49 | Fully embedded in Automatic1111 and Forge, with a simple installation process. |
| 50 | |
| 51 | 3. **Automation for Efficiency** |
| 52 | Handles prompt creation, tiling, and blending automatically, so you get high-quality results with minimal manual overhead. |
| 53 | |
| 54 | 4. **Flexible Prompt Length** |
| 55 | Toggle between simple or detailed prompts for creative freedom or quick iteration. |
| 56 | |
| 57 | 5. **Professional Results** |
| 58 | Ideal for architectural renders, aerial photography, or any creative composition requiring clarity and detail. |
| 59 | |
| 60 | --- |
| 61 | |
| 62 | ## **Installation** |
| 63 | |
| 64 | ### **Option 1: Automatic Installation (Recommended)** |
| 65 | |
| 66 | 1. **Download** this repository or grab the ZIP from the [Releases](../../releases). |
| 67 | 2. Extract the contents to a folder on your computer. |
| 68 | 3. Run the `install_free_upscaler.bat`: |
| 69 | - The installer automatically locates your Automatic1111 or Forge root folder. |
| 70 | - It copies all required files and installs dependencies. |
| 71 | 4. Restart your WebUI. The extension will appear in the **Extensions** tab. |
| 72 | |
| 73 | ### **Option 2: Manual Installation** |
| 74 | |
| 75 | 1. **Download** this repository or grab the ZIP from the [Releases](../../releases). |
| 76 | 2. Extract the contents somewhere on your computer. |
| 77 | 3. Copy the following files/folders into your WebUI installation: |
| 78 | - `__init__.py` and `requirements.txt` into: |
| 79 | ``` |
| 80 | <WebUI Directory>/extensions/regional-prompt-upscaler-hallett/ |