intro

demo/app.py

@@ -16,6 +16,32 @@ def create_app() -> gr.Blocks:
     """Create the Gradio application with a minimal notebook-like health cell."""
     with gr.Blocks(title="Aileen3 Demo") as demo:
         gr.HTML(f"<style>{CELL_CSS}</style>")
+        with cell("📘 Introduction"):
+            gr.Markdown(
+                """
+# Aileen 3 Core
+
+Large Language Models (LLMs) rely on tools – sometimes provided by MCP servers – to interact with the outside world. Aileen 3 Core is an MCP server focused on **Information Foraging**: mining high-noise sources for novel insights and turning them into dense briefings you can consume quickly.
+
+This Space shows a small, notebook-style slice of that system so you can verify the core MCP server is reachable and working in this environment.
+
+Today, Aileen 3 Core is a contender in the **[MCP's 1st Birthday – Hosted by Anthropic and Gradio](https://huggingface.co/MCP-1st-Birthday)** hackathon. It also powers the **[Aileen 3 Agent](https://github.com/ndurner/aileen3-agent)** project, a [capstone](https://ndurner.de/links/aileen3-kaggle-writeup) for the [*AI Agents Intensive Course with Google*](https://www.kaggle.com/learn-guide/5-day-agents).
+
+For more details on setup, usage, and background, see the full project README.
+                """
+            )
+
+        with cell("🧭 How this demo is organized"):
+            gr.Markdown(
+                """
+Think of this interface as a lightweight notebook: instead of code cells, you get a sequence of interactive “cells” that walk through key aspects of the Aileen 3 Core MCP server.
+
+- The **Introduction** cell gives you the high-level context from the README.
+- The **Health check** cell below connects to the MCP server used by the Space and shows whether it can be started successfully.
+- Future cells will demonstrate the problem statement and core information-foraging capabilities.
+                """
+            )
+
         with cell("🧪 Health check"):
             health_panel = gr.HTML(value=health.render_placeholder_notice())
             run_button = gr.Button("Run health check", variant="primary")