README.md

metadata

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

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

---

MIT License