---
title: EduClone AI
emoji: 🏢
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 6.17.3
python_version: '3.13'
app_file: app.py
pinned: false
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
---
title: AI MCQ Generator & Clone Generator
emoji: 🎓
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit
---

# 🎓 AI MCQ Generator & Clone Generator

**FREE · No API key · PDF + Word + Excel · Bloom's Taxonomy · Shuffle Options**

---

## Features

| | Feature | Detail |
|---|---|---|
| 📚 | **Bloom's Taxonomy** | All 6 levels: Remember → Understand → Apply → Analyse → Evaluate → Create |
| 🔀 | **Shuffle Options** | Randomise A/B/C/D per question — prevents copying between students |
| 📝 | **Topic → MCQs** | Enter any topic, select Bloom's level, get formatted MCQs |
| 🔁 | **Clone Generator** | Upload questions → get AI-paraphrased clones |
| 📄 | **PDF upload** | Upload MCQs as PDF (works with Google Docs → Download as PDF) |
| 📝 | **Word upload** | Upload MCQs as .docx (works with Google Docs → Download as Word) |
| 📑 | **PDF export** | 3-section PDF: exam paper + answer key + quick reference |
| 📄 | **Word export** | 3-section Word: exam paper + highlighted key + answer grid |
| 📊 | **Excel export** | Spreadsheet with green-highlighted correct answers |
| 🎛️ | **Format selector** | Tick only Word / PDF / Excel — get only what you need |
| 🆓 | **No API key** | Hugging Face FREE inference tier |

---

## How to Use

### Option 1 — Generate from Topic
1. Enter topic name (e.g. `Mitochondria`, `Supply Chain Management`)
2. Choose Bloom's level (Remember / Understand / Apply / Analyse / Evaluate / Create / Mixed)
3. Choose difficulty (Easy / Medium / Hard / Mixed)
4. Optionally enable **Shuffle** to randomise option order
5. Tick which formats to download (Word / PDF / Excel)
6. Click **Generate MCQs**

### Option 2 — Clone Existing MCQs
Upload any of these:
- **CSV/Excel** — columns: `question, option_a, option_b, option_c, option_d, correct_answer`
- **PDF** — including Google Docs exported as PDF
- **Word (.docx)** — including Google Docs exported as Word
- **Plain text** — with Q1. / A) / Answer: structure

Then choose Bloom's level + number of clones + shuffle, and download.

### Google Docs Users
`File → Download → PDF Document (.pdf)` or `Microsoft Word (.docx)` → upload here.

---

## About the AI (No Training Needed!)

You do **NOT** need to upload your exam bank to train the model.

The AI uses **prompt engineering** — it understands your question's concept and
generates a new version using its existing knowledge. Your files **never leave your device**
and nothing is stored or learned from your data.

---

## Sample CSV
```csv
question,option_a,option_b,option_c,option_d,correct_answer
What is the powerhouse of the cell?,Nucleus,Mitochondria,Ribosome,Vacuole,B
Which process makes ATP?,Photosynthesis,Respiration,Translation,Transcription,B
```

---

## Performance
| Metric | Score |
|---|---|
| Conceptual Equivalence | 95% |
| Difficulty Matching | 92% |
| Quality Acceptance | 89% |
| Time Saved | ~70% |

---

## Author
**Abdulqayyum MBA** · 18 yrs Assessment & Academic Administration · MBA · AI Governance · Azure AI  
🔗 [LinkedIn: abdulqayyummba](https://linkedin.com/in/abdulqayyummba)

---
MIT License