Add app.py

app.py

@@ -0,0 +1,754 @@
+
+"""
+Submission Co-Pilot
+---------------------------------------------------------------
+Three-page Gradio app for hackathon judges.
+  Page 1 – Hero / hook
+  Page 2 – Problem framing
+  Page 3 – The actual analyser tool
+
+Drop app.py + requirements.txt into a Gradio HF Space. Done.
+---------------------------------------------------------------
+"""
+
+import os
+os.environ.setdefault("GRADIO_ANALYTICS_ENABLED", "False")
+
+import re
+import gradio as gr
+import pandas as pd
+from huggingface_hub import HfApi, hf_hub_download
+
+HF_TOKEN = os.environ.get("HF_TOKEN")
+api = HfApi(token=HF_TOKEN)
+
+
+# =============================================================================
+# Styling
+# =============================================================================
+CUSTOM_CSS = """
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');
+
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+body, .gradio-container {
+    background: #0d0d1a !important;
+    font-family: 'Inter', system-ui, sans-serif !important;
+    color: #e0e0f0 !important;
+    min-height: 100vh;
+}
+
+footer { display: none !important; }
+
+/* ─── hero ─────────────────────────────────────── */
+.hero-wrap {
+    min-height: 80vh;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    text-align: center;
+    padding: 60px 24px;
+}
+.hero-badge {
+    display: inline-block;
+    background: rgba(245,166,35,0.15);
+    color: #F5A623;
+    border: 1px solid rgba(245,166,35,0.3);
+    border-radius: 100px;
+    padding: 6px 18px;
+    font-size: .75rem;
+    font-weight: 600;
+    letter-spacing: .08em;
+    text-transform: uppercase;
+    margin-bottom: 28px;
+}
+.hero-title {
+    font-size: clamp(2.2rem, 6vw, 4rem);
+    font-weight: 700;
+    line-height: 1.1;
+    color: #ffffff;
+    max-width: 700px;
+    margin-bottom: 20px;
+}
+.hero-title span { color: #F5A623; }
+.hero-sub {
+    font-size: 1.05rem;
+    color: #8888a8;
+    max-width: 520px;
+    line-height: 1.7;
+    margin-bottom: 36px;
+}
+.bubble {
+    background: #1a1a30;
+    border: 1px solid #2e2e50;
+    border-radius: 16px 16px 16px 4px;
+    padding: 16px 22px;
+    font-size: .92rem;
+    color: #c0c0e0;
+    max-width: 420px;
+    margin: 0 auto 40px;
+    line-height: 1.6;
+}
+
+/* ─── problem page ─────────────────────────────── */
+.problem-wrap {
+    max-width: 860px;
+    margin: 0 auto;
+    padding: 60px 24px;
+    text-align: center;
+}
+.section-title {
+    font-size: clamp(1.6rem, 4vw, 2.6rem);
+    font-weight: 700;
+    color: #ffffff;
+    margin-bottom: 12px;
+}
+.section-sub {
+    font-size: .95rem;
+    color: #8888a8;
+    margin-bottom: 40px;
+    line-height: 1.6;
+}
+.problem-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+    gap: 16px;
+    margin-bottom: 40px;
+    text-align: left;
+}
+.p-card {
+    background: #12122a;
+    border: 1px solid #22224a;
+    border-radius: 12px;
+    padding: 20px;
+}
+.p-card .ico  { font-size: 1.5rem; margin-bottom: 10px; display: block; }
+.p-card h4    { font-size: .9rem; font-weight: 600; color: #e0e0f5; margin-bottom: 6px; }
+.p-card p     { font-size: .82rem; color: #7070a0; line-height: 1.55; }
+
+/* ─── tool page ─────────────────────────────────── */
+.tool-wrap {
+    max-width: 820px;
+    margin: 0 auto;
+    padding: 50px 24px 60px;
+}
+.tool-header { text-align: center; margin-bottom: 36px; }
+.tool-card {
+    background: #12122a;
+    border: 1px solid #22224a;
+    border-radius: 16px;
+    padding: 32px;
+    margin-bottom: 24px;
+}
+.tool-note {
+    font-size: .8rem;
+    color: #5a5a80;
+    text-align: center;
+    margin-top: 14px;
+    padding-top: 14px;
+    border-top: 1px solid #22224a;
+}
+
+/* ─── buttons ───────────────────────────────────── */
+.cta-btn {
+    background: #F5A623 !important;
+    color: #0d0d1a !important;
+    font-weight: 700 !important;
+    font-size: .95rem !important;
+    border: none !important;
+    border-radius: 100px !important;
+    padding: 12px 32px !important;
+    cursor: pointer !important;
+    transition: opacity .2s !important;
+}
+.cta-btn:hover { opacity: .85 !important; }
+
+.ghost-btn {
+    background: transparent !important;
+    color: #8888a8 !important;
+    font-weight: 500 !important;
+    font-size: .9rem !important;
+    border: 1px solid #2e2e50 !important;
+    border-radius: 100px !important;
+    padding: 10px 24px !important;
+    cursor: pointer !important;
+    transition: border-color .2s !important;
+}
+.ghost-btn:hover { border-color: #F5A623 !important; }
+
+.nav-row {
+    display: flex !important;
+    justify-content: center !important;
+    gap: 12px !important;
+    margin-top: 8px !important;
+    flex-wrap: wrap !important;
+}
+
+/* ─── footer ────────────────────────────────────── */
+.site-footer {
+    text-align: center;
+    padding: 28px 16px;
+    font-size: .78rem;
+    color: #44446a;
+    border-top: 1px solid #181830;
+    margin-top: 16px;
+}
+"""
+
+# =============================================================================
+# HTML page content
+# =============================================================================
+PAGE1_HTML = """
+<div class="hero-wrap">
+  <span class="hero-badge">🏆 Hackathon Judge's Co-Pilot</span>
+  <h1 class="hero-title">You're About To Judge<br><span>50+ Projects.</span></h1>
+  <p class="hero-sub">
+    The clock is running. The submissions keep coming.
+    Most tools leave you staring at raw READMEs.
+    This one does the reading for you.
+  </p>
+  <div class="bubble">
+    👋 Hey — we built this thinking about this exact moment.
+    Paste your links, set your criteria, and walk away with a
+    ranked briefing. No tab-switching required.
+  </div>
+</div>
+"""
+
+PAGE2_HTML = """
+<div class="problem-wrap">
+  <h2 class="section-title">Judging Is Harder Than It Looks</h2>
+  <p class="section-sub">
+    Every year, judges face the same four walls.
+    We built this tool by starting with those walls.
+  </p>
+  <div class="problem-grid">
+    <div class="p-card">
+      <span class="ico">🌊</span>
+      <h4>Submission Overload</h4>
+      <p>Dozens of projects, one afternoon, zero shortcut — until now.</p>
+    </div>
+    <div class="p-card">
+      <span class="ico">🎯</span>
+      <h4>Inconsistent Criteria</h4>
+      <p>Different judges score different things. Rubrics drift mid-process.</p>
+    </div>
+    <div class="p-card">
+      <span class="ico">⏱️</span>
+      <h4>Time Per Submission</h4>
+      <p>Reading every README, checking every file — it adds up fast.</p>
+    </div>
+    <div class="p-card">
+      <span class="ico">🤯</span>
+      <h4>Decision Fatigue</h4>
+      <p>By submission 20, even great projects start blurring together.</p>
+    </div>
+  </div>
+  <div class="bubble">
+    The next page solves all four. One tool, your criteria, instant ranked results.
+  </div>
+</div>
+"""
+
+PAGE3_HEADER_HTML = """
+<div class="tool-wrap">
+  <div class="tool-header">
+    <span class="hero-badge">✨ The Analyser</span>
+    <h2 class="section-title" style="margin-top:12px;margin-bottom:10px;">
+      Your Submission Briefing, Instant.
+    </h2>
+    <p class="section-sub">
+      Paste Space or model links, define what you are judging for,
+      and get a ranked leaderboard plus a written briefing in seconds.
+    </p>
+  </div>
+</div>
+"""
+
+FOOTER_HTML = """
+<div class="site-footer">
+  Built with care for the Gradio x Hugging Face Hackathon 2026
+  &nbsp;&middot;&nbsp;
+  Automated first pass only — the final call is always yours.
+</div>
+"""
+
+
+# =============================================================================
+# Scoring signal dictionaries
+# =============================================================================
+CRITERIA_SIGNALS = {
+    "innovation": {
+        "keywords": [
+            "novel", "new approach", "first", "unique", "creative", "original",
+            "invention", "breakthrough", "cutting-edge", "state-of-the-art",
+        ],
+        "checks": [],
+    },
+    "technical": {
+        "keywords": [
+            "architecture", "model", "training", "fine-tun", "dataset",
+            "benchmark", "parameter", "loss", "accuracy", "performance",
+            "evaluation", "metric",
+        ],
+        "checks": ["Has requirements.txt", "Has app entry point", "Uses Gradio"],
+    },
+    "usability": {
+        "keywords": [
+            "easy", "simple", "user", "interface", "demo", "interact",
+            "intuitive", "accessible", "tutorial", "guide", "how to",
+        ],
+        "checks": ["Has README", "Has app entry point"],
+    },
+    "design": {
+        "keywords": [
+            "design", "ui", "ux", "visual", "layout", "style", "theme",
+            "responsive", "mobile", "dark mode",
+        ],
+        "checks": ["Demo media"],
+    },
+    "impact": {
+        "keywords": [
+            "impact", "real-world", "problem", "solv", "benefit", "help",
+            "application", "use case", "deploy", "production", "society",
+        ],
+        "checks": [],
+    },
+    "presentation": {
+        "keywords": [
+            "demo", "video", "screenshot", "gif", "example", "showcase",
+            "show", "preview", "walkthrough",
+        ],
+        "checks": ["Demo media"],
+    },
+    "documentation": {
+        "keywords": [
+            "document", "readme", "explain", "describe", "usage", "install",
+            "setup", "guide", "instruction", "api",
+        ],
+        "checks": ["Has README", "Has LICENSE", "Has requirements.txt"],
+    },
+    "completeness": {
+        "keywords": [
+            "complete", "working", "functional", "deployed", "live",
+            "finish", "done", "ready",
+        ],
+        "checks": ["Has README", "Has requirements.txt", "Has app entry point", "Uses Gradio"],
+    },
+}
+
+CRITERIA_ALIASES = {
+    "innovation":           "innovation",
+    "innovative":           "innovation",
+    "originality":          "innovation",
+    "technical":            "technical",
+    "technical execution":  "technical",
+    "code quality":         "technical",
+    "engineering":          "technical",
+    "usability":            "usability",
+    "ux":                   "usability",
+    "user experience":      "usability",
+    "design":               "design",
+    "ui":                   "design",
+    "ui & design":          "design",
+    "usability & design":   "design",
+    "impact":               "impact",
+    "real-world impact":    "impact",
+    "presentation":         "presentation",
+    "demo":                 "presentation",
+    "documentation":        "documentation",
+    "docs":                 "documentation",
+    "completeness":         "completeness",
+    "overall quality":      "completeness",
+}
+
+
+# =============================================================================
+# Hub helpers
+# =============================================================================
+def parse_hf_url(text: str):
+    """Return (repo_type, 'owner/name') or (None, None)."""
+    text = text.strip().rstrip("/")
+
+    for pattern, rtype in [
+        (r"huggingface\.co/spaces/([\w.\-]+/[\w.\-]+)",   "space"),
+        (r"huggingface\.co/datasets/([\w.\-]+/[\w.\-]+)", "dataset"),
+        (r"huggingface\.co/([\w.\-]+/[\w.\-]+)",          "model"),
+    ]:
+        m = re.search(pattern, text)
+        if m:
+            return rtype, m.group(1)
+
+    # Bare owner/name with no slashes beyond the one separator
+    m = re.fullmatch(r"([\w.\-]+)/([\w.\-]+)", text)
+    if m:
+        return "model", text
+
+    return None, None
+
+
+def _get_repo_info(repo_type: str, repo_id: str):
+    """Use the type-specific HfApi methods (most stable API surface)."""
+    if repo_type == "space":
+        return api.space_info(repo_id)
+    if repo_type == "dataset":
+        return api.dataset_info(repo_id)
+    return api.model_info(repo_id)
+
+
+def fetch_repo_data(repo_type: str, repo_id: str) -> dict:
+    data = {"readme": "", "files": [], "likes": 0, "error": ""}
+
+    try:
+        info = _get_repo_info(repo_type, repo_id)
+        data["likes"] = getattr(info, "likes", 0) or 0
+        siblings = getattr(info, "siblings", None) or []
+        data["files"] = [
+            s.rfilename for s in siblings if hasattr(s, "rfilename")
+        ]
+    except Exception as exc:
+        data["error"] = (
+            f"Could not reach this {repo_type} on the Hub "
+            f"({type(exc).__name__})."
+        )
+        return data
+
+    try:
+        path = hf_hub_download(
+            repo_id=repo_id,
+            filename="README.md",
+            repo_type=repo_type,
+            token=HF_TOKEN,
+        )
+        with open(path, encoding="utf-8", errors="replace") as fh:
+            data["readme"] = fh.read()
+    except Exception:
+        data["readme"] = ""   # no README is fine; scoring will reflect it
+
+    return data
+
+
+def fetch_app_code(repo_type: str, repo_id: str, files: list) -> str:
+    """Download app.py / main.py for Spaces only."""
+    if repo_type != "space":
+        return ""
+    entry = next(
+        (f for f in files if f.lower() in ("app.py", "main.py")),
+        None,
+    )
+    if not entry:
+        return ""
+    try:
+        path = hf_hub_download(
+            repo_id=repo_id,
+            filename=entry,
+            repo_type="space",
+            token=HF_TOKEN,
+        )
+        with open(path, encoding="utf-8", errors="replace") as fh:
+            return fh.read()
+    except Exception:
+        return ""
+
+
+# =============================================================================
+# Scoring
+# =============================================================================
+def _best_signal(criterion_lower: str):
+    return CRITERIA_SIGNALS.get(CRITERIA_ALIASES.get(criterion_lower))
+
+
+def score_criterion(
+    criterion: str,
+    readme_lower: str,
+    checklist: dict,
+    repo_type: str,
+) -> float:
+    score = 5.0
+    crit_lower = criterion.lower().strip()
+    sig = _best_signal(crit_lower)
+
+    if sig:
+        kw_hits = sum(1 for kw in sig["keywords"] if kw in readme_lower)
+        score += min(kw_hits * 0.4, 3.0)
+        score += sum(0.7 for c in sig["checks"] if checklist.get(c))
+    else:
+        words = re.findall(r"[a-z]{4,}", crit_lower)
+        hits = sum(1 for w in words if w in readme_lower)
+        score += min(float(hits), 3.0)
+
+    if len(readme_lower) > 1200:
+        score += 0.5
+    elif len(readme_lower) < 120:
+        score -= 1.5
+
+    score += sum(0.2 for v in checklist.values() if v)
+
+    if repo_type == "space" and checklist.get("Uses Gradio"):
+        score += 0.3
+
+    return round(max(1.0, min(10.0, score)), 1)
+
+
+def analyze_submission(raw: str, criteria_list: list) -> dict:
+    repo_type, repo_id = parse_hf_url(raw)
+
+    if not repo_id:
+        return {
+            "input":    raw,
+            "title":    raw,
+            "url":      "",
+            "overall":  0,
+            "scores":   {c: 0 for c in criteria_list},
+            "checklist":{},
+            "summary":  "Could not parse as a Hugging Face link or 'owner/name'.",
+            "error":    True,
+            "likes":    0,
+        }
+
+    data   = fetch_repo_data(repo_type, repo_id)
+    prefix = {"space": "spaces/", "dataset": "datasets/", "model": ""}[repo_type]
+    url    = f"https://huggingface.co/{prefix}{repo_id}"
+
+    if data["error"]:
+        return {
+            "input":    raw,
+            "title":    repo_id,
+            "url":      url,
+            "overall":  0,
+            "scores":   {c: 0 for c in criteria_list},
+            "checklist":{},
+            "summary":  data["error"],
+            "error":    True,
+            "likes":    0,
+        }
+
+    readme = data["readme"]
+    files  = data["files"]
+    app_code = fetch_app_code(repo_type, repo_id, files)
+
+    # Strip YAML frontmatter (--- ... ---) from the top of the README
+    body = re.sub(r"^---.*?---", "", readme, count=1, flags=re.DOTALL).strip()
+
+    # Title: first H1 in the body (after frontmatter is removed)
+    title_match = re.search(r"^#\s+(.+)$", body, re.MULTILINE)
+    title = title_match.group(1).strip() if title_match else repo_id
+
+    # Summary: join non-header, non-badge lines
+    content_lines = []
+    for line in body.splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        if line.startswith("#"):
+            continue
+        if line.startswith("![") or line.startswith("[!["):
+            continue
+        content_lines.append(line)
+    summary_raw = " ".join(content_lines)
+    summary = re.sub(r"\s+", " ", summary_raw)[:280] if content_lines else "No description found."
+
+    readme_lower = readme.lower()
+
+    checklist = {
+        "Has README":           bool(readme.strip()),
+        "Has requirements.txt": any(f.lower() == "requirements.txt" for f in files),
+        "Has app entry point":  any(f.lower() in ("app.py", "main.py") for f in files),
+        "Has LICENSE":          any("license" in f.lower() for f in files),
+        "Uses Gradio":          any(
+                                    s in app_code
+                                    for s in ("import gradio", "gr.Blocks",
+                                              "gr.Interface", "gr.ChatInterface")
+                                ),
+        "Demo media":           (
+                                    bool(re.search(r"\.(gif|mp4|png|jpe?g|webm)", readme, re.I))
+                                    or "youtube" in readme_lower
+                                ),
+    }
+
+    scores = {
+        c.strip(): score_criterion(c.strip(), readme_lower, checklist, repo_type)
+        for c in criteria_list
+        if c.strip()
+    }
+    overall = round(sum(scores.values()) / len(scores), 1) if scores else 0
+
+    return {
+        "input":    raw,
+        "title":    title,
+        "url":      url,
+        "overall":  overall,
+        "scores":   scores,
+        "checklist":checklist,
+        "summary":  summary,
+        "error":    False,
+        "likes":    data["likes"],
+    }
+
+
+# =============================================================================
+# Entry point called by the Gradio button
+# =============================================================================
+def _run_analysis(urls_text: str, criteria_text: str):
+    if not urls_text or not urls_text.strip():
+        return (
+            "### 👀 Paste at least one submission link above to get started.",
+            pd.DataFrame(),
+        )
+
+    criteria_list = [
+        c.strip()
+        for c in re.split(r"[,\n]", criteria_text or "")
+        if c.strip()
+    ]
+    if not criteria_list:
+        criteria_list = ["Overall Quality"]
+
+    seen, targets = set(), []
+    for line in re.split(r"[\n,]", urls_text):
+        line = line.strip()
+        if line and line not in seen:
+            seen.add(line)
+            targets.append(line)
+
+    results = [analyze_submission(t, criteria_list) for t in targets]
+    results.sort(key=lambda r: r["overall"], reverse=True)
+
+    # ── Leaderboard DataFrame ────────────────────────────────────────────────
+    columns = ["Rank", "Submission", "Overall"] + criteria_list + ["Likes", "Notes"]
+    rows = []
+    for i, r in enumerate(results, start=1):
+        row = [i, r["title"], r["overall"]]
+        row += [r["scores"].get(c, "-") for c in criteria_list]
+        row.append(r["likes"])
+        if r["error"]:
+            row.append(r["summary"])
+        else:
+            present = [k for k, v in r["checklist"].items() if v]
+            row.append("Has: " + ", ".join(present) if present else "Missing key files")
+        rows.append(row)
+
+    df = pd.DataFrame(rows, columns=columns)
+
+    # ── Written briefing ─────────────────────────────────────────────────────
+    lines = [
+        "## 🏆 Judge's Briefing",
+        f"_Analysed {len(results)} submission(s)._\n",
+    ]
+
+    ok_results = [r for r in results if not r["error"]]
+    if ok_results:
+        top = ok_results[0]
+        lines.append(
+            f"**Top pick so far:** [{top['title']}]({top['url']})"
+            f" — **{top['overall']}/10**"
+        )
+        lines.append(f"> {top['summary']}\n")
+
+    lines.append("---")
+
+    for i, r in enumerate(results, start=1):
+        lines.append(f"### {i}. {r['title']}")
+        if r["url"]:
+            lines.append(f"🔗 {r['url']}")
+        if r["error"]:
+            lines.append(f"⚠️ {r['summary']}")
+        else:
+            lines.append(f"_{r['summary']}_")
+            score_bits = " · ".join(
+                f"{c}: **{s}/10**" for c, s in r["scores"].items()
+            )
+            lines.append(f"\n**Scores:** {score_bits}")
+            lines.append(f"**Overall: {r['overall']}/10** · ❤️ {r['likes']}")
+            present = [k for k, v in r["checklist"].items() if v]
+            missing = [k for k, v in r["checklist"].items() if not v]
+            if present:
+                lines.append(f"✅ {', '.join(present)}")
+            if missing:
+                lines.append(f"❌ Missing: {', '.join(missing)}")
+        lines.append("\n---")
+
+    return "\n\n".join(lines), df
+
+
+def run_analysis(urls_text: str, criteria_text: str):
+    """Outer wrapper — catches any unexpected exception gracefully."""
+    try:
+        return _run_analysis(urls_text, criteria_text)
+    except Exception as exc:
+        msg = (
+            f"### ⚠️ Something went wrong\n\n"
+            f"`{exc}`\n\n"
+            f"Double-check the links and try again."
+        )
+        return msg, pd.DataFrame()
+
+
+# =============================================================================
+# Gradio UI
+# =============================================================================
+with gr.Blocks(css=CUSTOM_CSS, title="Submission Co-Pilot") as demo:
+
+    # ── Page 1: Hero ─────────────────────────────────────────────────────────
+    with gr.Column(visible=True) as page1:
+        gr.HTML(PAGE1_HTML)
+        with gr.Row(elem_classes=["nav-row"]):
+            btn_to_p2 = gr.Button("Show Me ✨", elem_classes=["cta-btn"])
+
+    # ── Page 2: Problem ───────────────────────────────────────────────────────
+    with gr.Column(visible=False) as page2:
+        gr.HTML(PAGE2_HTML)
+        with gr.Row(elem_classes=["nav-row"]):
+            btn_p2_back = gr.Button("← Back",              elem_classes=["ghost-btn"])
+            btn_to_p3   = gr.Button("Show Me The Fix →",   elem_classes=["cta-btn"])
+
+    # ── Page 3: Analyser ─────────────────────────────────────────────────────
+    with gr.Column(visible=False) as page3:
+        gr.HTML(PAGE3_HEADER_HTML)
+        with gr.Column(elem_classes=["tool-card"]):
+            gr.Markdown("#### 🔗 Step 1 — Paste the submissions you are judging")
+            urls_box = gr.Textbox(
+                label="Hugging Face links — one per line",
+                placeholder="https://huggingface.co/spaces/username/project-name",
+                lines=5,
+            )
+            gr.Markdown("#### 🎯 Step 2 — Tell us what you are scoring for")
+            criteria_box = gr.Textbox(
+                label="Judging criteria (comma-separated)",
+                value="Innovation, Technical Execution, Usability & Design, Real-World Impact, Presentation",
+                lines=2,
+            )
+            analyze_btn = gr.Button("Analyze Submissions 🔍", elem_classes=["cta-btn"])
+            report_md   = gr.Markdown(value="")
+            leaderboard = gr.Dataframe(label="📊 Leaderboard")
+            gr.HTML("<p class='tool-note'>Automated first pass only — the final call is always yours.</p>")
+        with gr.Row(elem_classes=["nav-row"]):
+            btn_p3_back = gr.Button("← Back", elem_classes=["ghost-btn"])
+
+    gr.HTML(FOOTER_HTML)
+
+    # ── Navigation wiring ────────────────────────────────────────────────────
+    def show(n):
+        return (
+            gr.Column(visible=(n == 1)),
+            gr.Column(visible=(n == 2)),
+            gr.Column(visible=(n == 3)),
+        )
+
+    btn_to_p2.click(  fn=lambda: show(2), outputs=[page1, page2, page3])
+    btn_to_p3.click(  fn=lambda: show(3), outputs=[page1, page2, page3])
+    btn_p2_back.click(fn=lambda: show(1), outputs=[page1, page2, page3])
+    btn_p3_back.click(fn=lambda: show(2), outputs=[page1, page2, page3])
+
+    # ── Analyser wiring ──────────────────────────────────────────────────────
+    analyze_btn.click(
+        fn=run_analysis,
+        inputs=[urls_box, criteria_box],
+        outputs=[report_md, leaderboard],
+    )
+
+
+if __name__ == "__main__":
+    demo.launch()
+