M3st3rJ4k3l's picture
Update app.py
132d622 verified
Raw
History Blame Contribute Delete
41.9 kB
import os
import gc
import gradio as gr
import numpy as np
import spaces
import torch
import random
from PIL import Image
from typing import Iterable
import time
import threading
from logging_utils import log_inference
# ── requirements.txt should include: ─────────────────────────────────────────
# spandrel
# ─────────────────────────────────────────────────────────────────────────────
MODEL_VARIANT = os.environ.get("MODEL_VARIANT", "9B")
if MODEL_VARIANT == "9B-KV":
from diffusers import Flux2KleinKVPipeline as _PipeClass
_MODEL_REPO = "black-forest-labs/FLUX.2-klein-9b-kv"
else:
from diffusers import Flux2KleinPipeline as _PipeClass
_MODEL_REPO = "black-forest-labs/FLUX.2-klein-9B"
MODEL_VARIANT = "9B" # normalise any typos back to default
from huggingface_hub import hf_hub_download
device = torch.device("cuda" if torch.cuda.is_available() else "cpu")
from gradio.themes import Soft
from gradio.themes.utils import colors, fonts, sizes
colors.orange_red = colors.Color(
name="orange_red", c50="#FFF0E5", c100="#FFE0CC", c200="#FFC299", c300="#FFA366",
c400="#FF8533", c500="#FF4500", c600="#E63E00", c700="#CC3700", c800="#B33000",
c900="#992900", c950="#802200",
)
class OrangeRedTheme(Soft):
def __init__(
self, *, primary_hue: colors.Color | str = colors.gray,
secondary_hue: colors.Color | str = colors.orange_red,
neutral_hue: colors.Color | str = colors.slate, text_size: sizes.Size | str = sizes.text_lg,
font: fonts.Font | str | Iterable[fonts.Font | str] = (
fonts.GoogleFont("Outfit"), "Arial", "sans-serif",
),
font_mono: fonts.Font | str | Iterable[fonts.Font | str] = (
fonts.GoogleFont("IBM Plex Mono"), "ui-monospace", "monospace",
),
):
super().__init__(
primary_hue=primary_hue, secondary_hue=secondary_hue, neutral_hue=neutral_hue,
text_size=text_size, font=font, font_mono=font_mono,
)
super().set(
background_fill_primary="*primary_50",
background_fill_primary_dark="*primary_900",
body_background_fill="linear-gradient(135deg, *primary_200, *primary_100)",
body_background_fill_dark="linear-gradient(135deg, *primary_900, *primary_800)",
button_primary_text_color="white",
button_primary_text_color_hover="white",
button_primary_background_fill="linear-gradient(90deg, *secondary_500, *secondary_600)",
button_primary_background_fill_hover="linear-gradient(90deg, *secondary_600, *secondary_700)",
button_primary_background_fill_dark="linear-gradient(90deg, *secondary_600, *secondary_700)",
button_primary_background_fill_hover_dark="linear-gradient(90deg, *secondary_500, *secondary_600)",
slider_color="*secondary_500",
slider_color_dark="*secondary_600",
block_title_text_weight="600", block_border_width="3px",
block_shadow="*shadow_drop_lg", button_primary_shadow="*shadow_drop_lg",
button_large_padding="11px", color_accent_soft="*primary_100",
block_label_background_fill="*primary_200",
)
orange_red_theme = OrangeRedTheme()
MAX_SEED = np.iinfo(np.int32).max
# ── Upscaler model registry ───────────────────────────────────────────────────
# Add new entries here to extend the dropdown β€” spandrel handles any ESRGAN-
# family .pth file automatically. scale= is the integer output multiplier.
UPSCALE_MODELS = {
"None": {
"scale": None, "file": None, "url": None,
},
"2Γ— β€” RealESRGAN (balanced)": {
"scale": 2,
"file": "RealESRGAN_x2plus.pth",
"url": "https://github.com/xinntao/Real-ESRGAN/releases/download/v0.2.1/RealESRGAN_x2plus.pth",
},
"4Γ— β€” RealESRGAN (balanced)": {
"scale": 4,
"file": "RealESRGAN_x4plus.pth",
"url": "https://github.com/xinntao/Real-ESRGAN/releases/download/v0.1.0/RealESRGAN_x4plus.pth",
},
"4Γ— β€” UltraSharp (crisp)": {
"scale": 4,
"file": "4x-UltraSharpV2.pth",
"url": "https://huggingface.co/Kim2091/UltraSharpV2/resolve/main/4x-UltraSharpV2.pth",
},
"4Γ— β€” Remacri (natural)": {
"scale": 4,
"file": "4x_foolhardy_Remacri.pth",
"url": "https://huggingface.co/FacehugmanIII/4x_foolhardy_Remacri/resolve/main/4x_foolhardy_Remacri.pth",
},
"4Γ— β€” Nomos2 HQ DAT2 (Photography)": {
"scale": 4,
"file": "4xNomos2_hq_dat2.pth",
"url": "https://github.com/Phhofm/models/releases/download/4xNomos2_hq_dat2/4xNomos2_hq_dat2.pth",
},
}
# ─────────────────────────────────────────────────────────────────────────────
FACE_SWAP_PROMPT = """head_swap: start with Picture 1 as the base image, keeping its lighting, environment, and background. Remove the head from Picture 1 completely and replace it with the head from Picture 2.
FROM PICTURE 1 (strictly preserve):
- Scene: lighting conditions, shadows, highlights, color temperature, environment, background
- Head positioning: exact rotation angle, tilt, direction the head is facing
- Expression: facial expression, micro-expressions, eye gaze direction, mouth position, emotion
FROM PICTURE 2 (strictly preserve identity):
- Facial structure: face shape, bone structure, jawline, chin
- All facial features: eye color, eye shape, nose structure, lip shape and fullness, eyebrows
- Hair: color, style, texture, hairline
- Skin: texture, tone, complexion
The replaced head must seamlessly match Picture 1's lighting and expression while maintaining the complete identity from Picture 2. High quality, photorealistic, sharp details, 4k."""
# MAX number of simultaneous LoRA weight sliders to pre-render in the UI
MAX_LORA_SLOTS = 6
LORA_STYLES = [
{
"image": "https://huggingface.co/spaces/prithivMLmods/FLUX.2-Klein-LoRA-Studio/resolve/main/examples/image.webp",
"title": "None",
"adapter_name": None,
"repo": None,
"weights": None,
"default_prompt": None,
"default_weight": 1.0,
},
{
"title": "Klein-Delight-Style",
"adapter_name": "klein-delight",
"repo": "linoyts/Flux2-Klein-Delight-LoRA",
"weights": "pytorch_lora_weights.safetensors",
"default_prompt": "Relight the image to remove all existing lighting conditions and replace them with neutral, uniform illumination. Apply soft, evenly distributed lighting with no directional shadows, no harsh highlights, and no dramatic contrast. Maintain the original identity of all subjects exactlyβ€”preserve facial structure, skin tone, proportions, expressions, hair, clothing, and textures. Do not alter pose, camera angle, background geometry, or image composition. Lighting should appear balanced, and studio-neutral, similar to diffuse overcast or a soft lightbox setup. Ensure consistent exposure across the entire image with realistic depth and subtle shading only where necessary for form.",
"default_weight": 1.0,
},
{
"title": "Klein-Consistency",
"adapter_name": "klein-consistency",
"repo": "dx8152/Flux2-Klein-9B-Consistency",
"weights": "Klein-consistency.safetensors",
"default_prompt": None,
"default_weight": 1.0,
},
{
"title": "Best-Face-Swap",
"adapter_name": "face-swap",
"repo": "Alissonerdx/BFS-Best-Face-Swap",
"weights": "bfs_head_v1_flux-klein_9b_step3750_rank64.safetensors",
"default_prompt": FACE_SWAP_PROMPT,
"default_weight": 1.0,
},
{
"title": "NSFW v2",
"adapter_name": "nsfw-v2",
"repo": "diroverflo/FLux_Klein_9B_NSFW",
"weights": "Flux Klein - NSFW v2.safetensors",
"default_prompt": None,
"default_weight": 1.0,
},
{
"title": "Ultimate Upscaler Klein-9b",
"adapter_name": "Ultimate Upscaler",
"repo": "loras",
"weights": "Flux2-Klein-Image-RestoreV1.safetensors",
"default_prompt": "restore the image quality, remove any compression artefacts, remove any haze and soft edges, enrich the original with new intricate detail in all textures and surfaces creating a professional photorealistic photograph with natural lighting and skin texture.",
"default_weight": 1.0,
},
{
"title": "High Resolution",
"adapter_name": "High Resolution",
"repo": "loras",
"weights": "HighResolution9B.safetensors",
"default_prompt": "High Resolution",
"default_weight": 1.0,
},
{
"title": "Female Asshole",
"adapter_name": "Female Asshole",
"repo": "loras",
"weights": "femaleasshole-f2-klein-9b.safetensors",
"default_prompt": None,
"default_weight": 1.0,
},
{
"title": "Realistic Nudes",
"adapter_name": "Realistic Nudes",
"repo": "loras",
"weights": "realistic_nudes_klein_v3.safetensors",
"default_prompt": None,
"default_weight": 1.0,
},
{
"title": "Perky Pointy Puffy Breasts",
"adapter_name": "Perky Pointy Puffy Breasts",
"repo": "loras",
"weights": "PerkyPointyPuffy_v1.1_small_pointy_breasts_large_puffy_nipples.safetensors",
"default_prompt": "Small pointy breasts with large puffy nipples",
"default_weight": 1.0,
},
{
"title": "Flat Chested",
"adapter_name": "Flat Chested",
"repo": "loras",
"weights": "Flux2-Klein-9b-FlatChested-v1.safetensors",
"default_prompt": "flat chested",
"default_weight": 1.5,
},
{
"title": "Controllight",
"adapter_name": "Controllight",
"repo": "ControlLight/ControlLight",
"weights": "controllight.safetensors",
"default_prompt": None,
"default_weight": 1.0,
},
]
LOADED_ADAPTERS = set()
DYNAMIC_LORAS = {}
DYNAMIC_LORA_COUNTER = 0
def get_all_styles():
all_styles = list(LORA_STYLES)
for dynamic_lora in DYNAMIC_LORAS.values():
all_styles.append(dynamic_lora)
return all_styles
def get_selectable_styles():
"""Return all styles except 'None' for the checkbox selector."""
return [s for s in get_all_styles() if s["adapter_name"] is not None]
def get_style_by_title(title):
for style in get_all_styles():
if style["title"] == title:
return style
return None
def get_style_by_adapter_name(adapter_name):
for style in get_all_styles():
if style["adapter_name"] == adapter_name:
return style
return None
print(f"Loading FLUX.2 Klein {MODEL_VARIANT} from {_MODEL_REPO}...")
pipe = _PipeClass.from_pretrained(_MODEL_REPO, torch_dtype=torch.bfloat16).to(device)
print(f"Model loaded successfully: FLUX.2 Klein {MODEL_VARIANT}")
def compute_base_dimensions(image):
"""Scale image so longest side fits within 1024, aligned to 16px grid."""
if image is None:
return 1024, 1024
original_width, original_height = image.size
scale = min(1024 / original_width, 1024 / original_height)
new_width = (int(original_width * scale) // 16) * 16
new_height = (int(original_height * scale) // 16) * 16
return new_width, new_height
# Keep old name as alias so nothing inside infer breaks if called directly
update_dimensions_on_upload = compute_base_dimensions
def on_gallery_change(images):
"""Update image count info and size display when gallery changes."""
count_info = get_image_count_info(images)
if not images:
return count_info, "*No image uploaded yet*"
try:
first = images[0]
path = first[0] if isinstance(first, (tuple, list)) else first
img = Image.open(path if isinstance(path, str) else path.name)
orig_w, orig_h = img.size
base_w, base_h = compute_base_dimensions(img)
size_text = f"Input: **{orig_w} Γ— {orig_h}** px β†’ Output (pre-upscale): **{base_w} Γ— {base_h}** px"
return count_info, size_text
except Exception as e:
return count_info, f"*Could not read dimensions: {e}*"
def process_gallery_images(images):
if not images:
return []
pil_images = []
for item in images:
try:
path_or_img = item[0] if isinstance(item, (tuple, list)) else item
if isinstance(path_or_img, str):
pil_images.append(Image.open(path_or_img).convert("RGB"))
elif isinstance(path_or_img, Image.Image):
pil_images.append(path_or_img.convert("RGB"))
else:
pil_images.append(Image.open(path_or_img.name).convert("RGB"))
except Exception as e:
print(f"Skipping invalid image: {e}")
return pil_images
def get_image_count_info(images):
if not images:
return "πŸ“· No images uploaded"
count = len(images)
if count == 1:
return "πŸ“· 1 image uploaded (Picture 1 - Base)"
elif count == 2:
return "πŸ“· 2 images uploaded (Picture 1 - Base, Picture 2 - Face Source)"
return f"πŸ“· {count} images uploaded"
# ── LoRA selection β†’ update weight sliders + LoRA prompt display ──────────────
def update_weight_sliders(selected_titles):
"""
Given a list of selected LoRA titles, return updated visibility/label/value
for each of the MAX_LORA_SLOTS pre-rendered sliders, plus an update for the
LoRA prompt display box (visible when any selected LoRA has a default prompt).
The user's own prompt is never touched here β€” LoRA prompts are shown
separately and appended at inference time.
"""
selected_styles = [get_style_by_title(t) for t in (selected_titles or []) if get_style_by_title(t)]
slider_updates = []
for i in range(MAX_LORA_SLOTS):
if i < len(selected_styles):
style = selected_styles[i]
slider_updates.append(gr.update(
visible=True,
label=f"{style['title']} β€” weight",
value=style.get("default_weight", 1.0),
))
else:
slider_updates.append(gr.update(visible=False, value=1.0))
# Collect default prompts from ALL selected LoRAs (not just one)
lora_prompts = [s.get("default_prompt") for s in selected_styles if s.get("default_prompt")]
if lora_prompts:
combined = "\n\n".join(lora_prompts)
lora_prompt_update = gr.update(value=combined, visible=True)
else:
lora_prompt_update = gr.update(value="", visible=False)
return slider_updates + [lora_prompt_update]
# ── Inference ─────────────────────────────────────────────────────────────────
def _upscale_tiled(model_fn, img_t: torch.Tensor, tile: int = 512, overlap: int = 32) -> torch.Tensor:
"""
Run the upscaler model patch-by-patch to cap peak VRAM usage.
Overlapping tiles are averaged so there are no seam artifacts.
Output is assembled on CPU so only one tile lives on GPU at a time.
"""
_, c, h, w = img_t.shape
# Probe output scale with a tiny crop rather than hard-coding it
with torch.no_grad():
probe = model_fn(img_t[:, :, :min(4, h), :min(4, w)])
scale = probe.shape[-1] // min(4, w)
del probe
torch.cuda.empty_cache()
out_h, out_w = h * scale, w * scale
canvas = torch.zeros(1, c, out_h, out_w, dtype=torch.float32)
weights = torch.zeros(1, 1, out_h, out_w, dtype=torch.float32)
step = max(tile - overlap, 1)
# Ensure the last tile always reaches the edge
ys = list(range(0, max(h - tile, 0), step)) + [max(h - tile, 0)]
xs = list(range(0, max(w - tile, 0), step)) + [max(w - tile, 0)]
ys = sorted(set(ys))
xs = sorted(set(xs))
for y0 in ys:
for x0 in xs:
y1 = min(y0 + tile, h)
x1 = min(x0 + tile, w)
patch = img_t[:, :, y0:y1, x0:x1]
with torch.no_grad():
out = model_fn(patch).cpu().float()
oy0, ox0 = y0 * scale, x0 * scale
oy1, ox1 = y1 * scale, x1 * scale
canvas[:, :, oy0:oy1, ox0:ox1] += out
weights[:, :, oy0:oy1, ox0:ox1] += 1.0
return (canvas / weights.clamp(min=1)).clamp(0, 1)
def apply_realesrgan(image: Image.Image, model_key: str) -> Image.Image:
"""
Upscale a PIL image using the model selected in UPSCALE_MODELS.
Weights are downloaded once to /tmp/realesrgan_weights/ and reused.
"""
cfg = UPSCALE_MODELS[model_key]
try:
from spandrel import ImageModelDescriptor, ModelLoader
except ImportError:
raise gr.Error("spandrel is not installed. Add 'spandrel' to requirements.txt.")
import urllib.request
cache_dir = "/tmp/realesrgan_weights"
os.makedirs(cache_dir, exist_ok=True)
cache_path = os.path.join(cache_dir, cfg["file"])
if not os.path.exists(cache_path):
print(f"Downloading {cfg['file']}…")
urllib.request.urlretrieve(cfg["url"], cache_path)
model = ModelLoader().load_from_file(cache_path)
if not isinstance(model, ImageModelDescriptor):
raise gr.Error(f"Loaded model is not a single-image descriptor: {type(model)}")
sr_model = model.model.to(device).eval()
img_np = np.array(image).astype(np.float32) / 255.0
img_t = torch.from_numpy(img_np).permute(2, 0, 1).unsqueeze(0).to(device)
out_t = _upscale_tiled(sr_model, img_t, tile=512, overlap=32)
# Free upscaler weights immediately β€” FLUX pipeline stays resident
del sr_model, img_t
gc.collect()
torch.cuda.empty_cache()
out_np = out_t.squeeze(0).permute(1, 2, 0).numpy()
return Image.fromarray((out_np * 255).astype(np.uint8))
# ── Logging helper β€” fires a daemon thread so logging never blocks the user ──
def _spawn_log(pil_images, result_image, prompt, seed, steps, guidance_scale,
width, height, duration, success, error="",
lora_titles=None, lora_weights=None, upscale_factor="None",
lora_prompt_text=""):
if os.environ.get("ENABLE_LOGGING", "No").strip().lower() != "yes":
return
threading.Thread(
target=log_inference,
args=(pil_images, result_image, prompt, seed, steps, guidance_scale,
width, height, duration, success, error),
kwargs={"lora_titles": lora_titles, "lora_weights": lora_weights,
"upscale_factor": upscale_factor, "lora_prompt_text": lora_prompt_text},
daemon=True,
).start()
def infer(
input_images,
prompt,
lora_prompt_text,
custom_prompt_text,
selected_titles,
seed,
randomize_seed,
guidance_scale,
steps,
upscale_factor,
*slider_values,
progress=gr.Progress(track_tqdm=True)
):
"""CPU-side wrapper β€” handles pre/post processing and logging.
The actual GPU work is delegated to _infer_gpu so that the
_spawn_log daemon thread survives after the @spaces.GPU subprocess exits."""
gc.collect()
torch.cuda.empty_cache()
# Guard against stale MCP schema sending the old output_scale float value
if not isinstance(upscale_factor, str) or upscale_factor not in UPSCALE_MODELS:
upscale_factor = "None"
if not input_images:
raise gr.Error("Please upload at least one image.")
pil_images = process_gallery_images(input_images)
if not pil_images:
raise gr.Error("Could not process uploaded images.")
selected_titles = selected_titles or []
if randomize_seed:
seed = random.randint(0, MAX_SEED)
# Collect LoRA metadata for logging before entering GPU
active_styles = [get_style_by_title(t) for t in selected_titles
if get_style_by_title(t) and get_style_by_title(t)["adapter_name"] is not None]
log_lora_titles = [s["title"] for s in active_styles]
log_lora_weights = [float(w) for w in slider_values[:len(active_styles)]]
log_lora_prompt = (lora_prompt_text or "").strip()
t0 = time.perf_counter()
try:
image, seed, width, height = _infer_gpu(
pil_images, prompt, lora_prompt_text, custom_prompt_text, selected_titles,
seed, guidance_scale, steps, upscale_factor,
*slider_values, progress=progress
)
duration = time.perf_counter() - t0
# _spawn_log runs on CPU main process so the daemon thread survives
_spawn_log(pil_images, image, prompt, seed, steps, guidance_scale,
width, height, duration, True,
lora_titles=log_lora_titles, lora_weights=log_lora_weights,
upscale_factor=upscale_factor, lora_prompt_text=log_lora_prompt)
return image, str(seed)
except Exception as e:
duration = time.perf_counter() - t0
_spawn_log(pil_images, None, prompt, seed, steps, guidance_scale,
0, 0, duration, False, str(e),
lora_titles=log_lora_titles, lora_weights=log_lora_weights,
upscale_factor=upscale_factor, lora_prompt_text=log_lora_prompt)
raise
@spaces.GPU
def _infer_gpu(
pil_images,
prompt,
lora_prompt_text,
custom_prompt_text,
selected_titles,
seed,
guidance_scale,
steps,
upscale_factor,
*slider_values,
progress=gr.Progress(track_tqdm=True)
):
"""GPU-side inference β€” all LoRA loading, pipe() calls, and upscaling happen here."""
# Face-swap validation
if "Best-Face-Swap" in selected_titles:
if len(pil_images) < 2:
raise gr.Error("Face Swap requires 2 images: Picture 1 (base) and Picture 2 (face source).")
if len(pil_images) > 2:
gr.Warning("Face Swap uses only the first 2 images.")
pil_images = pil_images[:2]
# Build active adapter list (skip None)
active_styles = [get_style_by_title(t) for t in selected_titles if get_style_by_title(t) and get_style_by_title(t)["adapter_name"] is not None]
weights = list(slider_values[:len(active_styles)])
if not active_styles:
print("No LoRA selected β€” running base model.")
pipe.disable_lora()
else:
for i, style in enumerate(active_styles):
adapter_name = style["adapter_name"]
if adapter_name not in LOADED_ADAPTERS:
print(f"Loading adapter: {style['title']}")
try:
pipe.load_lora_weights(
style["repo"],
weight_name=style["weights"],
adapter_name=adapter_name,
)
LOADED_ADAPTERS.add(adapter_name)
except Exception as e:
raise gr.Error(f"Failed to load {style['title']}: {e}")
adapter_names = [s["adapter_name"] for s in active_styles]
adapter_weights = [float(w) for w in weights]
print(f"Activating adapters: {list(zip(adapter_names, adapter_weights))}")
pipe.set_adapters(adapter_names, adapter_weights=adapter_weights)
# Combine user prompt with LoRA default prompts and any selected custom prompts
user_prompt = (prompt or "").strip()
lora_extra = (lora_prompt_text or "").strip()
custom_extra = (custom_prompt_text or "").strip()
parts = [p for p in [user_prompt, lora_extra, custom_extra] if p]
full_prompt = "\n".join(parts)
# Always generate at base 1024-capped resolution
width, height = compute_base_dimensions(pil_images[0])
print(f"Generating at: {width} Γ— {height} px")
processed_images = [img.resize((width, height), Image.LANCZOS).convert("RGB") for img in pil_images]
image_input = processed_images if len(processed_images) > 1 else processed_images[0]
try:
# Flux2KleinKVPipeline is a distilled model and does not accept
# guidance_scale β€” only pass it for the non-KV 9B variant.
call_kwargs = dict(
image=image_input,
prompt=full_prompt,
width=width,
height=height,
num_inference_steps=steps,
generator=torch.Generator(device=device).manual_seed(seed),
)
if MODEL_VARIANT != "9B-KV":
call_kwargs["guidance_scale"] = guidance_scale
image = pipe(**call_kwargs).images[0]
except Exception as e:
raise gr.Error(f"Inference failed: {e}")
# ── Post-generation upscaling ─────────────────────────────────────────────
if upscale_factor and upscale_factor != "None":
scale_int = UPSCALE_MODELS[upscale_factor]["scale"]
print(f"Upscaling {scale_int}Γ— with {upscale_factor}…")
# Flush FLUX pipeline residuals before loading upscaler weights
gc.collect()
torch.cuda.synchronize()
torch.cuda.empty_cache()
try:
image = apply_realesrgan(image, upscale_factor)
print(f"Upscaled to: {image.width} Γ— {image.height} px")
except Exception as e:
gr.Warning(f"Upscaling failed, returning 1024px result: {e}")
# ─────────────────────────────────────────────────────────────────────────
gc.collect()
torch.cuda.empty_cache()
return image, seed, width, height
# ── Dynamic LoRA loader ───────────────────────────────────────────────────────
def add_custom_lora(repo_id, weight_name, adapter_name):
global DYNAMIC_LORA_COUNTER
if not repo_id or not repo_id.strip():
return "Please enter a valid HuggingFace repo ID.", gr.update(), gr.update()
repo_id = repo_id.strip()
adapter_name = adapter_name.strip() if adapter_name and adapter_name.strip() else None
try:
from huggingface_hub import model_info
info = model_info(repo_id)
actual_weight = weight_name.strip() if weight_name and weight_name.strip() else None
if not actual_weight:
for name in ["pytorch_lora_weights.safetensors", "lora.safetensors", "adapter_model.safetensors"]:
if any(f.filename == name for f in info.siblings):
actual_weight = name
break
if not actual_weight:
available = [f.filename for f in info.siblings if f.filename.endswith(('.safetensors', '.bin'))]
return f"No weight found. Available: {', '.join(available) or 'None'}", gr.update(), gr.update()
if not adapter_name:
DYNAMIC_LORA_COUNTER += 1
adapter_name = f"custom_{DYNAMIC_LORA_COUNTER}"
else:
adapter_name = "".join(c if c.isalnum() or c in "-_" else "_" for c in adapter_name)
custom_style = {
"image": "https://huggingface.co/spaces/prithivMLmods/FLUX.2-Klein-LoRA-Studio/resolve/main/examples/image.webp",
"title": f"Custom: {adapter_name}",
"adapter_name": adapter_name,
"repo": repo_id,
"weights": actual_weight,
"default_prompt": None,
"default_weight": 1.0,
}
DYNAMIC_LORAS[adapter_name] = custom_style
new_choices = [s["title"] for s in get_selectable_styles()]
return f"βœ… Added: {adapter_name} from {repo_id}", gr.update(choices=new_choices), gr.update(choices=new_choices)
except Exception as e:
return f"❌ Failed: {str(e)}", gr.update(), gr.update()
# ── Custom Prompt manager ─────────────────────────────────────────────────────
def add_custom_prompt(name, text, prompts_state, counter_state):
"""
All state is passed in and returned β€” never touches module-level globals.
Each user session gets its own isolated copy via gr.State.
"""
prompts = dict(prompts_state) # never mutate the state object directly
counter = int(counter_state)
text = text.strip() if text else ""
name = name.strip() if name else ""
if not text:
return "Please enter some prompt text.", prompts, counter, gr.update(), gr.update(), gr.update()
if not name:
counter += 1
name = f"Prompt {counter}"
if name in prompts:
return f"⚠️ '{name}' already exists β€” choose a different name.", prompts, counter, gr.update(), gr.update(), gr.update()
prompts[name] = text
choices = list(prompts.keys())
return (
f"βœ… Saved: '{name}'",
prompts, # updated prompts state
counter, # updated counter state
gr.update(choices=choices), # custom_prompt_selector
gr.update(choices=choices), # delete_prompt_name dropdown
gr.update(value="", interactive=True), # clear the name field
)
def delete_custom_prompt(name, currently_selected, prompts_state):
prompts = dict(prompts_state)
if name and name in prompts:
del prompts[name]
msg = f"πŸ—‘οΈ Deleted: '{name}'"
else:
msg = "Nothing to delete."
choices = list(prompts.keys())
# Drop deleted name from active selection if it was ticked
new_selection = [n for n in (currently_selected or []) if n in prompts]
return (
msg,
prompts, # updated prompts state
gr.update(choices=choices, value=new_selection), # custom_prompt_selector
gr.update(choices=choices, value=None), # delete_prompt_name
)
def update_custom_prompt_display(selected_names, prompts_state):
if not selected_names:
return gr.update(value="", visible=False)
texts = [prompts_state[n] for n in selected_names if n in prompts_state]
if texts:
return gr.update(value="\n\n".join(texts), visible=True)
return gr.update(value="", visible=False)
# ── UI ────────────────────────────────────────────────────────────────────────
css = """
#col-container { margin: 0 auto; max-width: 980px; }
#main-title h1 { font-size: 2.4em !important; }
#input_gallery .grid-wrap { min-height: 200px }
.lora-weight-row { background: var(--block-background-fill); border-radius: 8px; padding: 4px 12px; margin-bottom: 4px; }
"""
with gr.Blocks(css=css, theme=orange_red_theme) as demo:
# Per-session state β€” each user gets their own isolated copy, never shared across sessions
custom_prompts_state = gr.State({})
custom_prompt_counter_state = gr.State(0)
with gr.Column(elem_id="col-container"):
_logging_on = os.environ.get("ENABLE_LOGGING", "No").strip().lower() == "yes"
_logging_badge = "🟒 On" if _logging_on else "πŸ”΄ Off"
gr.Markdown("# **FLUX.2-Klein-LoRA-Studio**", elem_id="main-title")
gr.Markdown(
f"Apply one or more [LoRA](https://huggingface.co/models?other=base_model:adapter:black-forest-labs/FLUX.2-klein-9B) "
f"adapters to your images using "
f"[FLUX.2-Klein-{MODEL_VARIANT}]({_MODEL_REPO}).\n\n"
f"**Model:** `{MODEL_VARIANT}` Β· **Logging:** {_logging_badge}"
)
gr.Markdown(
"*Results may vary when combining multiple LoRAs. "
"Uploaded images and metadata may be temporarily stored to help optimise the space β€” "
"stored data is automatically deleted. "
"Always comply with HF and model Terms of Service.*"
)
with gr.Row(equal_height=False):
# ── Left column ──────────────────────────────────────────────────
with gr.Column(scale=1):
input_images = gr.Gallery(
label="Upload Image(s)",
type="filepath",
columns=2, rows=1, height=260,
allow_preview=True,
elem_id="input_gallery",
)
image_info = gr.Markdown("πŸ“· No images uploaded")
size_info = gr.Markdown("*No image uploaded yet*")
prompt = gr.Text(
label="Prompt",
max_lines=3,
placeholder="Describe the edit, or leave blank for style-only LoRAs",
)
# Read-only display for LoRA default prompts β€” shown when any
# selected LoRA has a default prompt. Combined with user prompt
# at inference time; never overwrites what the user typed.
lora_prompt_display = gr.Textbox(
label="LoRA Default Prompts (auto-appended)",
info="These prompts come from your selected LoRAs and are appended to your prompt above during generation.",
interactive=False,
visible=False,
lines=3,
)
# Read-only display for active custom prompts β€” shown when any
# saved custom prompt is ticked in the Custom Prompts accordion.
custom_prompt_display = gr.Textbox(
label="Custom Prompts (auto-appended)",
info="These are your selected saved prompts, appended alongside LoRA prompts during generation.",
interactive=False,
visible=False,
lines=3,
)
run_button = gr.Button("β–Ά Generate", variant="primary", size="lg")
with gr.Accordion("βš™οΈ Advanced Settings", open=False):
seed = gr.Slider(label="Seed", minimum=0, maximum=MAX_SEED, step=1, value=0)
randomize_seed = gr.Checkbox(label="Randomize seed", value=True)
guidance_scale = gr.Slider(label="Guidance Scale", minimum=0.0, maximum=10.0, step=0.1, value=1.0, visible=MODEL_VARIANT != "9B-KV")
steps = gr.Slider(label="Steps", minimum=1, maximum=50, value=4, step=1)
upscale_factor = gr.Dropdown(
label="Upscale model",
info="Applied after generation. UltraSharp / Remacri are sharper than RealESRGAN for clean photo inputs.",
choices=list(UPSCALE_MODELS.keys()),
value="None",
)
# ── Right column ─────────────────────────────────────────────────
with gr.Column(scale=1):
output_image = gr.Image(label="Output", interactive=False, format="png", height=320)
used_seed = gr.Textbox(
label="🌱 Seed used",
info="Re-enter this seed in Advanced Settings to reproduce the result exactly.",
interactive=False,
visible=True,
max_lines=1,
)
# ── LoRA selector ─────────────────────────────────────────────────────
gr.Markdown("### 🎨 Select LoRA(s)")
lora_selector = gr.CheckboxGroup(
choices=[s["title"] for s in get_selectable_styles()],
value=[],
label="Active LoRAs β€” tick one or more",
)
# ── Weight sliders (pre-rendered, shown/hidden dynamically) ───────────
gr.Markdown("#### Weights for selected LoRAs")
weight_sliders = []
with gr.Group():
for i in range(MAX_LORA_SLOTS):
with gr.Row(elem_classes="lora-weight-row"):
s = gr.Slider(
minimum=0.0, maximum=2.0, step=0.05, value=1.0,
label=f"LoRA slot {i+1}",
visible=False,
interactive=True,
)
weight_sliders.append(s)
# ── Dynamic HuggingFace loader ────────────────────────────────────────
with gr.Accordion("βž• Load Custom LoRA from HuggingFace", open=False):
gr.Markdown("Add any FLUX.2-Klein-compatible LoRA from [HuggingFace Hub](https://huggingface.co/models?other=base_model:adapter:black-forest-labs/FLUX.2-klein-9B)")
with gr.Row():
lora_repo_id = gr.Textbox(label="Repo ID", placeholder="username/repo-name")
with gr.Row():
lora_weight_name = gr.Textbox(label="Weight filename (optional)", placeholder="pytorch_lora_weights.safetensors")
lora_adapter_name = gr.Textbox(label="Adapter name (optional)", placeholder="my-lora")
with gr.Row():
add_lora_btn = gr.Button("Add LoRA", variant="primary")
lora_status = gr.Textbox(label="Status", interactive=False)
# ── Custom Prompt library ─────────────────────────────────────────────
with gr.Accordion("πŸ“ Custom Prompts", open=False):
gr.Markdown(
"Save reusable prompt snippets for this session. "
"Tick any saved prompt below and it will be appended to your generation alongside any LoRA prompts. "
"*Prompts are stored in memory β€” they reset when the Space restarts or the worker recycles.*"
)
custom_prompt_selector = gr.CheckboxGroup(
choices=[],
value=[],
label="Saved prompts β€” tick to append to generation",
)
with gr.Row():
prompt_name_input = gr.Textbox(
label="Name",
placeholder="e.g. Skin detail enhancer",
scale=1,
)
with gr.Row():
prompt_text_input = gr.Textbox(
label="Prompt text",
placeholder="Enter the prompt snippet you want to save and reuse…",
lines=4,
)
with gr.Row():
add_prompt_btn = gr.Button("πŸ’Ύ Save Prompt", variant="primary")
prompt_status = gr.Textbox(label="Status", interactive=False, scale=2)
with gr.Row():
delete_prompt_name = gr.Dropdown(
label="Delete a saved prompt",
choices=[],
value=None,
interactive=True,
scale=2,
)
delete_prompt_btn = gr.Button("πŸ—‘οΈ Delete", variant="secondary", scale=1)
gr.Markdown("*Experimental space β€” results may vary when combining multiple LoRAs.*")
# ── Event wiring ──────────────────────────────────────────────────────────
input_images.change(
fn=on_gallery_change,
inputs=[input_images],
outputs=[image_info, size_info],
)
lora_selector.change(
fn=update_weight_sliders,
inputs=[lora_selector],
outputs=weight_sliders + [lora_prompt_display],
)
add_lora_btn.click(
fn=add_custom_lora,
inputs=[lora_repo_id, lora_weight_name, lora_adapter_name],
outputs=[lora_status, lora_selector, lora_selector],
)
add_prompt_btn.click(
fn=add_custom_prompt,
inputs=[prompt_name_input, prompt_text_input, custom_prompts_state, custom_prompt_counter_state],
outputs=[prompt_status, custom_prompts_state, custom_prompt_counter_state, custom_prompt_selector, delete_prompt_name, prompt_name_input],
)
delete_prompt_btn.click(
fn=delete_custom_prompt,
inputs=[delete_prompt_name, custom_prompt_selector, custom_prompts_state],
outputs=[prompt_status, custom_prompts_state, custom_prompt_selector, delete_prompt_name],
)
custom_prompt_selector.change(
fn=update_custom_prompt_display,
inputs=[custom_prompt_selector, custom_prompts_state],
outputs=[custom_prompt_display],
)
run_button.click(
fn=infer,
inputs=[input_images, prompt, lora_prompt_display, custom_prompt_display, lora_selector, seed, randomize_seed, guidance_scale, steps, upscale_factor] + weight_sliders,
outputs=[output_image, used_seed],
)
if __name__ == "__main__":
demo.queue().launch(css=css, theme=orange_red_theme, mcp_server=True, ssr_mode=False, show_error=True)