Add audience input field

Users can now specify who they are (e.g., "a college student",
"my grandmother") to get tailored explanations for their level.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

app.py

@@ -32,7 +32,7 @@ def format_sources(sources: list[dict]) -> str:
     return md
 
 
-def explain_topic(topic: str, persona_name: str, progress=gr.Progress()):
+def explain_topic(topic: str, persona_name: str, audience: str = "", progress=gr.Progress()):
     """Main function to explain a topic in a persona's voice.
 
     Returns: (explanation_text, audio_path, sources_md, steps_md)
@@ -56,7 +56,7 @@ def explain_topic(topic: str, persona_name: str, progress=gr.Progress()):
     # Run the agent pipeline
     progress(0, desc="Starting...")
 
-    for update in run_agent(topic, persona_name):
+    for update in run_agent(topic, persona_name, audience):
         if update["type"] == "step":
             step_text = f"**{update['title']}**\n{update['content']}"
             steps_log.append(step_text)
@@ -139,6 +139,14 @@ def create_app():
                     label="🎭 Choose your explainer",
                 )
 
+        with gr.Row():
+            audience_input = gr.Textbox(
+                label="👤 Who are you? (optional)",
+                placeholder="e.g., a college student, a CEO, my grandmother, a 10-year-old...",
+                lines=1,
+                max_lines=1,
+            )
+
         explain_btn = gr.Button(
             "✨ Explain it to me!",
             variant="primary",
@@ -196,21 +204,21 @@ def create_app():
         )
 
         # Event handler
-        def process_and_explain(topic, persona_with_emoji):
+        def process_and_explain(topic, persona_with_emoji, audience):
             # Extract persona name (remove emoji prefix)
             persona_name = persona_with_emoji.split(" ", 1)[1] if " " in persona_with_emoji else persona_with_emoji
-            return explain_topic(topic, persona_name)
+            return explain_topic(topic, persona_name, audience)
 
         explain_btn.click(
             fn=process_and_explain,
-            inputs=[topic_input, persona_dropdown],
+            inputs=[topic_input, persona_dropdown, audience_input],
             outputs=[explanation_output, audio_output, sources_output, steps_output],
         )
 
         # Also trigger on Enter key in topic input
         topic_input.submit(
             fn=process_and_explain,
-            inputs=[topic_input, persona_dropdown],
+            inputs=[topic_input, persona_dropdown, audience_input],
             outputs=[explanation_output, audio_output, sources_output, steps_output],
         )
 

src/agent.py

@@ -198,7 +198,7 @@ Now explain "{topic}" in your unique voice and style. Make it fun and educationa
     }
 
 
-def run_agent(topic: str, persona_name: str) -> Generator[dict, None, None]:
+def run_agent(topic: str, persona_name: str, audience: str = "") -> Generator[dict, None, None]:
     """Run the full agent pipeline.
 
     Yields progress updates and final results.
@@ -224,11 +224,16 @@ def run_agent(topic: str, persona_name: str) -> Generator[dict, None, None]:
     # Step 2: Generate explanation
     persona = get_persona(persona_name)
 
+    # Build audience context
+    audience_context = ""
+    if audience and audience.strip():
+        audience_context = f"\nYou are explaining this to: {audience.strip()}. Tailor your explanation appropriately for them."
+
     yield {
         "type": "step",
         "step": "generating",
         "title": f"{persona['emoji']} Channeling {persona_name}",
-        "content": "Transforming research into persona voice...",
+        "content": f"Transforming research into persona voice{' for ' + audience if audience else ''}...",
     }
 
     messages = [
@@ -241,7 +246,7 @@ You are explaining a topic to someone. Your explanation should be:
 2. Educational - actually explain the concept clearly
 3. About 150-200 words (suitable for text-to-speech)
 4. Natural spoken language (will be read aloud)
-5. Engaging and memorable
+5. Engaging and memorable{audience_context}
 
 Do NOT break character. Do NOT use markdown, bullet points, or special formatting.
 Just speak naturally as your character would.""",