Gemini key input

demo/app.py

@@ -8,8 +8,8 @@ import health
 from layout import CELL_CSS, cell
 
 
-def render_health_panel() -> str:
-    return health.render_health_notice()
+def render_health_panel(gemini_api_key: str | None = None) -> str:
+    return health.render_health_notice(gemini_api_key)
 
 
 def create_app() -> gr.Blocks:
@@ -58,10 +58,18 @@ Think of this interface as a lightweight Jupyter notebook: instead of code cells
                 """
             )
 
+        gemini_key_box = render_setup_cell()
+
         with cell("👩🏻‍⚕️ Health check"):
             health_panel = gr.HTML(value=health.render_placeholder_notice())
             run_button = gr.Button("Run health check", variant="primary")
-            run_button.click(fn=render_health_panel, outputs=health_panel, queue=False)
+            run_button.click(
+                fn=render_health_panel,
+                inputs=gemini_key_box,
+                outputs=health_panel,
+                queue=False,
+            )
+
     return demo
 
 

demo/health.py

@@ -124,14 +124,16 @@ def _check_ffmpeg() -> ToolStatus:
     return ToolStatus(label, True, first_line)
 
 
-def _check_gemini_env() -> ToolStatus:
+def _check_gemini_env(gemini_api_key: str | None = None) -> ToolStatus:
     label = "Gemini API key"
-    if os.environ.get(GEMINI_ENV_VAR):
+    # Prefer an explicit key passed from the UI; fall back to process env.
+    key = gemini_api_key or os.environ.get(GEMINI_ENV_VAR)
+    if key:
         return ToolStatus(label, True, f"{GEMINI_ENV_VAR} is set")
     return ToolStatus(label, False, f"{GEMINI_ENV_VAR} is not set")
 
 
-def _check_mcp_health() -> ToolStatus:
+def _check_mcp_health(gemini_api_key: str | None = None) -> ToolStatus:
     label = "MCP server"
     try:
         from fastmcp import Client  # type: ignore
@@ -149,6 +151,8 @@ def _check_mcp_health() -> ToolStatus:
     )
     env = os.environ.copy()
     env["PYTHONPATH"] = py_path
+    if gemini_api_key:
+        env[GEMINI_ENV_VAR] = gemini_api_key
 
     server_entry = ["-m", "aileen3_mcp.server"]
 
@@ -192,13 +196,13 @@ def _check_mcp_health() -> ToolStatus:
     return asyncio.run(probe())
 
 
-def run_health_report() -> HealthReport:
+def run_health_report(gemini_api_key: str | None = None) -> HealthReport:
     tool_statuses = [
         _check_deno(),
         _check_yt_dlp_python(),
         _check_ffmpeg(),
-        _check_gemini_env(),
-        _check_mcp_health(),
+        _check_gemini_env(gemini_api_key),
+        _check_mcp_health(gemini_api_key),
     ]
     ok = all(status.ok for status in tool_statuses)
     if ok:
@@ -213,8 +217,8 @@ def _sanitize(text: str) -> str:
     return html.escape(text, quote=False)
 
 
-def render_health_notice() -> str:
-    report = run_health_report()
+def render_health_notice(gemini_api_key: str | None = None) -> str:
+    report = run_health_report(gemini_api_key)
     state_class, icon = ("health-success", "✅") if report.ok else ("health-fail", "🧯")
     bullet_rows = "".join(
         f"<li>{'✅' if status.ok else '❌'} {_sanitize(status.label)}: "

demo/setup_cell.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+import gradio as gr
+
+from layout import cell
+
+
+def render_setup_cell() -> gr.Textbox:
+    """
+    Render a small setup cell that collects a Gemini API key.
+
+    The returned textbox component is used by other cells to pass GEMINI_API_KEY
+    into the MCP server environment.
+
+    This is recommended practice for the Gradio/Anthropic hackathon
+    """
+    with cell("🔑 Setup: Gemini API key"):
+        gr.Markdown(
+            """
+### 🔐 Why a Gemini key?
+The Aileen MCP server uses Google Gemini for slide-aware analysis and transcription. To keep the demo lightweight and avoid hard-coding
+credentials, this Space expects you to provide a **Gemini API key** that is scoped to your own Google account or test project.
+
+- The key is only used from within this Space to call Gemini via the Aileen MCP server.
+- You can revoke or rotate it at any time in your Google Cloud / AI Studio settings.
+- This respects the time of our esteemed competition reviewers in that they receive a ready-to-run environment. Cautious users may configure
+credentials in config files for the sub components by cloning this space as their own.
+
+Enter a key with access to the `gemini-*` family of models. The health check and the demos below will both
+use this value. Note that charges may be incurred, subject to your Gemini access tier.
+            """
+        )
+        gemini_key_box = gr.Textbox(
+            label="Gemini API key",
+            type="password",
+            placeholder="Paste your Gemini API key here",
+            lines=1,
+        )
+    return gemini_key_box
+