Create app.py

app.py

@@ -0,0 +1,325 @@
+import gradio as gr
+import openai
+import json
+import random
+from datetime import datetime
+
+# Configure OpenRouter API
+openai.api_base = "https://openrouter.ai/api/v1"
+openai.api_key = "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"  # Replace with your actual key
+
+class ScienceTalkGame:
+    def __init__(self):
+        self.reset_session()
+        
+    def reset_session(self):
+        self.session = {
+            "engagement_scores": {"Maya": 3, "Jamal": 4, "Aisha": 2, "Emma": 4},
+            "teaching_points": 0,
+            "choices_made": [],
+            "current_scenario": "grade2_plants",
+            "turn_count": 0
+        }
+    
+    def get_current_scenario(self):
+        return {
+            "title": "🌱 Grade 2: Plant Investigation",
+            "setup": """Your 2nd grade students are examining classroom plants. Some are healthy and green, others are yellow and droopy. You've gathered them for a science talk to explore what they notice.""",
+            "learning_goals": "Students will observe plant differences, share ideas about plant needs, and connect to their cultural knowledge about plants.",
+            "students": {
+                "Maya": "Mexican-American, bilingual, has grandmother's gardening knowledge, sometimes shy about sharing in English",
+                "Jamal": "African-American, urban background, very curious and asks lots of questions, eager to share",
+                "Aisha": "Somali-American, thoughtful observer, needs processing time, connects to family farming knowledge", 
+                "Emma": "White suburban, enthusiastic about science, has science books at home, sometimes dominates discussions"
+            }
+        }
+    
+    def generate_student_responses(self, teacher_input):
+        scenario = self.get_current_scenario()
+        
+        # Create context-aware prompt based on engagement levels
+        engagement_context = []
+        for student, level in self.session["engagement_scores"].items():
+            if level >= 4:
+                engagement_context.append(f"{student} is highly engaged and eager to participate")
+            elif level >= 3:
+                engagement_context.append(f"{student} is moderately engaged")
+            elif level >= 2:
+                engagement_context.append(f"{student} is somewhat hesitant but paying attention")
+            else:
+                engagement_context.append(f"{student} is disengaged and may not participate")
+        
+        prompt = f"""You are role-playing four 2nd grade students (age 7-8) in a science discussion about plants. Respond as all four students would, showing their different personalities and backgrounds:
+
+**Maya**: Mexican-American, bilingual, her grandmother has a big garden with vegetables and herbs. Sometimes mixes Spanish words, a bit shy but has valuable knowledge to share.
+
+**Jamal**: African-American, lives in the city, very curious and energetic, asks lots of "what if" questions, eager to share observations.
+
+**Aisha**: Somali-American, family has farming background, thoughtful and observant, needs a moment to process before speaking, often makes connections to family experiences.
+
+**Emma**: White suburban, has lots of science books, enthusiastic but sometimes talks over others, uses formal science vocabulary.
+
+Current engagement levels: {', '.join(engagement_context)}
+
+The teacher just said: "{teacher_input}"
+
+Respond as each student would, showing their authentic 2nd grade thinking, cultural backgrounds, and current engagement levels. Format your response as:
+
+**Maya:** [her response]
+**Jamal:** [his response]  
+**Aisha:** [her response]
+**Emma:** [her response]
+
+Make the responses feel natural for 7-year-olds discussing plants they're looking at."""
+
+        try:
+            response = openai.ChatCompletion.create(
+                model="openai/gpt-3.5-turbo",
+                messages=[{"role": "user", "content": prompt}],
+                temperature=0.8,
+                max_tokens=400
+            )
+            return response.choices[0].message.content
+        except Exception as e:
+            return f"**Error generating student responses:** {str(e)}\n\nPlease check your OpenRouter API key configuration."
+    
+    def generate_teaching_choices(self, context=""):
+        """Generate contextual teaching choices based on the situation"""
+        base_choices = [
+            "🌟 Build on cultural knowledge: Ask Maya about her grandmother's gardening wisdom",
+            "🤝 Create inclusive space: Make sure all students get a chance to share their thinking", 
+            "🔬 Promote investigation: Guide students to plan how they could test their ideas",
+            "⚖️ Manage participation: Redirect from dominant voices to quieter students"
+        ]
+        
+        # Add scenario-specific choices
+        contextual_choices = [
+            "🌱 Connect to home experiences: Ask what students notice about plants where they live",
+            "💭 Support thinking time: Give students a moment to observe before sharing",
+            "🗣️ Encourage peer discussion: Have students share ideas with a partner first",
+            "📊 Document observations: Help students record what they notice systematically"
+        ]
+        
+        # Randomly select 4 choices to keep it fresh
+        all_choices = base_choices + contextual_choices
+        return random.sample(all_choices, 4)
+    
+    def assess_teaching_choice(self, choice_text):
+        """Assess the pedagogical quality of the teaching choice"""
+        feedback = ""
+        points = 0
+        engagement_impact = {}
+        
+        # Analyze choice for different pedagogical moves
+        choice_lower = choice_text.lower()
+        
+        if "cultural" in choice_lower or "grandmother" in choice_lower:
+            feedback = "🌟 Excellent! You're building on Maya's cultural assets. This validates her family knowledge and shows other students that diverse knowledge is valued in science."
+            points = 3
+            engagement_impact = {"Maya": 2, "Aisha": 1}  # Cultural validation helps both students
+            
+        elif "inclusive" in choice_lower or "all students" in choice_lower:
+            feedback = "✅ Great equity move! Creating space for all voices helps build a classroom community where everyone's thinking is valued."
+            points = 2
+            engagement_impact = {"Aisha": 2, "Maya": 1}  # Helps quieter students
+            
+        elif "investigation" in choice_lower or "test" in choice_lower:
+            feedback = "🔬 Good scientific thinking! You're helping students engage in authentic science practices."
+            points = 2
+            engagement_impact = {"Jamal": 1, "Emma": 1}  # Appeals to curious students
+            
+        elif "manage" in choice_lower or "redirect" in choice_lower:
+            feedback = "⚖️ Important facilitation move! Managing participation ensures equitable discourse."
+            points = 2
+            engagement_impact = {"Emma": -1, "Aisha": 2, "Maya": 1}  # Redistributes participation
+            
+        elif "home" in choice_lower or "where they live" in choice_lower:
+            feedback = "🏠 Nice connection! Linking to students' lived experiences makes science relevant and accessible."
+            points = 2
+            engagement_impact = {"Maya": 1, "Aisha": 1, "Jamal": 1}
+            
+        elif "thinking time" in choice_lower or "moment to" in choice_lower:
+            feedback = "💭 Thoughtful move! Wait time benefits all students, especially those who need processing time."
+            points = 2
+            engagement_impact = {"Aisha": 2, "Maya": 1}
+            
+        elif "peer discussion" in choice_lower or "partner" in choice_lower:
+            feedback = "🗣️ Smart strategy! Peer talk builds confidence before whole-group sharing."
+            points = 2
+            engagement_impact = {"Maya": 1, "Aisha": 1}
+            
+        else:
+            feedback = "Consider how this choice supports equitable participation and builds on student thinking."
+            points = 1
+            engagement_impact = {}
+        
+        return feedback, points, engagement_impact
+    
+    def update_engagement(self, impact_dict):
+        """Update student engagement based on teaching choices"""
+        for student, change in impact_dict.items():
+            current = self.session["engagement_scores"][student]
+            new_score = max(1, min(5, current + change))  # Keep between 1-5
+            self.session["engagement_scores"][student] = new_score
+    
+    def get_engagement_display(self):
+        """Create visual representation of student engagement"""
+        display = "## 📊 Student Engagement Levels\n\n"
+        for student, score in self.session["engagement_scores"].items():
+            stars = "⭐" * score + "☆" * (5-score)
+            display += f"**{student}:** {stars} ({score}/5)\n\n"
+        return display
+    
+    def get_scenario_info(self):
+        scenario = self.get_current_scenario()
+        return f"""## {scenario['title']}
+
+**Situation:** {scenario['setup']}
+
+**Learning Goals:** {scenario['learning_goals']}
+
+**Your Students:**
+- **Maya:** {scenario['students']['Maya']}
+- **Jamal:** {scenario['students']['Jamal']}  
+- **Aisha:** {scenario['students']['Aisha']}
+- **Emma:** {scenario['students']['Emma']}
+"""
+
+# Initialize game
+game = ScienceTalkGame()
+
+def start_new_session():
+    """Reset the game for a new session"""
+    game.reset_session()
+    scenario_info = game.get_scenario_info()
+    engagement_display = game.get_engagement_display()
+    welcome_msg = """## Welcome to Science Talk Adventure! 🌟
+
+You're about to practice facilitating an equitable science discussion with a diverse group of 2nd graders. Your goal is to:
+
+1. **Include all student voices** - especially those who might be hesitant to share
+2. **Build on cultural assets** - honor the knowledge students bring from home
+3. **Promote scientific thinking** - help students observe, question, and investigate
+4. **Manage participation** - ensure discussions are equitable
+
+**To begin:** Type what you would say to start the science talk, then click 'Send Response'."""
+    
+    return scenario_info, engagement_display, welcome_msg, f"**Teaching Points:** {game.session['teaching_points']}", ""
+
+def process_teacher_input(teacher_input):
+    """Process teacher's response and generate student reactions"""
+    if not teacher_input or not teacher_input.strip():
+        return "Please enter what you would say to your students.", "", ""
+    
+    # Generate student responses
+    student_response = game.generate_student_responses(teacher_input)
+    
+    # Generate teaching choice options
+    choices = game.generate_teaching_choices()
+    choice_display = "## 🎯 How do you respond? Choose your next move:\n\n"
+    for i, choice in enumerate(choices, 1):
+        choice_display += f"**Option {i}:** {choice}\n\n"
+    
+    # Update turn count
+    game.session["turn_count"] += 1
+    
+    return student_response, choice_display, ""
+
+def handle_teaching_choice(choice_num):
+    """Process the selected teaching choice"""
+    if choice_num < 1 or choice_num > 4:
+        return "Please select a valid choice (1-4).", "", ""
+    
+    # Get the choice (this is simplified - in full version, we'd track the actual choices)
+    choice_options = game.generate_teaching_choices()
+    if choice_num <= len(choice_options):
+        selected_choice = choice_options[choice_num - 1]
+        
+        # Assess the choice
+        feedback, points, engagement_impact = game.assess_teaching_choice(selected_choice)
+        
+        # Update game state
+        game.session["teaching_points"] += points
+        game.update_engagement(engagement_impact)
+        game.session["choices_made"].append({
+            "choice": selected_choice,
+            "points": points,
+            "turn": game.session["turn_count"]
+        })
+        
+        # Create response
+        updated_engagement = game.get_engagement_display()
+        points_display = f"**Teaching Points:** {game.session['teaching_points']}"
+        
+        return feedback, updated_engagement, points_display
+    
+    return "Choice not found.", "", ""
+
+# Create Gradio interface
+def create_interface():
+    with gr.Blocks(title="Science Talk Adventure", theme=gr.themes.Soft()) as interface:
+        gr.Markdown("# 🌱 Science Talk Adventure: Practice Equitable Science Discussions")
+        gr.Markdown("*An interactive simulation for preservice elementary teachers*")
+        
+        with gr.Row():
+            with gr.Column(scale=2):
+                scenario_info = gr.Markdown(game.get_scenario_info())
+                
+                conversation_area = gr.Markdown("*Students will respond here after you speak...*")
+                
+                teacher_input = gr.Textbox(
+                    label="💬 What do you say to your students?",
+                    placeholder="Type your response here... (e.g., 'What do you notice about these plants?')",
+                    lines=3
+                )
+                
+                send_btn = gr.Button("Send Response", variant="primary", size="lg")
+                
+                choices_display = gr.Markdown("")
+                
+                with gr.Row():
+                    choice1_btn = gr.Button("Choice 1", variant="secondary")
+                    choice2_btn = gr.Button("Choice 2", variant="secondary") 
+                    choice3_btn = gr.Button("Choice 3", variant="secondary")
+                    choice4_btn = gr.Button("Choice 4", variant="secondary")
+                
+                feedback_display = gr.Markdown("")
+                
+            with gr.Column(scale=1):
+                engagement_display = gr.Markdown(game.get_engagement_display())
+                points_display = gr.Markdown(f"**Teaching Points:** {game.session['teaching_points']}")
+                
+                gr.Markdown("---")
+                restart_btn = gr.Button("🔄 Start New Session", variant="outline")
+                
+                gr.Markdown("""
+                ### 💡 Tips for Success:
+                - **Listen for cultural knowledge** students share
+                - **Create wait time** for all students to think  
+                - **Build on student ideas** rather than immediately correcting
+                - **Notice who's participating** and who might need encouragement
+                """)
+        
+        # Event handlers
+        restart_btn.click(
+            start_new_session,
+            outputs=[scenario_info, engagement_display, conversation_area, points_display, feedback_display]
+        )
+        
+        send_btn.click(
+            process_teacher_input,
+            inputs=[teacher_input],
+            outputs=[conversation_area, choices_display, feedback_display]
+        )
+        
+        choice1_btn.click(lambda: handle_teaching_choice(1), outputs=[feedback_display, engagement_display, points_display])
+        choice2_btn.click(lambda: handle_teaching_choice(2), outputs=[feedback_display, engagement_display, points_display])
+        choice3_btn.click(lambda: handle_teaching_choice(3), outputs=[feedback_display, engagement_display, points_display])
+        choice4_btn.click(lambda: handle_teaching_choice(4), outputs=[feedback_display, engagement_display, points_display])
+        
+    return interface
+
+# Launch the app
+if __name__ == "__main__":
+    demo = create_interface()
+    demo.launch()