Upload folder using huggingface_hub

README.md

@@ -1,13 +1,27 @@
 ---
-title: Second Loop
-emoji: 📚
-colorFrom: purple
-colorTo: blue
+title: Second Loop · Project hub
+emoji: 🌀
+colorFrom: red
+colorTo: gray
 sdk: gradio
-sdk_version: 6.15.2
-python_version: '3.13'
+sdk_version: 4.44.0
 app_file: app.py
-pinned: false
+pinned: true
+license: mit
+short_description: Durable correction of memorized LLM errors — hub
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Second Loop — Project hub
+
+Landing page for the three demo Spaces of the Second Loop project. Each
+linked Space is fully static (no model loaded), all numbers are exact
+outputs of the live experimental runs.
+
+- **Part 1 — Scar-Survival** — durable correction of memorized errors
+  in a frozen LLM
+- **Part 2 — External Grounding** — defending the correction notebook
+  from polluted memory
+- **Part 3 — Thin Channel** — how rarely external truth can arrive
+  before calibration collapses
+
+GitHub repositories are linked on every card.

app.py

@@ -0,0 +1,272 @@
+"""Second Loop hub Space — landing page linking to the three Part-Spaces:
+  Part 1: Scar-Survival      (Laborator/scar-survival)
+  Part 2: External Grounding (Laborator/external-grounding)
+  Part 3: Thin Channel       (Laborator/thin-channel)
+
+No model, no data — just three cards in MicroLens style. Edit the
+PROJECTS list below to retarget the Space ids."""
+
+from __future__ import annotations
+
+import gradio as gr
+
+AUTHOR = "Serghei Brinza"
+HF_USER = "Laborator"
+
+PROJECTS = [
+    {
+        "part": "Part 1 of 3",
+        "title": "Scar-Survival",
+        "tagline": "Durable correction of memorized LLM errors",
+        "summary": (
+            "A frozen Qwen2.5-3B-Instruct, an external notebook of authoritative facts, "
+            "and CK-PLUG / DeCK-style contrastive decoding. Tested on 14 sticky-fact "
+            "traps, scored by an independent 7B judge across 10 full process reloads."
+        ),
+        "headline": "0/14 → 14/14 corrected · 100% survival across 10 reloads",
+        "icon": "🩹",
+        "color": "red",
+        "demo_url": f"https://huggingface.co/spaces/{HF_USER}/scar-survival",
+        "repo_url": "https://github.com/SergheiBrinza/scar-survival",
+    },
+    {
+        "part": "Part 2 of 3",
+        "title": "External Grounding",
+        "tagline": "Defending an LLM's correction notebook from polluted memory",
+        "summary": (
+            "Two guardians at the entrance to the notebook. Guardian 1.0 uses a "
+            "same-family clone as arbiter and caps at 64%. Guardian 2.x replaces "
+            "the arbiter with live Wikipedia retrieval plus three targeted fixes; "
+            "the arc reaches 100% on the same 14 traps."
+        ),
+        "headline": "50% → 64% → 71% → 86% → 100% across six guardian variants",
+        "icon": "🛡️",
+        "color": "orange",
+        "demo_url": f"https://huggingface.co/spaces/{HF_USER}/external-grounding",
+        "repo_url": "https://github.com/SergheiBrinza/external-grounding",
+    },
+    {
+        "part": "Part 3 of 3",
+        "title": "Thin Channel",
+        "tagline": "How rarely external truth can arrive before calibration collapses",
+        "summary": (
+            "Frozen Qwen2.5-3B-Instruct + per-topic Beta calibration over 1,646 "
+            "resolved ForecastBench questions, swept across 11 reveal schedules "
+            "from daily to never. Brier on hold-out is the metric."
+        ),
+        "headline": "Corridor 0.205–0.220 (any contact) · never collapses to 0.298",
+        "icon": "📡",
+        "color": "green",
+        "demo_url": f"https://huggingface.co/spaces/{HF_USER}/thin-channel",
+        "repo_url": "https://github.com/SergheiBrinza/thin-channel",
+    },
+]
+
+
+CSS = """
+@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@1,700&family=Inter:wght@400;500;700;800&family=JetBrains+Mono:wght@500;700&display=swap');
+
+:root {
+  --bg: #000000; --bg-card: #0A0A0A; --bg-elev: #141414;
+  --border: #1F1F1F; --border-strong: #2A2A2A;
+  --text: #FFFFFF; --text-mute: #A8A8A8; --text-dim: #6B6B6B;
+  --gold: #D4AF37; --gold-hi: #E8C84A;
+  --red: #FF2A2A; --green: #1FD160; --orange: #FF8C42;
+  --mono: 'JetBrains Mono', ui-monospace, monospace;
+  --serif: 'Playfair Display', serif;
+  --sans: 'Inter', system-ui, sans-serif;
+}
+
+.gradio-container, body {
+  background: var(--bg) !important; color: var(--text) !important;
+  font-family: var(--sans) !important;
+  max-width: 1180px !important; margin: 0 auto !important;
+  padding: 20px 24px 60px 24px !important;
+}
+footer, .built-with, .show-api { display: none !important; }
+
+/* HUB HEADER */
+.hub-head {
+  border: 1px solid var(--border-strong); border-radius: 14px;
+  padding: 36px 32px 30px 32px;
+  background: linear-gradient(180deg, #0A0A0A 0%, #050505 100%);
+  text-align: center;
+  margin-bottom: 22px;
+}
+.hub-eyebrow { font-family: var(--mono); font-size: 11px; letter-spacing: 0.28em;
+               color: var(--gold); text-transform: uppercase; margin-bottom: 10px; }
+.hub-title { font-family: var(--serif); font-style: italic; font-weight: 700;
+             font-size: 56px; color: var(--text); line-height: 1; margin: 0 0 14px 0; }
+.hub-sub { font-family: var(--mono); font-size: 13px; letter-spacing: 0.16em;
+           color: var(--text-mute); text-transform: uppercase; margin-bottom: 22px; }
+.hub-tagline { font-family: var(--sans); font-size: 16px; color: var(--text-mute);
+               line-height: 1.6; max-width: 720px; margin: 0 auto 22px auto; }
+
+.hub-meta { display: inline-flex; gap: 28px; padding: 14px 24px;
+            border: 1px solid var(--border); border-radius: 999px;
+            background: rgba(255,255,255,0.02); }
+.hub-meta .item { display: flex; flex-direction: column; align-items: center; gap: 4px; }
+.hub-meta .k { font-family: var(--mono); font-size: 9px; letter-spacing: 0.22em;
+               color: var(--text-dim); text-transform: uppercase; }
+.hub-meta .v { font-family: var(--sans); font-size: 14px; font-weight: 700; color: var(--text); }
+.hub-meta .v.italic { font-family: var(--serif); font-style: italic; }
+
+/* PROJECT CARDS */
+.project-grid {
+  display: grid; grid-template-columns: 1fr; gap: 18px;
+}
+@media (min-width: 1000px) {
+  .project-grid { grid-template-columns: 1fr 1fr 1fr; }
+}
+
+.project-card {
+  background: var(--bg-card);
+  border: 1px solid var(--border-strong);
+  border-radius: 16px;
+  padding: 28px 28px 24px 28px;
+  display: flex; flex-direction: column;
+  position: relative;
+  overflow: hidden;
+  transition: border-color 200ms ease, transform 200ms ease, box-shadow 200ms ease;
+}
+.project-card::before {
+  content: ""; position: absolute; top: 0; left: 0; right: 0; height: 3px;
+  background: linear-gradient(90deg, transparent 0%, var(--accent) 50%, transparent 100%);
+  opacity: 0.6;
+}
+.project-card:hover {
+  transform: translateY(-4px);
+  border-color: var(--accent);
+  box-shadow: 0 12px 40px rgba(0,0,0,0.6), 0 0 30px var(--accent-glow);
+}
+.proj-red    { --accent: var(--red);    --accent-glow: rgba(255,42,42,0.25); }
+.proj-orange { --accent: var(--orange); --accent-glow: rgba(255,140,66,0.25); }
+.proj-green  { --accent: var(--green);  --accent-glow: rgba(31,209,96,0.22); }
+
+.proj-icon {
+  width: 56px; height: 56px;
+  border: 1px solid var(--border-strong);
+  border-radius: 12px;
+  display: flex; align-items: center; justify-content: center;
+  font-size: 28px;
+  background: radial-gradient(60% 60% at 50% 40%, #1A1A1A 0%, #050505 100%);
+  margin-bottom: 16px;
+}
+.proj-part { font-family: var(--mono); font-size: 9.5px; letter-spacing: 0.22em;
+             color: var(--accent); text-transform: uppercase; margin-bottom: 6px; }
+.proj-title { font-family: var(--serif); font-style: italic; font-weight: 700;
+              font-size: 28px; color: var(--text); line-height: 1.05; margin-bottom: 8px; }
+.proj-tagline { font-family: var(--mono); font-size: 10.5px; letter-spacing: 0.12em;
+                color: var(--text-mute); text-transform: uppercase; line-height: 1.5; margin-bottom: 14px; }
+.proj-headline { font-family: var(--sans); font-size: 14px; color: var(--text);
+                 font-weight: 700; line-height: 1.45;
+                 padding: 10px 12px; margin-bottom: 14px;
+                 border-left: 2px solid var(--accent);
+                 background: rgba(255,255,255,0.025); }
+.proj-summary { font-family: var(--sans); font-size: 13.5px; color: var(--text-mute);
+                line-height: 1.55; margin-bottom: 20px; flex-grow: 1; }
+
+.proj-actions { display: flex; gap: 10px; flex-wrap: wrap; margin-top: auto; }
+.btn-primary, .btn-secondary {
+  flex: 1 1 auto;
+  display: inline-flex; align-items: center; justify-content: center; gap: 8px;
+  padding: 12px 16px; border-radius: 999px;
+  font-family: var(--mono); font-size: 10.5px; letter-spacing: 0.16em;
+  text-transform: uppercase; font-weight: 700; text-decoration: none;
+  transition: transform 120ms ease, box-shadow 120ms ease, background 120ms ease;
+  white-space: nowrap;
+}
+.btn-primary { background: var(--accent); color: #fff; border: 1px solid var(--accent); }
+.btn-primary:hover { transform: translateY(-1px); box-shadow: 0 0 24px var(--accent-glow); }
+.btn-secondary { background: transparent; color: var(--text-mute);
+                 border: 1px solid var(--border-strong); }
+.btn-secondary:hover { color: var(--text); border-color: var(--gold); }
+.btn-icon { font-size: 12px; }
+
+/* FOOTER */
+.foot { margin-top: 32px; padding: 22px 24px;
+        border: 1px solid var(--border); border-radius: 12px; background: var(--bg-card); }
+.foot .title { font-family: var(--mono); font-size: 10px; letter-spacing: 0.2em;
+               color: var(--text-dim); text-transform: uppercase; margin-bottom: 10px; }
+.foot .body { font-family: var(--sans); font-size: 13px; color: var(--text-mute); line-height: 1.6; }
+.foot a { color: var(--gold); text-decoration: none; border-bottom: 1px dotted var(--gold); }
+.foot a:hover { color: var(--gold-hi); }
+
+.gradio-container .block { background: transparent !important; border: none !important; padding: 0 !important; }
+.gradio-container .form { background: transparent !important; border: none !important; }
+"""
+
+
+def header_html() -> str:
+    return f"""
+<div class="hub-head">
+  <div class="hub-eyebrow">★ Project hub</div>
+  <h1 class="hub-title">Second Loop</h1>
+  <div class="hub-sub">Three experiments on durable correction of memorized LLM errors</div>
+  <div class="hub-tagline">
+    A frozen language model that has memorized an error keeps repeating it,
+    even when shown the truth. The Second Loop builds a correction mechanism
+    that survives full process reloads, defends it against polluted memory,
+    and measures how rarely external truth must arrive before the whole
+    self-calibrating system collapses.
+  </div>
+  <div class="hub-meta">
+    <div class="item"><span class="k">Submitted by</span><span class="v italic">{AUTHOR}</span></div>
+    <div class="item"><span class="k">Base model</span><span class="v">Qwen2.5-3B-Instruct</span></div>
+    <div class="item"><span class="k">License</span><span class="v">MIT</span></div>
+  </div>
+</div>
+"""
+
+
+def card_html(p: dict) -> str:
+    color_cls = f"proj-{p['color']}"
+    return f"""
+<div class="project-card {color_cls}">
+  <div class="proj-icon">{p['icon']}</div>
+  <div class="proj-part">{p['part']}</div>
+  <div class="proj-title">{p['title']}</div>
+  <div class="proj-tagline">{p['tagline']}</div>
+  <div class="proj-headline">{p['headline']}</div>
+  <div class="proj-summary">{p['summary']}</div>
+  <div class="proj-actions">
+    <a class="btn-primary" href="{p['demo_url']}" target="_blank" rel="noopener">
+      <span class="btn-icon">▶</span> Open demo
+    </a>
+    <a class="btn-secondary" href="{p['repo_url']}" target="_blank" rel="noopener">
+      <span class="btn-icon">⇲</span> GitHub
+    </a>
+  </div>
+</div>
+"""
+
+
+def grid_html() -> str:
+    return "<div class='project-grid'>" + "".join(card_html(p) for p in PROJECTS) + "</div>"
+
+
+def footer_html() -> str:
+    return """
+<div class="foot">
+  <div class="title">About this hub</div>
+  <div class="body">
+    Each of the three demo Spaces below is fully static — no model is loaded
+    inside any of them. All numbers and verdicts are exact outputs of the
+    live experimental runs, bundled into per-Space JSON files. Source code,
+    raw per-iteration results, and methodology documents live in the
+    GitHub repositories linked on every card.
+  </div>
+</div>
+"""
+
+
+with gr.Blocks(css=CSS, theme=gr.themes.Base(), title="Second Loop · Project hub") as demo:
+    gr.HTML(header_html())
+    gr.HTML(grid_html())
+    gr.HTML(footer_html())
+
+
+if __name__ == "__main__":
+    import os
+    port = int(os.environ.get("GRADIO_SERVER_PORT", 7860))
+    demo.launch(server_name="0.0.0.0", server_port=port)

requirements.txt

@@ -0,0 +1 @@
+gradio>=4.44.0,<5