Create, manage, refine, and present locally generated AI artwork.
This guide explains the current Windows application from first launch through advanced prompting, LoRAs, face tools, image refinement, generation history, and the fullscreen slideshow.
Public Demo and Licensing
The combined Z-Image Turbo/Krea 2 public Demo provides the complete local generation workflow. Its restriction is a translucent tiled 65West logo written into every completed image. While the application is not activated, the header explains that activating with a purchased license key removes the Demo watermark from future generated images. This note disappears immediately after successful activation. The header also shows the current entitlement state and provides a silver Manage License button.
Fully functional Demo
No image-count or time limit is imposed. Z-Image Turbo, Krea 2 Turbo, Generation, and Auto-Generate remain available after the local PIN is accepted, with the watermark applied as the final output operation.
Perpetual license
A purchased 65West AI Image Generator license removes the watermark from future generations. It may be active on two devices and can be deactivated when an activation needs to be transferred.
- The watermark is embedded in ZT and K2 main completed images, Session History images, preserved original-size variants, manual saves, and automatic saves.
- Images created in Demo mode are not retroactively changed after activation.
- License activation, validation, and deactivation use the production 65West licensing service and signed offline certificates.
- The numeric PIN remains a local access-control feature and is not a commercial authorization mechanism.
- The installer still displays the Terms of Use and requires acceptance before setup continues.
- Models, VAEs, LoRAs, outputs, settings, generated images, and other creative files remain locally managed.
Quick Start
Launch and unlock
Open the program using its launcher. On first launch, create a numeric PIN; later launches request that PIN before the application opens. After local access is confirmed, the ZT/K2 workspace opens in its normal maximized state.
Select the model
Choose an installed Z-Image Turbo or Krea 2 Turbo model under Active Model. Fresh setup installs both protected official default models (approximately 70 GB combined) and their matching managed VAEs. Krea 2 requires acceptance of its Hugging Face model terms; run Setup_Krea2_Model_Access.bat if access is needed. Switching model families automatically selects the matching managed VAE and recommended scheduler shift.
Write the prompt
Describe the subject, environment, composition, lighting, wardrobe, camera view, and intended medium. Add optional LoRA, wildcard, or face-reference tags.
Choose generation settings
Select Ideal Portrait or Ideal Landscape for recommended Z-Image Turbo dimensions, or choose custom width and height values. Then set steps, seed behavior, sampler recipe, scheduler shift, and optional tools such as Face Swap or the Face Detailer.
Generate
Click Generate Image. A live preview initially appears in the lower-right corner of the main viewer while sampling is underway and can be moved anywhere over the application window.
Review and save
The finished image appears in the main viewer and Generation History. Save generated image automatically on completion is off by default; enable it when completed images should be written directly to the selected output directory. The application-owned location appears simply as Output and resolves to the Output folder inside the application root. The full-width Notes box near the bottom of the options panel can be used for project notes, prompt ideas, LoRA observations, or other reminders.
res-multistep - simple, scheduler shift 3.0, random seed enabled, and leave optional post-processing off.Interface Overview
Prompt Profiles • Prompt • Preview • LoRAs • Refinement • Color • Render Controls • Comparison
Face Swap • Face Detailer • Random Faces
Model • VAE • Memory • Wildcards • Output • Interface
Image Slideshow
Notes
Clear History
Clear Selected
Save Selected
View Prompt
Expand Viewer
Balanced Layout
Header controls
| Control | Purpose |
|---|---|
| Generate Image | Starts one generation using the current controls. |
| Auto-Generate | Continuously generates new images. With random-seed mode enabled, every cycle receives a new seed. |
| Stop Generation | Requests a stop during the active generation. |
| Refresh AI Memory | Performs a quick cleanup of disposable AI runtime allocations while retaining the loaded base model. Its dropdown also provides a confirmed Deep Pipeline Reset. |
| User's Guide | Opens this fully formatted HTML guide in a separate app-style browser window sized for comfortable reading. |
| Progress bar and timer | Show the current step progress and elapsed generation time. |
| Resource monitor | Shows live GPU RAM and SYSTEM RAM usage in a compact vertical stack directly beneath the Generation Time and command buttons. Each monitor includes a utilization bar that is green below 70%, yellow from 70% through 84%, and red at 85% or higher. The visible Refinement Capacity bar has been retired; refinement safety is still evaluated from a fresh memory snapshot immediately before the refinement pass. |
Layout controls
Expand Viewer gives more horizontal space to the image area. Balanced Layout restores the standard split between options and viewer. The divider can also be dragged manually, and the program remembers the layout.
Program Functions panel order
The left panel is divided into workflow groups. Interface Style is now the first function, directly above the Prompt, and every existing control retains the same behavior and saved settings.
Each framed function uses a subtly lighter surface than the surrounding main panel. The surface color follows the selected Interface Style automatically, making related controls easier to distinguish without changing their layout.
65West Theme is the official branded presentation and remains the default. It uses the master palette from the supplied brand sheet: near-black navy surfaces, electric cyan framing, blue/violet/magenta accents, metallic-silver identity text, and the official 65West application icon. Other Interface Style choices remain available and continue to preserve the same control layout.
The Program Setup and Utility headings each include a Hide functions checkbox. Checking it collapses all functions in that group while keeping the heading and checkbox visible. Unchecking it restores the group, and both choices are remembered between launches.
| Group | Functions from top to bottom |
|---|---|
| Core Generation Settings | Interface Style |
| Prompt window and Clear Prompt | |
| Live Preview | |
| Included LoRAs | |
| Image Refinement – Second Pass | |
| Image Post Processing | |
| Width and Height | |
| Steps and Seed | |
| Sampler / Scheduler | |
| Cached Image Comparison | |
| Optional Generation Settings | Prompt Face Swap |
| Automatic Face Detailer | |
| Random Faces | |
| Program Setup | Model Directory and Active Model |
| VAE Directory and Active VAE | |
| Memory Mode | |
| Wildcard Folder and wildcard instructions | |
| Save Automatically and Output Directory | |
| Viewing Tools | Image Slideshow |
| Utility | Notes |
Model-loading status: A wide model-optimization notice and animated activity bar appear in the center of the main interface while model, VAE, or LoRA preparation is underway. When a supported external Krea 2 BF16 checkpoint needs its one-time conversion, the notice identifies the checkpoint, its size, estimated temporary disk-space requirement, reusable Diffusers cache, and the current validation, conversion, cache-writing, or component-loading stage. The activity bar intentionally does not display an ETA or percentage because the underlying conversion and serialization operations do not report reliable completion data. During optimization, all other interface controls are temporarily locked and cannot be selected. The locked interface is covered by a neutral semi-transparent black fade instead of bright disabled-control colors. Each control returns to its previous state automatically when optimization finishes or fails.
65West-App.ico in the taskbar and window switcher instead of the generic Python icon. The taskbar correction targets both Tk’s inner client handle and its Windows wrapper, assigns the wrapper class icons, and reapplies the branding after the maximized window is revealed. The default 65West Theme now uses the official dark navy/black foundation, metallic-silver identity text, cyan framing and progress indicators, blue/violet/magenta interaction states, branded menus and loading overlay, and a dark cyan-accented prompt editor. Stop Generation remains red so its safety purpose is immediately recognizable.install.bat sets up the private python\python.exe runtime and installs both protected official defaults under Models\65West_Default_Model and Models\Krea-2-Turbo-Official. Krea 2 access is gated by Hugging Face terms. Restore_Default_Model.bat repairs or resumes both defaults, while Install_Default_VAE.bat repairs both managed VAEs.#B6F799 background with black text. Applying or changing any installed interface theme no longer changes the prompt workspace colors.Tongyi-MAI/Z-Image-Turbo model. The active model cache is also retained, while other inactive app-generated model caches remain eligible for removal after a replacement model loads successfully.Restore_Default_Model.bat to repair or resume either protected official model. It uses only the private application runtime and does not delete external models.Models folder is preferred when available; otherwise the official Tongyi-MAI/Z-Image-Turbo repository identifier is used. A deliberately configured Model directory is never overridden by this fallback.text_encoder, transformer, and vae weight shards are excluded because they are components of the pipeline, not independent models. Genuine standalone .safetensors and .ckpt models stored outside a Diffusers pipeline remain selectable. A previously saved internal-shard selection is automatically replaced with the complete default pipeline at startup when the Model directory field is blank.Prompting
The prompt box appears directly below Interface Style in the left options panel. Z-Image Turbo responds best when the prompt describes what should be visible rather than relying on a traditional negative prompt.
A small Clear Prompt button sits directly beneath the prompt input and instantly empties the prompt text box. Right-click inside the prompt editor for Cut, Copy, Paste, and Select All. Keyboard users can open the same menu with Shift+F10.
Prompt Profiles
The Prompt Profile controls appear at the top of the Prompt group. They provide reusable snapshots of the prompt and the settings that affect generation.
| Control | Behavior |
|---|---|
| Profile pulldown | Selects an existing saved profile. Selecting a name does not change the interface until Load is clicked. |
| Save As | Prompts for a unique profile name and saves the current prompt and generation settings. |
| Load | Applies the selected profile while preserving the active model, VAE, their library directories, memory mode, sampler/scheduler choice, and scheduler shift. Loading a profile does not start a base model or VAE reload. Included LoRA changes are applied by the normal generation path the next time Generate is clicked. |
| Update | Replaces the selected profile with the current prompt and generation settings after confirmation. |
| Delete | Deletes the selected saved profile after confirmation without changing the controls currently shown. |
Profiles are kept as versioned JSON files in the application’s prompt_profiles folder. Loading a profile validates referenced local resources. A missing LoRA, upscaler, wildcard folder, or face folder is identified in a warning; the unavailable item is skipped while compatible settings continue to load. Random Faces is disabled automatically when its saved folder is unavailable.
Useful prompt order
Subject → appearance → pose/action → environment → composition → lighting → rendering medium.
Keep instructions concrete
Specify figure count, clothing coverage, camera distance, body visibility, background activity, and rendering medium when those details matter.
Example
A single adult female explorer, full-body standing pose, practical fitted expedition clothing, leather boots, holding an antique map, ancient jungle temple entrance, centered composition, warm rim lighting, detailed cinematic environment
Prompt emphasis
Automatic1111-style prompt emphasis is enabled by default. The Enable Automatic1111 prompt weighting checkbox directly below the Prompt editor controls the feature, and the selected setting is remembered. Clear the checkbox when parentheses or brackets should be treated as ordinary prompt characters. When disabled, prompts use their literal text without emphasis parsing.
When the checkbox is enabled, the help line below the Prompt editor summarizes the supported syntax. Emphasis is applied after wildcard, inline-choice, face-reference, and LoRA-tag processing using the active model family’s dedicated text-encoding path.
| Syntax | Effect |
|---|---|
(detailed eyes) | Increases attention to the enclosed text by 1.1×. |
((detailed eyes)) | Nested parentheses multiply the effect to 1.21×. |
(detailed eyes:1.5) | Uses an explicit custom weight of 1.5×. |
[background detail] | Reduces attention by dividing the weight by 1.1. |
\(literal text\) | Displays literal parentheses without applying emphasis. |
Effective weights are limited to the safe range of 0.0× through 3.0×. Excessive weights can reduce image quality, so values around 1.1× through 1.5× are the recommended starting range. If the active tokenizer cannot map an emphasized phrase safely, generation continues with the emphasis punctuation removed and records the fallback in the generation metadata instead of stopping the program.
Clear the checkbox to use literal parentheses and brackets in a prompt without emphasis parsing.
Inline choices
Use braces to randomly select one option during prompt expansion. Nested choices are supported.
A {red|blue|green} jacket, {sunrise|overcast afternoon|night lighting}
Wildcards
Place text files in the selected wildcard folder and call them with double underscores:
portrait of __character_type__ in __location__
Face-reference tag
Automatic face selection can be requested directly in the prompt:
<face_ref:Sarah.png> <face_ref:Sarah>
The program searches the configured Prompt face-ref folder recursively and removes the tag before sending the cleaned prompt to the model.
LoRA tags
<lora:style_name:0.8>
<lora:style_name:{0|0.5|1.0}>
Models, VAE & Memory
Model directory and Active Model
The Model directory provides a local library that can be scanned with Refresh. If the field is blank, the program automatically uses the Models folder in the application’s root directory. Use Browse beside the Model directory field to select a different model library folder. Choose the model to load from the full-width Active Model pulldown, which can also accept a model path or supported repository identifier.
.safetensors files. FP8 (scaled or unscaled), FP16, FP32, INT8, NVFP4, GGUF, and .ckpt external Krea 2 models are not supported. The official Krea 2 Diffusers model remains supported.Keep the active external model and both protected defaults in the Transformers cache is an optional disk-space setting and is on by default. When enabled, the program waits until a replacement model has loaded successfully, preserves the active standalone-model cache, and permanently preserves caches owned by both setup-installed defaults: Tongyi-MAI/Z-Image-Turbo and krea/Krea-2-Turbo. Other inactive app-generated cache-key folders may be removed. The installed model folders under Models, original external checkpoints, VAEs, and LoRAs are never removed. Full memory reset releases only runtime objects from GPU and system memory.
Full memory reset before loading a different model remains a visible preference. In the current worker-based runtime, a genuinely different Active Model starts a fresh worker process regardless of this checkbox, which releases the old process’s system and GPU allocations. Switching models may take longer because compatible components are loaded again. No installed model, VAE, image, prompt, setting, or disk cache is deleted.
logs help diagnose failures.A freshly selected model can take time to preload in its worker. Loading failures are reported in the interface and in logs.
VAE
Fresh setup installs and verifies separate official VAEs for both model families: VAE\65West_Default_ZImageTurbo_VAE and VAE\65West_Default_Krea2_VAE. Changing the Active Model between Z-Image Turbo and Krea 2 automatically changes the visible Active VAE to the matching managed default before the model is loaded. Choosing a custom VAE directory refreshes the selector and clears Active VAE without automatically loading a replacement. A compatible custom VAE may still be selected manually. If the matching managed default is unavailable, blank Active VAE safely falls back to the VAE included with the selected pipeline. Run Install_Default_VAE.bat to repair both default VAEs without reinstalling the rest of the application.
Memory modes
| Mode | Use |
|---|---|
| Auto (recommended) | Lets the program choose the appropriate stable path for the selected model and hardware. |
| Optimized 16GB (4-bit GPU) | Krea 2 optimized Diffusers path with a 4-bit transformer and dedicated 8-bit Qwen3VL text encoder. |
| Optimized 16GB (8-bit GPU) | Quantized GPU path where supported. The Krea 2 optimized pipeline uses a 4-bit transformer and 8-bit text encoder. Supported standalone Krea 2 BF16 .safetensors checkpoints load through the native Diffusers backend. |
| GPU (BF16 - high VRAM) | Fuller precision path for systems with substantially more VRAM. |
| CPU offload | Moves selected components between CPU and GPU to reduce VRAM pressure. |
| Sequential CPU offload (lowest VRAM) | Most conservative VRAM option, usually with the largest speed penalty. |
LoRAs & Wildcards
Included LoRAs panel
Use Browse/Add to add one or more LoRAs. If the LoRA folder field is blank, the program automatically uses the LoRAs folder in the application’s root directory for browsing, discovery, and prompt tags. The Included LoRA list expands vertically as items are added so every listed LoRA remains visible without a vertical scrollbar. The list shows status, filename, and strength. Double-click the Status or LoRA area to toggle an item between Enabled and Disabled. Double-click its Strength cell to edit the value directly, then press Enter or click elsewhere to apply it. The accepted range is -2.0 through 2.0, and the edited value is saved and used for generation immediately.
- Hide All LoRA Options collapses every other control in the Included LoRAs group. The checkbox remains visible so the complete group can be restored. It is unchecked by default and does not change any LoRA selection, strength, or enable/disable state.
- Hide included LoRA list collapses the LoRA list and its selection controls to save vertical space. Uncheck it to restore the complete list. The selected LoRAs and their enabled/disabled states are preserved while hidden, and the preference is remembered between launches.
- Disable Included LoRAs temporarily — prompt tags remain active preserves the Included list but prevents those entries from being used.
- Ignore Prompt LoRA Tags temporarily leaves tags in the prompt text but omits their adapters during generation.
- Disable All LoRAs temporarily disables Included and prompt-tagged LoRAs without deleting either source.
- If the same file appears in both sources, the prompt-tag strength takes precedence and the model is loaded only once.
- All strengths must be finite values from -5.0 through 5.0. Strong multi-LoRA stacks are reported in the status, generation log, and PNG metadata but are not silently normalized.
- Default LoRA strength when browsing controls the initial strength assigned to newly added files.
- The former Selected added LoRA strength box and Apply Strength button are no longer needed; each row owns its editable strength value.
- Prompt-tag LoRAs continue to work from the configured LoRA folder.
Wildcard folder
Each wildcard file is a plain .txt file with one option per line. A tag such as __lighting__ reads from lighting.txt. Nested wildcards are chosen randomly; circular references and recursion errors report the wildcard chain and file involved in the generation error and log.
Generation Settings
| Setting | What it controls |
|---|---|
| Width / Height | Final image dimensions. Select 512, 640, 768, 832, 864, 896, 1024, 1152, or 1216 pixels from either pulldown, or type any positive whole-number values directly. Typed values override and clear the active ideal-dimensions preset. The program automatically uses the nearest pipeline-safe internal dimensions, then returns the image at the exact Width and Height entered before optional upscaling or border processing. |
| Ideal Portrait (3:4) | Sets Width and Height to 864 × 1152, a recommended portrait layout for Z-Image Turbo. |
| Ideal Landscape (4:3) | Sets Width and Height to 1152 × 864, a recommended landscape layout for Z-Image Turbo. The two ideal presets are mutually exclusive and the selected preset is remembered. |
| Steps | Number of denoising steps. Turbo models are intended to work with a relatively small number of steps. |
| Turbo guidance | Fixed internally at 0.0 for Z-Image Turbo stability. Because it cannot be changed, no Guidance control is displayed on the interface. Traditional CFG and negative-prompt behavior should not be expected. |
| Seed | A fixed seed reproduces the same noise pattern when the other settings remain the same. |
| Random seed each generation | Creates and displays a new full seed at the beginning of every generation, including every Auto-Generate cycle. |
| Sampler / Scheduler | Z-Image Turbo offers res-multistep/simple, res-multistep/beta, res-multistep/sgm_uniform, Euler/simple, and Euler/beta. Krea 2 shows only Euler/simple and Euler/beta. Changing the selection for the active model does not require a model reload. |
| Scheduler shift | Allowed range: 0.5–6.0. The suggested default is 3.0 for Z-Image Turbo and 1.15 for Krea 2. Switching model families updates the visible shift to the matching default. The effective sigma schedule is logged for each generation; Cached Image Comparison locks the preceding image’s shift. |
| Image Refinement | Optional second image-to-image diffusion pass for visibly stronger detail, lighting, tonal separation, and depth. |
Image Refinement (Second Pass)
Image Refinement performs an optional image-to-image second pass using the selected model family and its active pipeline components. It shares the loaded model, VAE, text encoder, scheduler, and compatible LoRAs rather than loading a duplicate base model.
The second pass uses a dedicated refinement-only prompt. Landscape and object scenes receive a neutral locked-scene instruction without human-specific identity vocabulary. Scenes that request people receive a separate identity and figure-count lock. This prevents the refinement prompt itself from encouraging new people or other narrative content.
Controls
| Control | Behavior |
|---|---|
| Enable Image Refinement | Runs the second diffusion pass after the base generation and Figure Count Guard, before Face Swap, Face Detailer, and Image Post Processing. |
| Profile | Selects Analog Photo, Fine Detail, Balanced Detail & Lighting, Natural Lighting, Studio Lighting, Cinematic Lighting, Dramatic Lighting, or Golden Hour. |
| Strength | Low uses 0.18 for maximum preservation; Medium uses 0.25 for a restrained balanced refinement; High uses 0.32 for a more visible treatment with additional composition-change risk. |
| Internal size | Enlarges the source internally to 1.25× or 1.50× for the refinement pass. The refined image is reduced back to the selected output dimensions afterward. |
| Preserve Original | Adds the unrefined base generation to Generation History before the refined result. When Auto-save is enabled, both variants are also saved to the Output folder with Original and Refined in their filenames. |
Analog Photo profile
Analog Photo gives the refined result the character of a professionally scanned 35mm color-negative photograph while preserving the original subject and composition. It combines conservative image-to-image guidance with a restrained finishing stage at the selected output size.
This refinement profile is independent of the existing Analog Photo option in Image Style Enhancer. The enhancer influences the initial generation; the refinement profile polishes an already-generated image. They can be used separately or together.
- Adds deterministic fine emulsion-style grain rather than coarse digital noise.
- Softens highlight roll-off and applies subtle warm halation only around existing bright areas.
- Gently warms film-stock color, keeps skin and materials natural, and preserves readable shadow detail.
- Reduces excessive digital microcontrast and edge crispness without broadly blurring the image.
- Does not intentionally add scratches, dust, borders, light leaks, heavy fading, or an aged-photo effect.
- Uses the refinement seed for repeatable finishing, so cached-latent comparisons do not receive random grain differences.
Preservation and fallback behavior
- The refinement prompt explicitly locks identity, face, expression, wardrobe, pose, hands, camera, crop, background, props, object placement, text, and composition.
- The same expanded prompt, active LoRAs, seed information, sampler, scheduler, and loaded model components carry into the second pass.
- Face Swap and Face Detailer run after refinement so those tools operate on the image that will be delivered.
- If the installed Diffusers version lacks Z-Image image-to-image support, conversion fails, or the refinement pass cannot complete, the program keeps the original generation and reports the reason.
- After every completed, failed, or cancelled refinement pass, the program releases refinement-only images, callback data, tensors, and unused memory allocations while keeping the loaded model, VAE, LoRAs, and shared refinement pipeline cached.
- Before refinement begins, the program detaches the completed base image; releases first-pass latents, callback arguments, result containers, and retry objects; synchronizes CUDA; clears unused CUDA cache; and then rechecks GPU VRAM, system RAM, and Windows commit-memory headroom.
- If 1.50× does not have safe GPU headroom, the program tries 1.25× automatically. If 1.25× or the system-memory checks remain unsafe, refinement is skipped and the original image is kept.
Image Post Processing
The former Image Color Processing section is now named Image Post Processing. Its grayscale and saturation controls are unchanged, and it includes Automatic Image Enhancement, optional film grain, a user-configurable model-based final-output upscaler, and an optional final border.
| Control | Purpose |
|---|---|
| Render final image in grayscale | Converts the completed image to neutral grayscale. |
| Adjust saturation | Uses the Percent value to reduce or increase color intensity. 100% leaves saturation unchanged. |
| Automatic Image Enhancement | Adaptively corrects tone, contrast, and brightness only when the completed image needs correction. It is disabled by default. |
| Enhancement Strength | Blends the adaptive correction with the untouched image from 1% to 100%. The default is 50%, and the box is available only when Automatic Image Enhancement is enabled. |
| Add Film Grain | Adds monochrome luminance grain to the final image. It is disabled by default. |
| Grain Strength | Sets grain intensity from 1% to 100%. The default is 12%, and the box is available only when Add Film Grain is enabled. |
| Upscaler Models Directory | Selects the folder containing compatible PyTorch upscaler models. Leave it blank to use the application’s root Upscalers folder. |
| Browse/Add Upscaler | Adds one or more .pth, .pt, .ckpt, or .safetensors models to Included Upscalers. |
| Included Upscalers | Shows each model’s status, filename, and requested Output Size. Double-click a model to activate it. Set Output Size to 1.0× (Restore Only) for compatible native 1× restoration models; the processed image keeps its original dimensions. Only one model can be active at a time. |
| Output Size | Double-click this cell and enter a value from 1.25× through 4.0×. The model performs super-resolution at its native scale first; the result is then fitted to the exact requested size when necessary. Therefore, 1.25× remains compatible with native 2× and 4× models, although processing time and peak VRAM use remain close to the model’s full native pass. |
| Preserve Original-Size Image | Enabled by default. When checked, Generation History and Auto-save retain both the normal-size processed image and the model-upscaled result. When unchecked, only the upscaled result is retained after successful upscaling. |
| Add border to final image | Enables the Final Image Border. It is disabled by default. The border expands the canvas outward and does not crop or cover the generated image. |
| Border Width | Sets the number of pixels added to every side of the completed image. Enter a whole number from 1 through 2048. |
| Border Color | Opens the standard color selector so an exact border color can be chosen. The selected hexadecimal color is displayed on the color swatch. |
| Random Color | Selects one new six-digit hexadecimal border color for each completed generation. The same random color is used for the upscaled result and any preserved original-size variant from that generation. The actual color is stored in image metadata. Uncheck this option to use the saved manual Border Color again. |
| Border Feathering | Sets the inward feather radius. The selected border color fades smoothly toward the untouched image over approximately twice the entered distance, without borrowing bright or strongly colored pixels from the original edge. Enter 0 for a hard edge or a pixel value up to the selected Border Width. |
- 1–35%: subtle correction.
- 36–65%: balanced general-purpose enhancement.
- 66–100%: stronger correction while retaining adaptive safeguards.
Film Grain strength
- 1–12%: subtle photographic texture.
- 13–25%: noticeable analog-film character.
- 26–50%: strong vintage or gritty treatment.
- Above 50%: intentionally heavy stylization.
.safetensors when available; PyTorch checkpoint formats can carry more loading risk.Install_Upscaler_Support.bat once after applying the 1.0.1 update. Fresh installations receive Spandrel automatically through requirements.txt.Face Swap, Random Faces & Face Detailer
Prompt Face Swap
Preserve Reference Face Details is an optional control in Prompt Face Swap. It starts off, with strength set to 50%. When a reference face is used, it aligns fine skin detail from that reference and blends it into the swapped face after Automatic Face Detailer. It transfers local brightness detail rather than source lighting or skin color, and excludes eyes and lips. Small faces, strong angles, and poor alignment are skipped. This experimental option may help retain freckles and subtle markings but cannot guarantee an exact copy. Start at 50%, lower the strength if texture looks too strong, and compare with the option off using the same seed. The controls are saved in application settings and Prompt Profiles. No additional model downloads are required.
Place source-face images in the configured Prompt face-ref folder and include <face_ref:IMAGE NAME> in the prompt. The program resolves the requested image, removes the control tag before generation, selects the largest detected face in the completed image, and applies the requested identity. The former manual Face Swap checkbox and individual source-image selector are hidden because prompt tags provide the same selection directly inside each prompt.
A lightweight second-stage harmonization pass then matches local color and illumination, feathers the outer face boundary, and restores restrained skin texture so the swapped face blends more naturally into the generated image.
- The selected source face is cached, reducing repeated source-analysis work.
- The harmonization pass reuses the existing target-face detection and does not run INSwapper or diffusion a second time.
- Identity-defining eye, nose, and mouth regions are protected from original-face texture transfer.
- If harmonization cannot complete, the successful first-pass face swap is retained automatically.
- A prompt
<face_ref:...>tag is the interface-accessible method for selecting and triggering Face Swap. - Use the exact filename or the filename without its extension.
- The program may use GPU-accelerated ONNX Runtime when a CUDA provider is available, with CPU fallback.
Random Faces
The Random Faces group appears directly below Automatic Face Detailer. Select a folder containing face images, then enable Use a random face image for Face Swap during generation. The option is disabled by default.
- Each generation selects a new source image at random, including each Auto-Generate cycle.
- The thumbnail on the right updates before generation to show the exact randomly selected source image that will be used for the face swap. The filename and dimensions are intentionally omitted from the preview.
- PNG, JPG, JPEG, WEBP, and BMP files in the selected folder and its subfolders are included.
- An explicit prompt
<face_ref:...>tag takes priority over Random Faces for that image. - If Random Faces cannot select or apply a usable source image, the completed base image is retained and the failure is recorded in the application log.
Automatic Face Detailer
GFPGAN restoration runs after generation and after face swap. The fidelity weight ranges from 0 to 1:
- Lower values: stronger restoration.
- Higher values: stronger preservation of the generated identity.
- Prompt face thumbnail: When the prompt contains a valid
<face_ref:...>tag, the compact viewer on the right side of this section displays the resolved reference image, filename, and dimensions. It refreshes as the prompt or Prompt face-ref folder changes and is also updated from the exact path accepted by generation and saved in Generation History metadata.
Automatic No-Swap Face Harmonization
Automatically enhance faces when no face swap is used is enabled by default. When a generation does not request Face Swap and the full Automatic Face Detailer is off, the program detects usable faces and applies a conservative GFPGAN cleanup with high identity fidelity, original skin-detail preservation, mild face-only sharpening, and a feathered 58% blend with the untouched generated face.
- It does not run when Face Swap or the full Automatic Face Detailer runs, preventing duplicate restoration.
- It is skipped when no usable face is detected.
- If the restoration model is unavailable or processing fails, the original generated image is retained.
- Automatic Image Enhancement can remain enabled because it runs afterward and does not perform facial reconstruction.
Cached Image Comparison
The separate Cached Image Comparison section appears at the end of Core Generation Settings, directly below Sampler / Scheduler. After generating a reference image, enable Reuse cached latent + last image state to test a different LoRA selection or strength against the same reference generation.
- Reuses the exact cached initial latent from the immediately preceding completed image.
- Reuses the previous expanded prompt, seed, model, VAE, dimensions, steps, sampler, scheduler, shift, and core processing settings.
- Uses the currently selected LoRAs and current strengths rather than restoring the reference image’s prior GUI LoRA stack.
- Does not reroll wildcards or inline prompt choices.
- The cached latent is kept only in memory during the current program session.
Main Viewer & Generation History
Main viewer
The completed image is scaled to fit the available viewer by default. Enable the actual-size/percentage option to inspect the image at a specified percentage and use scrollbars when needed. Double-clicking the viewer opens a separate frameless actual-size viewer in the center of the screen. Horizontal and vertical scrollbars remain hidden unless the full-resolution image exceeds the available viewer area on that axis. Hold the left mouse button on the image or custom status bar to move the viewer during the current viewing session, and use Close Viewer or Escape to close it.
Generation History
Generation History is stored in the program’s session_history folder. When closing, you can preserve it for the next launch or clear it.
Generated filenames include the Image Refinement profile and actual seed; Image Style Enhancer references are not included. A preserved base image uses the selected refinement profile plus Original. Images generated without a successfully applied refinement use No_Refinement.
| Button | Action |
|---|---|
| Clear History | Deletes all history items after confirmation and clears the viewer. |
| Clear Selected | Deletes only checked history items. |
| Save Selected | Saves all checked full-size history images to the selected Output Directory. If the Output Directory box is empty, the program uses the Output folder in the installed application root. Relative Output paths are also resolved from the application root, regardless of how the program was launched. Saved thumbnails display a green SAVED badge; the images remain in Generation History. |
| View Generation Prompt | Opens a larger copyable view of the final prompt recorded for the currently displayed completed image. |
| Expand Viewer | Allocates more horizontal space to the viewer. |
| Balanced Layout | Restores the standard workspace balance. |
Selected thumbnails keep a black background in the 65West Theme. A green SAVED badge identifies images that have already been saved to the Output Directory, including images saved automatically.
Live Generation Preview
While an image is being sampled, an optional temporary preview appears over the application. A cyan ✥ MOVE badge identifies the correct movable preview. Hold the left mouse button on the badge, preview header, or preview image and drag it anywhere across the full application window, including over the prompt, settings, history, or main-viewer areas. The preview remains inside the application bounds and remembers that location across generations and program launches until it is moved again.
- Enable Live Preview turns the feature on or off. When disabled, no preview decoding is performed and the speed selector is unavailable.
- Show prompt text in Live Preview hides or restores the prompt area without disabling the image preview. It is enabled by default and its setting is remembered.
- Current preview size: approximately 380 × 284 pixels.
- Slow updates about every 2 seconds.
- Normal updates about every 1 second.
- Fast updates about every 0.5 second.
- Real-Time attempts to update after every sampling step.
- The step count appears above the preview image.
- At completion, the preview displays the finished image at 100% progress and remains visible for about 2 seconds before the main viewer is updated.
- The overlay then disappears automatically; it also closes immediately when generation is stopped or fails.
Slideshow Viewer
The fullscreen slideshow can use either Generation History or the selected Output Directory.
- Set the number of seconds per image.
- Enable random order when desired.
- Pause, resume, randomize, and close from the fullscreen viewer controls.
- When using Generation History, the running slideshow refreshes in the background and detects newly generated images.
- Small images may be enlarged for display, with aspect ratio preserved and a moderate enlargement limit.
- The original image files are never modified by slideshow scaling.
Notes Box
The former Save As, Open Saved Image, and diagnostic-log button area has been replaced by a full-width multiline Notes box.
- Use it for prompt ideas, LoRA testing results, model observations, or general project notes.
- The notes remain available while the application is open.
- When the program closes, the notes are written to
settings.jsonand restored at the next launch.
Files & Folders
| Folder | Purpose |
|---|---|
Models | Both protected official model folders and optional external models. Standalone external Krea 2 models must be BF16 .safetensors files in version 1.0.1. Switching models does not remove either protected default. |
VAE | Managed Z-Image Turbo and Krea 2 VAEs, plus optional compatible custom VAEs. |
LoRAs | LoRA files used by the UI and prompt tags. |
Upscalers | Default library for compatible model-based super-resolution files. |
Face-Swap | Prompt-selectable source face images. |
session_history | Temporary Generation History images and metadata. Unsaved images can be moved to Output when the program closes; temporary copies of images already marked SAVED are removed without another prompt. |
logs | Diagnostic and generation logs. Model-worker activity is logged with the selected generation or load session. |
| Selected output folder | Auto-saved generated images. |
The program creates its optional content directories when needed.
Recommended Portrait Baseline
| Control | Starting value |
|---|---|
| Resolution | 864 × 1152 using Ideal Portrait (3:4) |
| Steps | 8 |
| Sampler | res-multistep - simple |
| Scheduler shift | 3.0 |
| Face Detailer | Off for the first comparison |
| Image Style Enhancer | Off unless a specific medium is requested |
| Image Refinement | Off for the first render; then test Balanced Detail & Lighting, Medium, 1.50× with Preserve Original enabled |
| Saturation | 100% |
| Seed | Random seed each generation |
Use this as a clean diagnostic baseline, then enable one optional feature at a time.
Troubleshooting
Auto-Generate keeps making the same image
The prompt asks for one person, but extra figures appear
one adult woman, solo portrait, no other people visible.The style profile is too weak
The face swap is slow or stutters
No face is detected
The live preview stays blank
Image Refinement could not complete or was skipped for memory safety
Image Refinement changes too much
Back-to-back Image Refinement generations slow down
When should I use Refresh AI Memory?
The model could not be loaded
.safetensors file; FP8, FP16, FP32, INT8, NVFP4, GGUF, and .ckpt Krea 2 files are not supported in version 1.0.1. Model loading runs inside a private worker, so a failed worker should leave the interface open. Review logs for Isolated model worker, Model load resources, and Model load failed. For a gated official Krea 2 model, run Setup_Krea2_Model_Access.bat after accepting the model terms.Generation remains busy after pressing Stop
The Included Upscaler does not run
Install_Upscaler_Support.bat once, restart the application, and confirm the selected model file still exists. Spandrel supports many common architectures but not every upscaler checkpoint. If the log reports an unsupported architecture, select another model. If it reports GPU memory exhaustion, choose a smaller source image or a lighter upscaler model.The slideshow image looks soft
The program says another copy is already running
Applying Updates
- Close the application.
- Extract the supplied update ZIP.
- Copy the included files into the installed program directory.
- Allow Windows to replace the older files.
- Launch the program and confirm that the updated behavior works. Maintenance updates can retain the same program version number.
Install_Upscaler_Support.bat once before launching the model-based upscaler. A fresh installation handles this automatically.