| title: Tamil MCQ Generator | |
| emoji: 📝 | |
| colorFrom: red | |
| colorTo: purple | |
| sdk: gradio | |
| app_file: app.py | |
| pinned: false | |
| # Tamil MCQ Generator & Quiz Web App 📝 | |
| An interactive web application to automatically generate Multiple-Choice Questions (MCQs) in Tamil from any text passage. | |
| ## 🚀 Features | |
| - **Sentence Quality Filtering**: Ensures only informative sentences are used to build questions. | |
| - **Root-based MCQ Generation**: Extracts nouns and proper nouns and lemmatizes them to ensure base root words are targeted. | |
| - **FastText Semantic Distractors**: Generates smart wrong options (distractors) using word vector clustering. | |
| - **Interactive UI**: Let users click options, see instantaneous success/fail feedback, and track their scores. | |
| ## 📦 How to Run Locally | |
| 1. Install dependencies: | |
| ```bash | |
| pip install -r requirements.txt | |
| ``` | |
| 2. Start the Streamlit application: | |
| ```bash | |
| streamlit run app.py | |
| ``` | |