---
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
   ```