Triviaverse3 / src /README.md
Bharath370's picture
Upload 78 files
5af4179 verified
# ๐Ÿง  TriviaVerse โ€“ Wikipedia-Powered Quiz Generator
**TriviaVerse** is a smart quiz generator that creates questions from **Wikipedia**, **Wikidata**, and **Wikibooks**. It transforms open-access knowledge into fun and educational MCQs and flashcards using **open-source AI models**.
---
## ๐ŸŒ Live App
Access the live version on Hugging Face Spaces:
๐Ÿ”— https://huggingface.co/spaces/Bharath370/Trivia1
---
## ๐ŸŽฏ Project Objective
Build an AI-powered educational quiz platform that:
- Pulls structured data from Wikimedia APIs
- Uses LLMs to convert text into multiple-choice questions
- Lets users play trivia by topic, difficulty, or random mode
---
## ๐ŸŒ APIs Used
- ๐Ÿ“š Wikipedia API
- ๐Ÿง  Wikidata API
- ๐Ÿ“˜ Wikibooks API
---
## ๐Ÿค– AI Integration
Utilizes Hugging Face models like `google/flan-t5-base` or `mistral-7b-instruct` to:
- Generate multiple-choice questions
- Summarize answers or provide hints
- Work offline with local model caching
---
## ๐Ÿ› ๏ธ Tech Stack
| Component | Tool |
|-----------|-----------------------------|
| Backend | Python + FastAPI |
| Frontend | Python + Streamlit |
| AI Model | Hugging Face Transformers |
| Hosting | Local / Hugging Face Spaces |
---
## ๐Ÿ‘ฅ Team
- **Bharath Linga Reddy Palem** โ€“ Backend
- **Raghavender Reddy P** โ€“ AI Prompt Design + Integration
- **C Vamshidhar Reddy** โ€“ Frontend UI/UX
- **Bandi Bala Sai Manikanta** โ€“ Testing, Docs, Demo Video
- **D Prem Kowshik** โ€“ API Integration & Debugging
---
## ๐Ÿš€ How to Run Locally
```bash
git clone <your-repo-url>
cd TriviaVerse
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
streamlit run app.py
```
---
## ๐Ÿ“บ Demo Video
โ–ถ๏ธ
---
## ๐Ÿ”ฎ Future Features
- ๐Ÿ† Leaderboards and scoring
- ๐Ÿ’พ Save or export quizzes
- ๐ŸŒ Multilingual support (Indian languages coming soon)
---
## ๐Ÿค Contributions
Feel free to fork this project, open issues, or submit PRs. Letโ€™s make learning smarter and more accessible โ€” together!
---
## ๐Ÿ“„ License
This project is licensed under the MIT License.