Update app.py

app.py

@@ -152,4 +152,371 @@ def grammar_lesson(topic: str) -> str:
         "articles": {
             "title": "Articles (a, an, the)",
             "explanation": "Articles are words that introduce nouns. English has three articles: 'a', 'an', and 'the'.",
-            "types": [
+            "types": [
+                {
+                    "name": "Indefinite Articles (a, an)",
+                    "form": "'a' before consonant sounds, 'an' before vowel sounds",
+                    "examples": ["a book", "an apple", "a university", "an hour"],
+                    "usage": "For non-specific, countable singular nouns"
+                },
+                {
+                    "name": "Definite Article (the)",
+                    "form": "'the' before specific nouns",
+                    "examples": ["the book I'm reading", "the sun", "the United States"],
+                    "usage": "For specific nouns, unique things, or previously mentioned items"
+                }
+            ]
+        },
+        "prepositions": {
+            "title": "Prepositions (in, on, at, etc.)",
+            "explanation": "Prepositions show relationships between words, often indicating time, place, or direction.",
+            "types": [
+                {
+                    "name": "Prepositions of Time",
+                    "form": "in, on, at",
+                    "examples": ["in 2023", "on Monday", "at 3 o'clock", "in the morning"],
+                    "usage": "in (months/years), on (days/dates), at (specific times)"
+                },
+                {
+                    "name": "Prepositions of Place",
+                    "form": "in, on, at, under, above",
+                    "examples": ["in the house", "on the table", "at school", "under the bed"],
+                    "usage": "Describe where something is located"
+                }
+            ]
+        },
+        "past_tense": {
+            "title": "Past Tense",
+            "explanation": "Past tense describes actions that happened before now.",
+            "types": [
+                {
+                    "name": "Simple Past",
+                    "form": "Subject + verb-ed (regular) or irregular form",
+                    "examples": ["I walked to school.", "She ate dinner.", "They went home."],
+                    "usage": "For completed actions in the past"
+                },
+                {
+                    "name": "Past Continuous",
+                    "form": "Subject + was/were + verb-ing",
+                    "examples": ["I was reading a book.", "They were playing soccer.", "She was cooking dinner."],
+                    "usage": "For ongoing actions in the past"
+                }
+            ]
+        }
+    }
+    
+    topic_lower = topic.lower().replace(" ", "_")
+    
+    if topic_lower in grammar_lessons:
+        lesson = grammar_lessons[topic_lower]
+        response = f"## {lesson['title']}\n\n"
+        response += f"{lesson['explanation']}\n\n"
+        
+        for grammar_type in lesson['types']:
+            response += f"### {grammar_type['name']}\n"
+            response += f"**Form:** {grammar_type['form']}\n"
+            response += f"**Usage:** {grammar_type['usage']}\n"
+            response += f"**Examples:**\n"
+            for example in grammar_type['examples']:
+                response += f"- {example}\n"
+            response += "\n"
+        
+        return response
+    else:
+        available_topics = list(grammar_lessons.keys())
+        return f"I don't have a lesson on '{topic}'. Here are available grammar topics:\n\n" + \
+               "\n".join([f"- {topic.replace('_', ' ').title()}" for topic in available_topics]) + \
+               "\n\nPlease choose one of these topics for a detailed lesson."
+
+@tool
+def practice_exercise(exercise_type: str) -> str:
+    """Generates practice exercises for English learning.
+    
+    Args:
+        exercise_type: Type of exercise (vocabulary, grammar, sentence_building)
+    
+    Returns:
+        A practice exercise with questions
+    """
+    exercises = {
+        "vocabulary": [
+            {
+                "question": "Choose the correct word to complete the sentence:",
+                "sentence": "The weather is very _____ today.",
+                "options": ["beautiful", "beautifully", "beauty", "beautify"],
+                "correct": "beautiful",
+                "explanation": "'Beautiful' is an adjective that describes the noun 'weather'."
+            },
+            {
+                "question": "What is the opposite of 'difficult'?",
+                "options": ["easy", "hard", "complex", "challenging"],
+                "correct": "easy",
+                "explanation": "'Easy' is the antonym of 'difficult'."
+            },
+            {
+                "question": "Choose the correct word:",
+                "sentence": "I am _____ to meet you.",
+                "options": ["happy", "sadly", "anger", "beautiful"],
+                "correct": "happy",
+                "explanation": "'Happy' is an adjective describing how you feel."
+            }
+        ],
+        "grammar": [
+            {
+                "question": "Choose the correct article:",
+                "sentence": "I saw _____ elephant at the zoo.",
+                "options": ["a", "an", "the", "no article"],
+                "correct": "an",
+                "explanation": "Use 'an' before words starting with vowel sounds. 'Elephant' starts with 'e'."
+            },
+            {
+                "question": "Select the correct tense:",
+                "sentence": "She _____ to school every day.",
+                "options": ["go", "goes", "going", "went"],
+                "correct": "goes",
+                "explanation": "For third person singular in simple present, add 's' to the verb."
+            },
+            {
+                "question": "Choose the correct past tense:",
+                "sentence": "Yesterday, I _____ a movie.",
+                "options": ["watch", "watched", "watching", "will watch"],
+                "correct": "watched",
+                "explanation": "For past tense of regular verbs, add '-ed' to the base form."
+            }
+        ],
+        "sentence_building": [
+            {
+                "question": "Arrange these words to make a correct sentence:",
+                "words": ["I", "every", "morning", "coffee", "drink"],
+                "correct": "I drink coffee every morning.",
+                "explanation": "Subject + verb + object + time expression is a common sentence pattern."
+            },
+            {
+                "question": "Complete the sentence with the correct word order:",
+                "sentence": "Yesterday, [beautiful/very/a/saw/I/movie]",
+                "correct": "Yesterday, I saw a very beautiful movie.",
+                "explanation": "Time + subject + verb + article + adverb + adjective + noun"
+            },
+            {
+                "question": "Build a sentence with these words:",
+                "words": ["friend", "my", "happy", "is", "very"],
+                "correct": "My friend is very happy.",
+                "explanation": "Possessive + noun + verb + adverb + adjective"
+            }
+        ]
+    }
+    
+    if exercise_type in exercises:
+        exercise = random.choice(exercises[exercise_type])
+        response = f"## {exercise_type.title()} Practice\n\n"
+        response += f"**{exercise['question']}**\n\n"
+        
+        if 'sentence' in exercise:
+            response += f"Sentence: {exercise['sentence']}\n\n"
+        
+        if 'words' in exercise:
+            response += f"Words to arrange: {', '.join(exercise['words'])}\n\n"
+        
+        if 'options' in exercise:
+            response += "Options:\n"
+            for i, option in enumerate(exercise['options'], 1):
+                response += f"{i}. {option}\n"
+            response += "\n"
+        
+        response += f"**Correct Answer:** {exercise['correct']}\n\n"
+        response += f"**Explanation:** {exercise['explanation']}"
+        
+        return response
+    else:
+        return f"Available exercise types: vocabulary, grammar, sentence_building\n\nPlease choose one of these types for practice."
+
+# Setup with local processing (no external API needed)
+final_answer = FinalAnswerTool()
+
+# Create a simple non-API based agent
+class SimpleEnglishTutor:
+    def __init__(self):
+        self.tools = {
+            'explain_word': explain_word,
+            'grammar_lesson': grammar_lesson,
+            'practice_exercise': practice_exercise,
+            'final_answer': final_answer
+        }
+    
+    def run(self, query):
+        query_lower = query.lower()
+        
+        # Route queries to appropriate tools
+        if 'explain' in query_lower and 'word' in query_lower:
+            # Extract word from query
+            words = query.split()
+            for i, word in enumerate(words):
+                if word.lower() == 'word' and i + 1 < len(words):
+                    target_word = words[i + 1].strip("'\"")
+                    return explain_word(target_word)
+            return "Please specify a word to explain. Example: 'Explain the word great'"
+        
+        elif 'grammar' in query_lower or 'lesson' in query_lower:
+            if 'present' in query_lower or 'tense' in query_lower:
+                return grammar_lesson('present_tense')
+            elif 'article' in query_lower:
+                return grammar_lesson('articles')
+            elif 'preposition' in query_lower:
+                return grammar_lesson('prepositions')
+            elif 'past' in query_lower:
+                return grammar_lesson('past_tense')
+            else:
+                return grammar_lesson('present_tense')  # default
+        
+        elif 'exercise' in query_lower or 'practice' in query_lower:
+            if 'vocabulary' in query_lower:
+                return practice_exercise('vocabulary')
+            elif 'grammar' in query_lower:
+                return practice_exercise('grammar')
+            elif 'sentence' in query_lower:
+                return practice_exercise('sentence_building')
+            else:
+                return practice_exercise('vocabulary')  # default
+        
+        else:
+            # General help
+            return """## Welcome to English Tutor! 🇬🇧
+
+I can help you with:
+
+**📚 Word Explanations**
+- Ask: "Explain the word [word]"
+- Available words: hello, beautiful, learn, great, friend, happy
+
+**📖 Grammar Lessons**
+- Present Tense
+- Articles (a, an, the)  
+- Prepositions
+- Past Tense
+
+**✏️ Practice Exercises**
+- Vocabulary practice
+- Grammar exercises
+- Sentence building
+
+**Examples:**
+- "Explain the word great"
+- "Give me a grammar lesson on articles"
+- "I want vocabulary practice"
+
+How can I help you improve your English today?"""
+
+# Create agent instance
+agent = SimpleEnglishTutor()
+
+# Create a simple Gradio UI
+try:
+    import gradio as gr
+    
+    def create_ui():
+        with gr.Blocks(theme=gr.themes.Soft(), title="English Tutor AI") as demo:
+            gr.Markdown("# 🇬🇧 English Tutor AI")
+            gr.Markdown("Improve your English with AI assistance! No external API required.")
+            
+            with gr.Tab("Word Explanation"):
+                with gr.Row():
+                    word_input = gr.Textbox(
+                        label="Enter an English word",
+                        placeholder="e.g., beautiful, learn, hello, great, friend, happy"
+                    )
+                    word_btn = gr.Button("Explain Word", variant="primary")
+                word_output = gr.Markdown()
+                
+                def explain_word_handler(word):
+                    if word:
+                        return agent.run(f"Explain the word {word}")
+                    return "Please enter a word to explain."
+                
+                word_btn.click(
+                    explain_word_handler,
+                    inputs=[word_input],
+                    outputs=[word_output]
+                )
+            
+            with gr.Tab("Grammar Lessons"):
+                with gr.Row():
+                    grammar_topic = gr.Radio(
+                        ["Present Tense", "Articles", "Prepositions", "Past Tense"],
+                        label="Choose a grammar topic"
+                    )
+                    grammar_btn = gr.Button("Get Lesson", variant="primary")
+                grammar_output = gr.Markdown()
+                
+                def grammar_handler(topic):
+                    if topic:
+                        return agent.run(f"Give me a grammar lesson on {topic}")
+                    return "Please select a grammar topic."
+                
+                grammar_btn.click(
+                    grammar_handler,
+                    inputs=[grammar_topic],
+                    outputs=[grammar_output]
+                )
+            
+            with gr.Tab("Practice Exercises"):
+                with gr.Row():
+                    exercise_type = gr.Radio(
+                        ["Vocabulary", "Grammar", "Sentence Building"],
+                        label="Choose exercise type"
+                    )
+                    exercise_btn = gr.Button("Get Exercise", variant="primary")
+                exercise_output = gr.Markdown()
+                
+                def exercise_handler(ex_type):
+                    if ex_type:
+                        return agent.run(f"Give me a {ex_type.lower()} practice exercise")
+                    return "Please select an exercise type."
+                
+                exercise_btn.click(
+                    exercise_handler,
+                    inputs=[exercise_type],
+                    outputs=[exercise_output]
+                )
+            
+            with gr.Tab("Free Chat"):
+                with gr.Row():
+                    chat_input = gr.Textbox(
+                        label="Ask anything about English",
+                        placeholder="e.g., Explain the word great, Give me grammar lesson"
+                    )
+                    chat_btn = gr.Button("Ask", variant="primary")
+                chat_output = gr.Markdown()
+                
+                chat_btn.click(
+                    agent.run,
+                    inputs=[chat_input],
+                    outputs=[chat_output]
+                )
+                
+                # Show welcome message by default
+                demo.load(lambda: agent.run(""), outputs=[chat_output])
+        
+        return demo
+    
+    # Launch the English Tutor
+    if __name__ == "__main__":
+        demo = create_ui()
+        demo.launch()
+        
+except ImportError:
+    print("Gradio not available. Running in console mode.")
+    if __name__ == "__main__":
+        print("English Tutor AI - Console Mode")
+        print("=" * 40)
+        print(agent.run(""))
+        
+        while True:
+            try:
+                user_input = input("\nYou: ")
+                if user_input.lower() in ['quit', 'exit', 'bye']:
+                    print("Goodbye! Keep practicing your English!")
+                    break
+                print("\nTutor:", agent.run(user_input))
+            except KeyboardInterrupt:
+                print("\nGoodbye! Keep practicing your English!")
+                break