# app.py # reCAPTCHA‑style 3×3 Demo (Streamlit) — Proof of Concept # -------------------------------------------------------- # - Build challenges from a TSV (columns: image [base64], answer) # - Same compact, natural‑size 3×3 layout for EVERY challenge # - Manual mode: clickable tiles with baked‑in border + ✓ (works inside iframe) # - Model modes: same layout (static), then run adapters from __future__ import annotations import io import re import base64 import random from dataclasses import dataclass from typing import List, Dict, Callable, Optional, Tuple, Union import streamlit as st from PIL import Image, ImageDraw import pandas as pd from io import BytesIO import base64 from config import * from utils import * from adapter import * # ----------------------------- # Constants & Utilities # ----------------------------- IM_HEIGHT,IM_WIDTH = 256,256 class ManualAdapter(BaseAdapter): name = "Manual" def __init__(self, manual_selection: List[int]): self.manual_selection = manual_selection def solve(self, images, category, prompt_type, available_categories): return InferenceResult(selected_ids=sorted(self.manual_selection), raw_outputs={}) class LLMadapter(BaseAdapter): def __init__(self, provider, model_name, system:Optional[str]=None ): assert provider in BaseAdapter.providers #model_list = BaseAdapter.list_models(provider) #assert model_name in model_list, f'{model_name} not found for provider: {provider}\nAvailable models:\n{model_list}' self.adapter = LLMadapter.get_provider_class(provider)(model_name) self.system = system def generate(self, prompt, image): out = self.adapter.generate(prompt=prompt, image=image, system=self.system) return out def get_provider_class(provider): p = provider.lower().strip() if p == BaseAdapter.OPENAI: return OpenaiAdapter if p == BaseAdapter.ANTHROPIC: return AnthropicAdapter if p == BaseAdapter.GEMINI: return GeminiAdapter if p == BaseAdapter.GROK: return GrokAdapter if p == BaseAdapter.MISTRAL: return MistralAdapter if p == BaseAdapter.COHERE: return CohereAdapter if p == BaseAdapter.TOGETHER: return TogetherAdapter raise BaseAdapterError(f"Unsupported provider: {p}") # ----------------------------- # Data loading & challenge sampling # ----------------------------- def make_challenge(df: pd.DataFrame, target: str | None, pos_fraction: float = 0.45): cats = sorted(df["answer_norm"].unique()) if not cats: raise ValueError("No categories found in TSV 'answer' column") if target is None or target == "__RANDOM__": target = random.choice(cats) pos = df[df["answer_norm"] == target] neg = df[df["answer_norm"] != target] if len(pos) == 0: sampled = df.sample(min(9, len(df))) else: n_pos = max(1, min(len(pos), int(round(9 * pos_fraction)))) n_neg = max(0, 9 - n_pos) pos_s = pos.sample(min(n_pos, len(pos))) neg_s = neg.sample(min(n_neg, len(neg))) if n_neg > 0 and len(neg) > 0 else df.iloc[0:0] sampled = pd.concat([pos_s, neg_s]).sample(frac=1.0) if len(sampled) < 9 and len(df) > len(sampled): extra = df.drop(sampled.index).sample(min(9 - len(sampled), len(df) - len(sampled))) sampled = pd.concat([sampled, extra]).sample(frac=1.0) sampled = sampled.head(9).copy() ids = sampled["index"].astype(str).tolist() answers = sampled["answer_norm"].tolist() images = [decode_base64_image(b) for b in sampled["image"].tolist()] return images, answers, target, ids # ----------------------------- # UI helpers — consistent 3×3 layout # ----------------------------- from PIL import ImageDraw def bake_selection(img, selected: bool, color=(37, 99, 235), thickness: int = 8): if not selected: return img im = img.copy() d = ImageDraw.Draw(im) w, h = im.size t = max(2, min(thickness, max(w, h)//32)) # adaptive thickness helps small tiles for k in range(t): d.rectangle([k, k, w-1-k, h-1-k], outline=color, width=1) # Optional: ✓ badge r = max(12, min(22, w//12)) x, y = w - r - 8, 8 d.ellipse([x, y, x+r, y+r], fill=color) d.line([x + r*0.25, y + r*0.55, x + r*0.45, y + r*0.75], fill=(255,255,255), width=max(2, r//6)) d.line([x + r*0.45, y + r*0.75, x + r*0.80, y + r*0.30], fill=(255,255,255), width=max(2, r//6)) return im def render_grid_clickable(images, selected_ids: set): from st_clickable_images import clickable_images data_uris = [] for i, im in enumerate(images, start=1): im = im.resize((IM_HEIGHT,IM_WIDTH)) vis = bake_selection(im, (i in selected_ids)) # <-- border baked here buf = io.BytesIO(); vis.save(buf, format="PNG") b64 = base64.b64encode(buf.getvalue()).decode() data_uris.append("data:image/png;base64," + b64) clicked = clickable_images( data_uris, titles=[str(i) for i in range(1, len(data_uris)+1)], div_style={ "display": "grid", "gridTemplateColumns": "repeat(3, max-content)", "gap": "6px", "justifyContent": "start", "width": "fit-content", }, img_style={ "width": "auto", "height": "auto", "maxWidth": "100%", "borderRadius": "8px", "boxSizing": "border-box", "cursor": "pointer", }, key=f"tile_clicks_{st.session_state.click_nonce}", # <-- important ) return clicked if isinstance(clicked, int) and clicked >= 0 else None def render_grid_static(images: List[Image.Image], selected_ids: set): # build rows, 3 tiles per row for row in chunk(list(enumerate(images, start=1)), 3): cols = st.columns(3, gap="small") # <-- move inside the loop for c, (idx, im) in enumerate(row): with cols[c]: vis = bake_selection(im, (idx in selected_ids)) # Option A: let Streamlit size it #st.image(vis, caption=str(idx)) # Option B (uniform tiles): uncomment to normalize size st.image(vis.resize((IM_WIDTH, IM_HEIGHT)), caption=str(idx)) def render_grid_static(images, selected_ids: set): thumbs = [] for i, im in enumerate(images, 1): im = im.resize((IM_WIDTH, IM_HEIGHT)) # (width, height) vis = bake_selection(im, i in selected_ids) buf = io.BytesIO(); vis.save(buf, format="PNG") b64 = base64.b64encode(buf.getvalue()).decode() thumbs.append(f'
{i}
') html = f"""
{''.join(thumbs)}
""" st.markdown(html, unsafe_allow_html=True) # ----------------------------- # Streamlit App # ----------------------------- st.set_page_config(page_title="reCAPTCHA‑style 3×3 — PoC", layout="wide") # Compact layout & natural-size images (Streamlit native widgets) st.markdown( """ """, unsafe_allow_html=True, ) st.title("reCAPTCHA‑style 3×3 Demo — Proof of Concept") st.caption("Generate a challenge from TSV, then solve manually or with a model adapter.") st.caption("Click run solver below to see the result for either choice 'Original' or 'Modified'.") st.caption("IT MAY TAKE ABOUT 10-20 SECONDS TO SOLVE THE CHALLENGE THROUGH API CALLS, VARIES BASED ON LLM CHOICE.") # Session state for key, default in { # existing keys... "dataset": None, "dataset_modified": None, # NEW "categories": [], "challenge_images_original": [], # NEW "challenge_images_modified": [], # NEW "challenge_answers": [], "challenge_target": None, "challenge_ids": [], # NEW "tile_selected": set(), "click_nonce": 0, "last_clicked_processed": -1, "auto_selected_ids": set(), "image_view": "Original", # current radio selection "last_image_view": "Original", # previous radio selection }.items(): if key not in st.session_state: st.session_state[key] = default # 2) Use a placeholder for the grid grid_ph = st.empty() # Sidebar # ---- sensible defaults in session ---- #if "provider" not in st.session_state: # st.session_state.provider = "Manual" # start in Manual mode #if "model" not in st.session_state: # st.session_state.model = None df_base = load_private_tsv("imageaction__recaptcha_dataset.tsv") df_mod = load_private_tsv("imageaction__captcha@SPEC-1de6b70ae2f0.tsv") st.session_state.dataset = df_base st.session_state.dataset_modified = df_mod st.session_state.categories = sorted(df_base["answer_norm"].unique()) # Session defaults if "provider" not in st.session_state: st.session_state.provider = BaseAdapter.OPENAI # default provider = OpenAI if "model" not in st.session_state: st.session_state.model = "gpt-5-2025-08-07" # default OpenAI model if "target_category" not in st.session_state: st.session_state.target_category = "bus" # Sidebar with st.sidebar: st.subheader("Challenge Settings") target_mode = st.selectbox("Target category mode", ["Pick specific", "Random each time"], index=0) if target_mode == "Pick specific": cats = st.session_state.categories if st.session_state.categories else ["(load TSV first)"] DEFAULT_CAT = "bus" # normalized label if cats and DEFAULT_CAT in cats: default_idx = cats.index(DEFAULT_CAT) else: default_idx = 0 # fallback target_category = st.selectbox( "Target category", cats, index=default_idx, ) chosen_target = target_category if st.session_state.categories else None else: chosen_target = "__RANDOM__" prompt_type_label = st.selectbox("Prompt type", list(PROMPT_TYPES.keys()), index=1) prompt_type = PROMPT_TYPES[prompt_type_label] st.markdown("---") st.subheader("Solver") # 1) Provider first (Manual + all providers) provider_options = ["Manual"] + list(MODEL_PROVIDERS.keys()) # ensure current provider is valid; otherwise default to OpenAI if st.session_state.provider not in provider_options: st.session_state.provider = BaseAdapter.OPENAI provider_idx = provider_options.index(st.session_state.provider) st.session_state.provider = st.selectbox( "Provider", provider_options, index=provider_idx, ) # 2) Model: only when provider != Manual if st.session_state.provider == "Manual": st.session_state.model = None st.selectbox("Model", ["(not required in Manual mode)"], index=0, disabled=True) st.caption("Manual mode: click tiles to select. No model needed.") else: models_for_provider = MODEL_PROVIDERS.get(st.session_state.provider, []) # if provider is OpenAI and our default gpt-5 is in the list, prefer that if st.session_state.provider == BaseAdapter.OPENAI and "gpt-5-2025-08-07" in models_for_provider: if st.session_state.model not in models_for_provider: st.session_state.model = "gpt-5-2025-08-07" else: # generic fallback for other providers if st.session_state.model not in models_for_provider and models_for_provider: st.session_state.model = models_for_provider[0] if not models_for_provider: st.session_state.model = None st.selectbox("Model", ["(no models for this provider)"], index=0, disabled=True) else: model_idx = models_for_provider.index(st.session_state.model) st.session_state.model = st.selectbox( "Model", models_for_provider, index=model_idx, ) # Generate new challenge colA, colB = st.columns([1,2]) with colA: gen = st.button("🎲 Generate new challenge", use_container_width=True, disabled=(st.session_state.dataset is None)) if gen: with st.spinner("Sampling images…"): images_orig, answers, tgt, ids = make_challenge(st.session_state.dataset, chosen_target) st.session_state.challenge_images_original = images_orig st.session_state.challenge_answers = answers st.session_state.challenge_target = tgt st.session_state.challenge_ids = ids st.session_state.tile_selected = set() st.session_state.last_clicked_processed = -1 st.session_state.click_nonce = 0 st.session_state.auto_selected_ids = set() # Build modified images in the SAME ORDER by id (if modified dataset present) st.session_state.challenge_images_modified = [] if st.session_state.dataset_modified is not None: mod_map = st.session_state.dataset_modified.set_index("index")["image"].to_dict() miss = [] for _id in ids: b64 = mod_map.get(str(_id)) if b64 is None: miss.append(_id) # fallback to original tile if missing st.session_state.challenge_images_modified.append( st.session_state.challenge_images_original[len(st.session_state.challenge_images_modified)] ) else: st.session_state.challenge_images_modified.append(decode_base64_image(b64)) if miss: st.warning(f"Modified TSV is missing {len(miss)} ids used in this challenge; those tiles fall back to original.") else: st.session_state.challenge_images_modified = [] # not available st.success("New challenge ready. Target: " + str(st.session_state.challenge_target)) # Main area if st.session_state.challenge_images_original: st.subheader("3×3 Grid — Target: **" + str(st.session_state.challenge_target) + "** (Indices 1..9)") # Toggle between Original and Modified options = ["Original"] if st.session_state.challenge_images_modified: options.append("Modified") st.session_state.image_view = st.radio( "Image set", options, horizontal=True, index=0 if st.session_state.image_view not in options else options.index(st.session_state.image_view) ) # If user switches Original ↔ Modified, treat as "new puzzle view" prev_view = st.session_state.get("last_image_view", "Original") if st.session_state.image_view != prev_view: st.session_state.last_image_view = st.session_state.image_view st.session_state.tile_selected = set() st.session_state.auto_selected_ids = set() st.session_state.click_nonce = 0 images_to_show = (st.session_state.challenge_images_modified if st.session_state.image_view == "Modified" and st.session_state.challenge_images_modified else st.session_state.challenge_images_original) if st.session_state.provider == "Manual": try: clicked = render_grid_clickable(images_to_show, st.session_state.tile_selected) if clicked is not None: tile_id = clicked + 1 if tile_id in st.session_state.tile_selected: st.session_state.tile_selected.remove(tile_id) else: st.session_state.tile_selected.add(tile_id) st.session_state.click_nonce += 1 st.rerun() except Exception: st.info("Install optional dependency: pip install st-clickable-images") render_grid_static(images_to_show, st.session_state.tile_selected) else: render_grid_static(images_to_show, st.session_state.auto_selected_ids) st.markdown("---") # Build adapter if st.session_state.provider == "Manual": adapter = ManualAdapter(manual_selection=sorted(st.session_state.tile_selected)) #ADAPTERS[model_choice](manual_selection=sorted(st.session_state.tile_selected)) else: #adapter = MODEL_ADAPTERS[st.session_state.provider](st.session_state.model) adapter = LLMadapter(st.session_state.provider, st.session_state.model) # Prompts Preview st.subheader("Prompts Preview") cats_for_prompt = st.session_state.categories if st.session_state.categories else [] if prompt_type == 1: st.code(build_prompt_1(st.session_state.challenge_target)) elif prompt_type == 2: st.code(build_prompt_2(cats_for_prompt)) else: raise Exception() if st.button("Run Solver", use_container_width=True): images_for_inference = (st.session_state.challenge_images_modified if st.session_state.image_view == "Modified" and st.session_state.challenge_images_modified else st.session_state.challenge_images_original) with st.spinner("Running solver…"): if prompt_type == 1: prompt = build_prompt_1(st.session_state.challenge_target) output_parse_fn = parse_prompt_1 elif prompt_type == 2: prompt = build_prompt_2(cats_for_prompt) output_parse_fn = parse_prompt_2 else: raise Exception() preds, raw_preds = [], [] if st.session_state.provider == 'Manual': selected_ids = [i for i in st.session_state.tile_selected] raw_preds = [ ans if (i+1) in selected_ids else 'Other' for i,ans in enumerate(st.session_state.challenge_answers) ] preds = [ st.session_state.challenge_target == pred for pred in raw_preds ] else: challenge_images_b64 = [encode_base64_image(img) for img in images_for_inference] for image_b64 in challenge_images_b64: result = adapter.generate(prompt=prompt, image=image_b64) outcome = output_parse_fn(result, st.session_state.challenge_target) raw_preds.append(result) preds.append(outcome) selected_ids = [i+1 for i, outcome in enumerate(preds) if outcome] st.session_state.auto_selected_ids = set(selected_ids) if st.session_state.provider != "Manual" else set() st.success("Done.") st.subheader("Selected IDs") st.write(selected_ids) if st.session_state.provider != "Manual": st.subheader("Prediction overlay") render_grid_static(images_for_inference, st.session_state.auto_selected_ids) # evaluation uses the *original ground truth labels* (ids don’t change) challenge_gt = [ans == st.session_state.challenge_target for ans in st.session_state.challenge_answers] challenge_pairs = list(zip(challenge_gt, preds)) tp = sum(pred == gt for gt, pred in challenge_pairs if gt) true_count = sum(gt for gt, _ in challenge_pairs) fn = sum(gt != pred for gt, pred in challenge_pairs if gt) fp = sum(pred != gt for gt, pred in challenge_pairs if not gt) tn = sum(pred == gt for gt, pred in challenge_pairs if not gt) st.subheader(f"Recall: {tp/(tp+fn) if (tp+fn) else 0.0} # Found {tp}/{true_count}") if raw_preds: st.subheader("Raw Model Outputs") for idx, (gt, pred) in enumerate(zip(st.session_state.challenge_answers, raw_preds)): st.markdown(f"**Category: {gt} — Expected: {gt == st.session_state.challenge_target}**") st.code(f"Prediction: {pred}", language="text") with st.expander("Debug: ground‑truth categories per tile", expanded=False): grid_truth = [str(i) + ": " + lbl for i, lbl in enumerate(st.session_state.challenge_answers, start=1)] st.write(", ".join(grid_truth)) else: st.info("Upload a TSV on the left and click 'Generate new challenge' to begin.")