<img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/659f0806-a86e-47bd-9ea3-967a94209175/original=true/659f0806-a86e-47bd-9ea3-967a94209175.jpeg" />A local Forge companion that builds structured prompt batches, runs them overnight, manages metadata-based upscales, and watches the boring parts, so your PC can do the babysitting for once.GitHub Link: <a target="_blank" rel="ugc" href="https://github.com/Bluenochian/Nightrun">https://github.com/Bluenochian/Nightrun</a>Nightrun is a portable workflow system for Stable Diffusion Forge / Forge-Neo.It is not a model.It is not a LoRA.It is not just another random prompt file.It is the thing that sits beside Forge and turns a messy local generation setup into something that can actually run for hours without you constantly checking if the prompt broke, the LoRA name was wrong, the GPU is cooking itself, or the whole batch slowly turned into repetitive garbage.Nightrun is built for long local runs, editable prompt pools, metadata replay, LoRA-aware batching, upscale workflows, cooldown logic, and controlled randomness.The goal is simple:Set the run. Leave it alone. Come back to something organized, replayable, and worth sorting through.---# ✨ What Nightrun doesNightrun builds prompts from editable pools, sends jobs through Forge, writes replayable metadata, manages upscales, scans LoRAs, protects long runs with cooldown logic, and keeps the whole thing configurable.It is made for people who want big batches without babysitting every prompt, every upscale, every progress bar, and every tiny local setup problem.Main idea:Controlled chaos, not prompt soup.---# 🌙 Main features## 🧩 Editable prompt poolsNightrun uses plain <code>.txt</code> prompt pools instead of one giant hardcoded prompt.You can edit the behavior of the whole machine by changing files like:- <code>concept</code>- <code>genre</code>- <code>abstract_idea</code>- <code>character</code>- <code>creature_and_nonhuman</code>- <code>hair</code>- <code>eyes</code>- <code>clothing</code>- <code>pose</code>- <code>body_pose</code>- <code>safe_pose</code>- <code>glamour_pose</code>- <code>expression</code>- <code>sensual_layer</code>- <code>body_focus</code>- <code>stocking_layer</code>- <code>equipment</code>- <code>environment</code>- <code>environment_rich</code>- <code>time_and_weather</code>- <code>lighting</code>- <code>camera</code>- <code>scene_depth</code>- <code>scene_embellishment</code>- <code>magic_element</code>- <code>aura_style</code>- <code>effects</code>- <code>style_layer</code>- <code>effect_layer</code>- <code>artist_direction</code>- <code>color_grade</code>- <code>composition</code>- <code>quality_style</code>- <code>detail</code>- <code>negative_extra</code>These are the normal engine of Nightrun.The world module system is deeper and optional. The pool system is where most users should start.---## 🎲 Controlled randomnessNightrun is random, but it is not stupid-random.You can configure:- pool chances- how many items each pool can pick- boosted chances when related pools appear- base step ranges- LoRA chances- LoRA weight ranges- maximum random LoRAs- maximum total LoRAs- world module chance- fusion mode chance- risky pool behavior- cooldown timing- upscale behavior- selection memory penalties- color repetition penaltiesSo the run can feel alive without turning into chaos soup.You are not stuck with one fixed behavior. You can tune the machine until it behaves like your machine.---## 🧠 Selection memoryDuring a run, Nightrun remembers recent choices and penalizes repetition.That means it can push away from using the same colors, same pool entries, and same prompt patterns too often.It can track broad color families like:- blue- cyan / teal- red- purple- green- gold- black- silver- iridescentSo if a batch starts drifting too hard into one color mood, Nightrun can push it away.This is one of the reasons long runs do not feel as repetitive.---## 👁️ Rare detail controlSome details are cool only when they stay rare.For example, heterochromia can be controlled so it does not suddenly take over the whole batch.Because special eyes stop feeling special when every third image has them.---# 🧬 LoRA handlingNightrun does not just slap LoRAs into the prompt and pray.It can:- scan local LoRA folders- resolve names- use aliases- soft-match ugly filenames- skip missing LoRAs safely- randomize LoRA weights- add synergy/support LoRAs- cap random LoRAs- cap total LoRAs- deduplicate final LoRA tagsThis matters because local LoRA libraries are messy.Sometimes the Civitai name, trigger name, and local filename are all slightly different because apparently peace was never an option.Nightrun tries to survive that.---## 🧪 LoRA safetyNightrun can skip missing LoRAs instead of crashing the whole run.It can also limit how many random LoRAs appear and how many total LoRAs can stack.That means the prompt does not become a cursed pile of everything at once.---## 🧬 LoRA synergiesIf a trigger LoRA is selected, Nightrun can add matching support LoRAs with controlled chances and weights.So instead of all LoRAs being isolated random events, some can behave like small connected systems.---# 🧠 Coherent world modulesThe world module system is optional.The normal prompt pools are the everyday engine.The world module system is the coherence layer.When it activates, Nightrun selects a world/franchise module from <code>franchise_catalog.py</code> and can pull related pieces from the same source family.That helps the prompt stay internally consistent instead of mixing ten unrelated aesthetics into one broken image.World modules can include:- character archetypes- outfits- environments- props and equipment- factions- technology- magic systems- landscapes- architecture- creatures- ships- droids- lighting mood- color palettes- cinematic language- prompt modifiersThe point is not to replace the normal pools.The point is to give the run a coherent themed spine when that system activates.---## 🎭 Fusion modeCoherence is good.But sometimes you want controlled madness.Fusion mode lets Nightrun allow stranger cross-world combinations while reducing risky generic pool chances.So you can still get unusual mixes, but the machine is not blindly dumping everything into the same prompt like a raccoon in a keyboard factory.---# 🔥 Long-run safetyNightrun is made for long runs, so it includes systems that care about the machine too.## GPU temperature pauseNightrun can watch GPU temperature through <code>nvidia-smi</code>.If the GPU gets too hot, it pauses.When the GPU cools below the configured resume temperature, it continues.That means the run can protect itself instead of mindlessly hammering the card all night.---## 🧊 VRAM chill sessionsFor big batches, Nightrun can schedule random cooldown sessions every now and then.Example flow:- run several generations- pause for a few minutes- let the system settle- continue the batchIt is a small thing, but for overnight workflows it matters.Nightrun is not just “go fast.”It is “keep going safely.”---## 💤 Between-image restYou can also configure sleep time between images.So even outside big cooldown sessions, the machine does not have to be tortured nonstop like it owes you money.---# 🚀 Upscale workflowNightrun supports both scheduled upscale workflows and metadata-based re-upscaling.It can:- generate base images- upscale during full runs- auto-upscale low-step base renders- drag and drop metadata into the upscaler- recreate from metadata if needed- write new metadata beside upscaled images- chain later upscales from previous upscale metadataThis matters because a fast base image does not have to stay a rough base image.If the base render used low steps, Nightrun can still send it through upscale logic and recover quality without wasting time on every single base generation.---## 🎲 Randomized base stepsNightrun can randomly choose base steps between the configured minimum and maximum.That means not every image has to use the exact same render cost.Some images can be faster.Some can be heavier.The batch gets more natural variation.---## 🚀 Low-step auto-upscaleIf a base render lands under the configured step threshold, Nightrun can automatically send it through the upscale path.So a faster hybrid run does not automatically mean throwaway previews.You can save time on base generations and still get usable final images through upscale logic.---# 🪄 Metadata replayEvery image can get a metadata sidecar with the important pieces saved.That can include:- seed- prompt- negative prompt- selected pools- selected modules- LoRAs- LoRA sources- base steps- status- upscale reason- errors- GPU info when availableSo later, you are not staring at a good image wondering:What the hell made this?The answer is saved beside it.---# 🧪 Validation and dry-run modesBefore wasting GPU time, Nightrun can test itself.## Validation modeChecks things like:- pool loading- prompt formatting- LoRA resolution- missing resources- alias behavior- generation logic## Dry-run modeWrites prompt and metadata without calling Forge image generation.So you can see what the run would do before committing to a real batch.Basically:Measure twice, render once.---# 📊 Prompt variety analyzerNightrun includes a tool for checking old metadata and finding patterns.It can report things like:- repeated categories- repeated colors- repeated modules- repeated prompt fragments- world module usage- exact prompt repeats- signs that a batch is becoming too sameyThis helps tune the machine instead of guessing.---# 🖥️ First-run setupThe setup script helps create a local configuration for your machine.It can:- ask for your Forge / Forge-Neo path- ask for output folder- detect VRAM profile- check checkpoint path- count local LoRAs- check for Ultimate SD Upscale- create <code>config.local.json</code>- create setup diagnostics- create desktop shortcutsThe shared <code>config.json</code> stays portable.Your private machine paths stay in <code>config.local.json</code>.That means the project can be shared without leaking your local folder structure.---# 🧯 Clean stop signalNightrun can stop cleanly after the current image.No killing the terminal.No murdering Forge mid-generation.No half-dead run folder full of sadness.You hit the stop signal launcher, and Nightrun exits after the current image is done.---# 🧭 Included launchersNightrun includes Windows launchers for common workflows:- <code>Run First Setup.bat</code>- <code>Run Validation Stress Test.bat</code>- <code>Run One DRY TEST.bat</code>- <code>Run Nightrun BASE only.bat</code>- <code>Run Nightrun FULL upscale.bat</code>- <code>Run 2x Upscale From Metadata.bat</code>- <code>Run Prompt Variety Analyzer.bat</code>- <code>Stop After Current Image.bat</code>- <code>Clear Stop Signal.bat</code>The idea is to make normal use easy without hiding the deeper config from people who want to tune everything.---# ⚙️ What you can configureA lot.Nightrun can be tuned through config sections for:- image count- checkpoint- VAE- Forge preset- CLIP skip- positive prompt prefix/suffix- negative prompt- base resolution- base sampler- base scheduler- CFG- random step range- upscale settings- low-step auto-upscale threshold- temperature pause- cooldown sessions- sleep between images- console behavior- empty run cleanup- selection memory- prompt pools- LoRA pools- random LoRAs- LoRA synergies- LoRA scanning- world module behavior- fusion behavior- maximum LoRA limitsIt is meant to be modified.This is not a locked black box.It is a machine you can tune.---# 📦 OutputsRuns create organized folders like:<code>nightrun-YYYYMMDD-HHMMSS</code>Inside, you may see:- <code>0001_base_WIDTHxHEIGHT.png</code>- <code>0001_upscale_WIDTHxHEIGHT.png</code>- <code>0001_prompt.txt</code>- <code>0001_metadata.json</code>- <code>summary.json</code>- <code>run.log</code>- <code>contact_sheet.jpg</code>- <code>validation_report.json</code>The exact files depend on the mode you run.---# 🛠️ Basic usageRun setup first:<code>Run First Setup.bat</code>Validate before rendering:<code>Run Validation Stress Test.bat</code>Preview one prompt without rendering:<code>Run One DRY TEST.bat</code>Run base generation:<code>Run Nightrun BASE only.bat</code>Run full generation with scheduled upscale:<code>Run Nightrun FULL upscale.bat</code>Stop cleanly after the current image:<code>Stop After Current Image.bat</code>---# 🪄 Metadata upscalingBasic upscale from metadata:<code>py upscale_from_metadata.py "D:\renders\0001_metadata.json" --config config.local.json --scale 2</code>Force base image as source:<code>py upscale_from_metadata.py "D:\renders\0001_metadata.json" --config config.local.json --source base --scale 2</code>Use an existing upscale as source:<code>py upscale_from_metadata.py "D:\renders\0001_metadata.json" --config config.local.json --source upscale --scale 2</code>Dry-run the upscale:<code>py upscale_from_metadata.py "D:\renders\0001_metadata.json" --config config.local.json --scale 3 --dry-run</code>---# ✅ Recommended forNightrun is useful if you:- use Forge / Forge-Neo locally- generate in large batches- want overnight runs- hate babysitting progress bars- want editable prompt pools- want safer long-running workflows- use many LoRAs- want metadata replay- want upscaling tied to generation metadata- want less repetitive outputs- want a workflow that can be tuned instead of replaced---# ⚠️ NotesNightrun does not include:- checkpoints- LoRA files- model files- Forge itself- Ultimate SD Upscale- copyrighted assetsYou need your own local Forge / Forge-Neo setup and your own models.Franchise/world module names are used as inspiration labels for prompt organization.---# 📝 Release summaryNightrun is a portable Forge / Forge-Neo workflow system with editable prompt pools, local LoRA scanning, coherent world modules, thermal pause, long-run VRAM chill, randomized base steps, low-step auto-upscale, metadata replay, clean stop control, prompt variety analysis, and drag-and-drop metadata upscaling.---🌙 Built for the dark hours between intention and discovery.

Files with SHA256: dc8303c5146ca346e527b244f93e958abf511b5d213dd7a91ff53bb9bd519d6d