Deploy provenance-first OpenComic-Continue research UI

README.md

@@ -1,13 +1,17 @@
 ---
-title: Codex Opencomic Dev
-emoji: 👁
+title: OpenComic Continue
+emoji: 📚
 colorFrom: indigo
-colorTo: red
+colorTo: purple
 sdk: gradio
-sdk_version: 6.25.0
-python_version: '3.12'
+sdk_version: 6.1.0
 app_file: app.py
 pinned: false
+license: apache-2.0
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# OpenComic-Continue
+
+Public research interface for the copyright-aware OpenComic-Continue pipeline. The Space calls an authenticated Modal API; credentials are configured only as Space secrets.
+
+Only upload content you own or are permitted to transform. Placeholder panels are explicitly labelled when the image GPU renderer is unavailable.

app.py

@@ -0,0 +1,184 @@
+from __future__ import annotations
+
+import base64
+import io
+import json
+import os
+import tempfile
+import zipfile
+from pathlib import Path
+
+import gradio as gr
+import httpx
+from PIL import Image
+
+API_URL = os.getenv("MODAL_API_URL", "http://127.0.0.1:8000").rstrip("/")
+API_TOKEN = os.getenv("OPENCOMIC_API_TOKEN", "")
+
+
+def _headers() -> dict[str, str]:
+    return {"Authorization": f"Bearer {API_TOKEN}"} if API_TOKEN else {}
+
+
+def _upload_payload(files: list[str] | None) -> tuple[bytes, str, str]:
+    paths = [Path(item) for item in files or []]
+    if not paths:
+        raise gr.Error("Upload at least one image, PDF, CBZ, or ZIP file.")
+    if len(paths) == 1:
+        return paths[0].read_bytes(), paths[0].name, "application/octet-stream"
+    stream = io.BytesIO()
+    with zipfile.ZipFile(stream, "w", zipfile.ZIP_DEFLATED) as archive:
+        for index, path in enumerate(paths):
+            archive.writestr(f"{index:04d}{path.suffix.lower()}", path.read_bytes())
+    return stream.getvalue(), "uploaded-pages.cbz", "application/vnd.comicbook+zip"
+
+
+def analyze(files: list[str] | None, reading_direction: str):
+    payload, name, mime = _upload_payload(files)
+    with httpx.Client(timeout=900) as client:
+        response = client.post(
+            f"{API_URL}/analyze-comic",
+            params={"reading_direction": reading_direction},
+            headers=_headers(),
+            files={"file": (name, payload, mime)},
+        )
+    if response.is_error:
+        raise gr.Error(f"Analysis failed ({response.status_code}): {response.text[:500]}")
+    result = response.json()
+    summary = (
+        f"Analyzed {result['pages']} pages and {result['panels']} panels. "
+        "The current public deployment uses deterministic perception and planning baselines."
+    )
+    return result["memory"], result["memory"], summary
+
+
+def _data_url_to_image(value: str) -> Image.Image:
+    payload = base64.b64decode(value.split(",", 1)[1])
+    return Image.open(io.BytesIO(payload)).convert("RGB")
+
+
+def generate(
+    memory: dict | None,
+    pages: int,
+    creativity: float,
+    dialogue_density: float,
+    style_fidelity: float,
+    character_fidelity: float,
+    reading_direction: str,
+    research_mode: bool,
+):
+    if not memory:
+        raise gr.Error("Analyze a comic before requesting a continuation.")
+    request = {
+        "memory": memory,
+        "settings": {
+            "pages": int(pages),
+            "creativity": creativity,
+            "dialogue_density": dialogue_density,
+            "style_fidelity": style_fidelity,
+            "character_fidelity": character_fidelity,
+            "reading_direction": reading_direction,
+            "research_mode": research_mode,
+            "seed": 20260823,
+        },
+    }
+    with httpx.Client(timeout=900) as client:
+        response = client.post(
+            f"{API_URL}/continue-comic", headers=_headers(), json=request
+        )
+    if response.is_error:
+        raise gr.Error(f"Generation failed ({response.status_code}): {response.text[:500]}")
+    result = response.json()
+    images = [_data_url_to_image(item) for item in result.get("page_data_urls", [])]
+    research = {
+        "model_variant": [item.get("model_variant") for item in result.get("scripts", [])],
+        "routing": result.get("routing", []),
+        "job_id": result.get("job_id"),
+        "renderer_status": "RENDERER NOT RUN (visible placeholder panels)",
+    }
+    return images, result.get("scripts", []), result.get("memory"), research
+
+
+def record_preference(choice: str, notes: str) -> str:
+    if not choice:
+        return "Choose a preference before submitting."
+    row = {"preference": choice, "notes": notes[:1000]}
+    destination = Path(tempfile.gettempdir()) / "opencomic_pairwise.jsonl"
+    with destination.open("a", encoding="utf-8") as handle:
+        handle.write(json.dumps(row, ensure_ascii=False) + "\n")
+    return "Anonymous preference recorded for this research session."
+
+
+with gr.Blocks(title="OpenComic-Continue") as demo:
+    gr.Markdown(
+        "# OpenComic-Continue\n"
+        "A provenance-first research prototype for structured comic continuation. "
+        "Only upload material you own or have permission to transform."
+    )
+    memory_state = gr.State()
+    with gr.Tab("Analyze"):
+        uploads = gr.File(
+            label="Comic pages, PDF, CBZ, or ZIP",
+            file_count="multiple",
+            type="filepath",
+        )
+        direction = gr.Radio(["ltr", "rtl"], value="ltr", label="Reading direction")
+        analyze_button = gr.Button("Analyze comic", variant="primary")
+        analysis_summary = gr.Markdown()
+        memory_json = gr.JSON(label="StoryMemory")
+        analyze_button.click(
+            analyze,
+            [uploads, direction],
+            [memory_state, memory_json, analysis_summary],
+        )
+    with gr.Tab("Continue"):
+        with gr.Row():
+            page_count = gr.Slider(1, 10, value=1, step=1, label="Pages")
+            creativity = gr.Slider(0, 1, value=0.5, label="Creativity")
+            dialogue = gr.Slider(0, 1, value=0.5, label="Dialogue density")
+        with gr.Row():
+            style = gr.Slider(0, 1, value=0.8, label="Style fidelity")
+            character = gr.Slider(0, 1, value=0.9, label="Character fidelity")
+            generation_direction = gr.Dropdown(
+                ["auto", "ltr", "rtl"], value="auto", label="Reading direction"
+            )
+        research_mode = gr.Checkbox(label="Research mode (show routing and model metadata)")
+        generate_button = gr.Button("Generate continuation", variant="primary")
+        gallery = gr.Gallery(label="Continuation pages", columns=2, object_fit="contain")
+        scripts = gr.JSON(label="Structured scripts")
+        updated_memory = gr.JSON(label="Updated StoryMemory")
+        research_json = gr.JSON(label="Research metadata")
+        generate_button.click(
+            generate,
+            [
+                memory_state,
+                page_count,
+                creativity,
+                dialogue,
+                style,
+                character,
+                generation_direction,
+                research_mode,
+            ],
+            [gallery, scripts, updated_memory, research_json],
+        )
+    with gr.Tab("Pairwise evaluation"):
+        gr.Markdown(
+            "Use this form after comparing two model outputs supplied by a study administrator. "
+            "No identity is collected."
+        )
+        preference = gr.Radio(["A", "B", "Tie", "Both invalid"], label="Preferred output")
+        preference_notes = gr.Textbox(label="Optional reason", lines=3)
+        preference_button = gr.Button("Submit preference")
+        preference_status = gr.Markdown()
+        preference_button.click(
+            record_preference, [preference, preference_notes], preference_status
+        )
+    gr.Markdown(
+        "Generated continuations may be inaccurate or legally restricted. The current demo "
+        "labels unexecuted image rendering rather than presenting placeholders as model results."
+    )
+
+
+if __name__ == "__main__":
+    demo.launch()

requirements.txt

@@ -0,0 +1,3 @@
+gradio>=5.9,<7
+httpx>=0.27,<1
+pillow>=10.4,<13