Upload 78 files

src/.gitignore

@@ -0,0 +1,64 @@
+## 4. .gitignore
+
+```gitignore
+# Virtual environment
+venv/
+env/
+ENV/
+.venv/
+
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*.sublime-project
+*.sublime-workspace
+
+# OS files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Environment variables
+.env
+.env.local
+.env.production
+secrets.toml
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Data files
+data/
+*.json
+*.csv
+*.xlsx
+
+# Streamlit
+.streamlit/secrets.toml
+
+# Testing
+.coverage
+.pytest_cache/
+htmlcov/
+
+# Build
+build/
+dist/
+*.egg-info/

src/README.md

@@ -0,0 +1,101 @@
+
+# 🧠 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.

src/assets/style.css

@@ -0,0 +1,491 @@
+/* assets/style.css */
+/* Custom CSS for TriviaVerse Enhanced */
+
+/* Import Google Fonts */
+@import url('https://fonts.googleapis.com/css2?family=Poppins:wght@300;400;600;700&display=swap');
+
+/* Global Variables */
+:root {
+    --primary-color: #6A057F;
+    /* Deeper purple */
+    --secondary-color: #8C1C8C;
+    /* Lighter purple */
+    --background-color: #F8F8F8;
+    /* Light gray background */
+    --text-color: #333333;
+    /* Darker text for contrast */
+    --border-radius: 12px;
+    --transition: all 0.3s ease;
+    --card-background: #FFFFFF;
+    /* White card background */
+    --shadow-light: 0 4px 15px rgba(0, 0, 0, 0.05);
+    --shadow-medium: 0 8px 30px rgba(0, 0, 0, 0.1);
+}
+
+/* Dark mode variables */
+[data-theme="dark"] {
+    --primary-color: #BB86FC;
+    /* Lighter purple for dark mode */
+    --secondary-color: #3700B3;
+    /* Darker purple for dark mode */
+    --background-color: #121212;
+    /* Dark background */
+    --text-color: #E0E0E0;
+    /* Light text */
+    --card-background: #1E1E1E;
+    /* Dark card background */
+    --shadow-light: 0 4px 15px rgba(0, 0, 0, 0.3);
+    --shadow-medium: 0 8px 30px rgba(0, 0, 0, 0.4);
+}
+
+/* Global Styles */
+* {
+    box-sizing: border-box;
+}
+
+body {
+    font-family: 'Poppins', sans-serif;
+    line-height: 1.6;
+    color: var(--text-color);
+    background-color: var(--background-color);
+    margin: 0;
+    padding: 0;
+}
+
+/* Smooth scrolling */
+html {
+    scroll-behavior: smooth;
+}
+
+/* Custom scrollbar */
+::-webkit-scrollbar {
+    width: 10px;
+    height: 10px;
+}
+
+::-webkit-scrollbar-track {
+    background: var(--background-color);
+    border-radius: 10px;
+}
+
+::-webkit-scrollbar-thumb {
+    background: var(--primary-color);
+    border-radius: 10px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+    background: var(--secondary-color);
+}
+
+/* Animations */
+@keyframes fadeIn {
+    from {
+        opacity: 0;
+        transform: translateY(20px);
+    }
+
+    to {
+        opacity: 1;
+        transform: translateY(0);
+    }
+}
+
+@keyframes slideInLeft {
+    from {
+        opacity: 0;
+        transform: translateX(-50px);
+    }
+
+    to {
+        opacity: 1;
+        transform: translateX(0);
+    }
+}
+
+@keyframes pulse {
+    0% {
+        transform: scale(1);
+    }
+
+    50% {
+        transform: scale(1.02);
+        /* Slightly less aggressive pulse */
+    }
+
+    100% {
+        transform: scale(1);
+    }
+}
+
+@keyframes shimmer {
+    0% {
+        background-position: -200px 0;
+    }
+
+    100% {
+        background-position: calc(200px + 100%) 0;
+    }
+}
+
+@keyframes popIn {
+    0% {
+        opacity: 0;
+        transform: scale(0.8);
+    }
+
+    100% {
+        opacity: 1;
+        transform: scale(1);
+    }
+}
+
+/* Utility Classes */
+.fade-in {
+    animation: fadeIn 0.5s ease-out forwards;
+}
+
+.slide-in-left {
+    animation: slideInLeft 0.5s ease-out forwards;
+}
+
+.pulse {
+    animation: pulse 2s ease-in-out infinite;
+}
+
+.pop-in {
+    animation: popIn 0.4s ease-out forwards;
+}
+
+/* Loading skeleton */
+.skeleton {
+    background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+    background-size: 200px 100%;
+    animation: shimmer 1.5s ease-in-out infinite;
+}
+
+/* Card hover effects */
+.hover-lift {
+    transition: transform 0.3s ease, box-shadow 0.3s ease;
+}
+
+.hover-lift:hover {
+    transform: translateY(-5px);
+    box-shadow: var(--shadow-medium);
+}
+
+/* Flashcard Component */
+.flashcard-container {
+    perspective: 1000px;
+    min-height: 300px;
+    cursor: pointer;
+    box-shadow: var(--shadow-medium);
+    /* Apply consistent shadow */
+    border-radius: var(--border-radius);
+    overflow: hidden;
+    /* Ensure rounded corners for internal faces */
+}
+
+.flashcard {
+    width: 100%;
+    min-height: 300px;
+    border-radius: var(--border-radius);
+    padding: 20px;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    text-align: center;
+    color: white;
+    transition: transform 0.6s;
+    transform-style: preserve-3d;
+}
+
+.flashcard.front {
+    background: linear-gradient(135deg, var(--primary-color) 0%, var(--secondary-color) 100%);
+}
+
+.flashcard.back {
+    background: var(--card-background);
+    /* Use card background variable */
+    color: var(--text-color);
+    /* Use text color variable */
+}
+
+.flashcard p {
+    font-size: 1.2rem;
+}
+
+.flip-instruction {
+    margin-top: 30px;
+    opacity: 0.8;
+    font-style: italic;
+    color: var(--text-color);
+    /* Ensure visibility in dark mode */
+}
+
+/* Streamlit specific overrides and enhancements */
+.stButton>button {
+    border-radius: var(--border-radius);
+    padding: 10px 20px;
+    font-weight: 600;
+    transition: var(--transition);
+    border: none;
+    background-color: var(--primary-color);
+    color: white;
+    box-shadow: var(--shadow-light);
+}
+
+.stButton>button:hover {
+    background-color: var(--secondary-color);
+    box-shadow: var(--shadow-medium);
+    transform: translateY(-2px);
+}
+
+.stRadio>div>label {
+    padding: 10px;
+    border-radius: var(--border-radius);
+    background-color: var(--card-background);
+    border: 1px solid #e0e0e0;
+    /* Light border for options */
+    margin-bottom: 8px;
+    transition: var(--transition);
+    box-shadow: var(--shadow-light);
+}
+
+.stRadio>div>label:hover {
+    border-color: var(--primary-color);
+    box-shadow: var(--shadow-medium);
+}
+
+/* Metric cards */
+[data-testid="stMetric"] {
+    background-color: var(--card-background);
+    border-radius: var(--border-radius);
+    padding: 20px;
+    box-shadow: var(--shadow-light);
+    transition: var(--transition);
+    animation: popIn 0.5s ease-out forwards;
+    /* Initial pop-in animation */
+}
+
+[data-testid="stMetric"]:hover {
+    transform: translateY(-3px);
+    box-shadow: var(--shadow-medium);
+}
+
+/* Expander styling */
+[data-testid="stExpander"] {
+    background-color: var(--card-background);
+    border-radius: var(--border-radius);
+    padding: 15px;
+    box-shadow: var(--shadow-light);
+    transition: var(--transition);
+}
+
+[data-testid="stExpander"]:hover {
+    box-shadow: var(--shadow-medium);
+}
+
+/* Text input styling */
+.stTextInput>div>div>input {
+    border-radius: var(--border-radius);
+    border: 1px solid #e0e0e0;
+    padding: 10px;
+    transition: var(--transition);
+}
+
+.stTextInput>div>div>input:focus {
+    border-color: var(--primary-color);
+    box-shadow: 0 0 0 2px rgba(var(--primary-color-rgb), 0.2);
+    /* Needs RGB conversion */
+}
+
+/* Selectbox styling */
+.stSelectbox>div>div {
+    border-radius: var(--border-radius);
+    border: 1px solid #e0e0e0;
+    transition: var(--transition);
+}
+
+.stSelectbox>div>div:hover {
+    border-color: var(--primary-color);
+}
+
+
+/* Responsive Typography */
+h1 {
+    font-size: clamp(1.8rem, 4vw, 3rem);
+    /* Larger headings */
+    font-weight: 700;
+    color: var(--primary-color);
+    /* Headings in primary color */
+    text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.05);
+}
+
+h2 {
+    font-size: clamp(1.5rem, 3.5vw, 2.5rem);
+    font-weight: 600;
+    color: var(--primary-color);
+}
+
+h3 {
+    font-size: clamp(1.2rem, 3vw, 2rem);
+    font-weight: 600;
+    color: var(--text-color);
+}
+
+p {
+    font-size: clamp(0.9rem, 2vw, 1.1rem);
+}
+
+/* Mobile-first responsive design */
+@media (max-width: 768px) {
+
+    /* Mobile styles */
+    .main .block-container {
+        padding: 1rem 0.5rem !important;
+        max-width: 100% !important;
+    }
+
+    /* Stack columns on mobile */
+    .row-widget.stHorizontal {
+        flex-direction: column !important;
+    }
+
+    .row-widget.stHorizontal>div {
+        width: 100% !important;
+        margin-bottom: 1rem;
+    }
+
+    /* Full-width buttons on mobile */
+    .stButton>button {
+        width: 100% !important;
+        min-height: 50px;
+        font-size: 16px !important;
+    }
+
+    /* Larger touch targets */
+    .stRadio>div>label {
+        padding: 15px !important;
+        margin: 5px 0 !important;
+    }
+
+    /* Responsive cards */
+    .card {
+        padding: 15px !important;
+        margin: 10px 0 !important;
+    }
+
+    /* Hide sidebar by default on mobile */
+    section[data-testid="stSidebar"] {
+        transform: translateX(-100%);
+        transition: transform 0.3s ease;
+    }
+
+    section[data-testid="stSidebar"][aria-expanded="true"] {
+        transform: translateX(0);
+    }
+
+    /* Adjust font sizes for mobile */
+    .score-display {
+        font-size: 24px !important;
+    }
+
+    /* Responsive quiz container */
+    .quiz-container {
+        padding: 20px !important;
+        margin: 15px 0 !important;
+    }
+}
+
+/* Tablet styles */
+@media (min-width: 769px) and (max-width: 1024px) {
+    .main .block-container {
+        max-width: 95%;
+        padding: 2rem 1rem;
+    }
+
+    .row-widget.stHorizontal>div {
+        flex: 1;
+    }
+}
+
+/* Desktop styles */
+@media (min-width: 1025px) {
+    .main .block-container {
+        max-width: 1200px;
+        padding: 3rem 2rem;
+    }
+}
+
+/* Print styles */
+@media print {
+
+    .stButton,
+    section[data-testid="stSidebar"],
+    .stRadio {
+        display: none !important;
+    }
+
+    .main {
+        padding: 0 !important;
+    }
+
+    .card {
+        break-inside: avoid;
+        page-break-inside: avoid;
+    }
+}
+
+/* Accessibility improvements */
+.stButton>button:focus,
+.stRadio>div>label:focus {
+    outline: 3px solid var(--primary-color);
+    outline-offset: 2px;
+}
+
+/* High contrast mode support */
+@media (prefers-contrast: high) {
+    :root {
+        --primary-color: #00AA00;
+        --background-color: #000000;
+        --text-color: #FFFFFF;
+    }
+}
+
+/* Reduced motion support */
+@media (prefers-reduced-motion: reduce) {
+    * {
+        animation-duration: 0.01ms !important;
+        animation-iteration-count: 1 !important;
+        transition-duration: 0.01ms !important;
+    }
+}
+
+/* Custom tooltip */
+.tooltip {
+    position: relative;
+    display: inline-block;
+}
+
+.tooltip .tooltiptext {
+    visibility: hidden;
+    width: 200px;
+    background-color: #555;
+    color: #fff;
+    text-align: center;
+    border-radius: 6px;
+    padding: 5px;
+    position: absolute;
+    z-index: 1;
+    bottom: 125%;
+    left: 50%;
+    margin-left: -100px;
+    opacity: 0;
+    transition: opacity 0.3s;
+}
+
+.tooltip:hover .tooltiptext {
+    visibility: visible;
+    opacity: 1;
+}

src/data/leaderboard.json

@@ -0,0 +1,9 @@
+[
+  {
+    "rank": 1,
+    "username": "demo_user",
+    "score": 1500,
+    "badges": 2,
+    "quizzes": 15
+  }
+]

src/data/performance_demo_user.json

@@ -0,0 +1,23 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2024-01-01T10:00:00",
+      "correct": true,
+      "difficulty": "Medium",
+      "topic": "Python programming"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.85,
+    "Medium": 0.65,
+    "Hard": 0.45
+  },
+  "topic_performance": {
+    "Python programming": {
+      "attempts": 10,
+      "correct": 8,
+      "last_seen": "2024-01-01T10:00:00"
+    }
+  },
+  "last_updated": "2024-01-01T10:00:00"
+}

src/data/performance_guest_1751358180.json

@@ -0,0 +1,23 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2025-07-01T13:53:39.067299",
+      "correct": false,
+      "difficulty": "Easy",
+      "topic": "Python (programming language)"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.6400000000000001,
+    "Medium": 0.5,
+    "Hard": 0.2
+  },
+  "topic_performance": {
+    "Python (programming language)": {
+      "attempts": 1,
+      "correct": 0,
+      "last_seen": "2025-07-01T13:53:39.067315"
+    }
+  },
+  "last_updated": "2025-07-01T13:53:39.068069"
+}

src/data/performance_guest_1751358886.json

@@ -0,0 +1,23 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2025-07-01T14:05:37.790250",
+      "correct": false,
+      "difficulty": "Hard",
+      "topic": "Python (programming language)"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.8,
+    "Medium": 0.5,
+    "Hard": 0.16000000000000003
+  },
+  "topic_performance": {
+    "Python (programming language)": {
+      "attempts": 1,
+      "correct": 0,
+      "last_seen": "2025-07-01T14:05:37.790267"
+    }
+  },
+  "last_updated": "2025-07-01T14:05:37.790994"
+}

src/data/performance_guest_1751359351.json

@@ -0,0 +1,23 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2025-07-01T14:13:13.633788",
+      "correct": true,
+      "difficulty": "Easy",
+      "topic": "Python (programming language)"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.8400000000000001,
+    "Medium": 0.5,
+    "Hard": 0.2
+  },
+  "topic_performance": {
+    "Python (programming language)": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-01T14:13:13.633810"
+    }
+  },
+  "last_updated": "2025-07-01T14:13:13.634544"
+}

src/data/performance_guest_1751359606.json

@@ -0,0 +1,40 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2025-07-01T14:17:07.443097",
+      "correct": true,
+      "difficulty": "Easy",
+      "topic": "Python (programming language)"
+    },
+    {
+      "timestamp": "2025-07-01T14:18:01.477018",
+      "correct": true,
+      "difficulty": "Medium",
+      "topic": "Python (programming language)"
+    },
+    {
+      "timestamp": "2025-07-01T14:18:39.296459",
+      "correct": true,
+      "difficulty": "Medium",
+      "topic": "Renewable energy"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.8400000000000001,
+    "Medium": 0.6800000000000002,
+    "Hard": 0.2
+  },
+  "topic_performance": {
+    "Python (programming language)": {
+      "attempts": 2,
+      "correct": 2,
+      "last_seen": "2025-07-01T14:18:01.477037"
+    },
+    "Renewable energy": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-01T14:18:39.296482"
+    }
+  },
+  "last_updated": "2025-07-01T14:18:39.297398"
+}

src/data/performance_guest_1751864420.json

@@ -0,0 +1,67 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2025-07-07T10:31:04.971495",
+      "correct": false,
+      "difficulty": "Easy",
+      "topic": "Zen of Python"
+    },
+    {
+      "timestamp": "2025-07-07T10:31:13.317178",
+      "correct": true,
+      "difficulty": "Easy",
+      "topic": "Human brain"
+    },
+    {
+      "timestamp": "2025-07-07T10:31:27.939617",
+      "correct": true,
+      "difficulty": "Easy",
+      "topic": "Glob (programming)"
+    },
+    {
+      "timestamp": "2025-07-07T10:31:37.437026",
+      "correct": true,
+      "difficulty": "Easy",
+      "topic": "Space exploration"
+    },
+    {
+      "timestamp": "2025-07-07T10:31:51.393366",
+      "correct": true,
+      "difficulty": "Easy",
+      "topic": "Guido van Rossum"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.8525440000000002,
+    "Medium": 0.5,
+    "Hard": 0.2
+  },
+  "topic_performance": {
+    "Zen of Python": {
+      "attempts": 1,
+      "correct": 0,
+      "last_seen": "2025-07-07T10:31:04.971495"
+    },
+    "Human brain": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-07T10:31:13.317178"
+    },
+    "Glob (programming)": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-07T10:31:27.939617"
+    },
+    "Space exploration": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-07T10:31:37.437026"
+    },
+    "Guido van Rossum": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-07T10:31:51.393366"
+    }
+  },
+  "last_updated": "2025-07-07T10:31:51.394368"
+}

src/data/performance_guest_1751865336.json

@@ -0,0 +1,67 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2025-07-07T10:46:08.751598",
+      "correct": true,
+      "difficulty": "Easy",
+      "topic": "History of Python"
+    },
+    {
+      "timestamp": "2025-07-07T10:46:16.632408",
+      "correct": true,
+      "difficulty": "Medium",
+      "topic": "Guido van Rossum"
+    },
+    {
+      "timestamp": "2025-07-07T10:46:24.902809",
+      "correct": false,
+      "difficulty": "Medium",
+      "topic": "Mojo (programming language)"
+    },
+    {
+      "timestamp": "2025-07-07T10:46:36.561459",
+      "correct": false,
+      "difficulty": "Easy",
+      "topic": "Quantum computing"
+    },
+    {
+      "timestamp": "2025-07-07T10:46:43.855576",
+      "correct": true,
+      "difficulty": "Easy",
+      "topic": "Python (programming language)"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.7376000000000003,
+    "Medium": 0.4800000000000001,
+    "Hard": 0.2
+  },
+  "topic_performance": {
+    "History of Python": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-07T10:46:08.751598"
+    },
+    "Guido van Rossum": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-07T10:46:16.632408"
+    },
+    "Mojo (programming language)": {
+      "attempts": 1,
+      "correct": 0,
+      "last_seen": "2025-07-07T10:46:24.903806"
+    },
+    "Quantum computing": {
+      "attempts": 1,
+      "correct": 0,
+      "last_seen": "2025-07-07T10:46:36.561459"
+    },
+    "Python (programming language)": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-07T10:46:43.855576"
+    }
+  },
+  "last_updated": "2025-07-07T10:46:43.855576"
+}

src/data/performance_guest_1751867508.json

@@ -0,0 +1,46 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2025-07-07T11:22:33.318823",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": null,
+      "topic": "Core Python Programming"
+    },
+    {
+      "timestamp": "2025-07-07T11:22:46.150026",
+      "correct": true,
+      "difficulty": "Medium",
+      "item_id": null,
+      "topic": "Guido van Rossum"
+    },
+    {
+      "timestamp": "2025-07-07T11:22:52.924391",
+      "correct": false,
+      "difficulty": "Medium",
+      "item_id": null,
+      "topic": "Renewable energy"
+    },
+    {
+      "timestamp": "2025-07-07T11:22:59.213802",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": null,
+      "topic": "Zen of Python"
+    },
+    {
+      "timestamp": "2025-07-07T11:23:07.453206",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": null,
+      "topic": "Blockchain"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.8976000000000002,
+    "Medium": 0.4800000000000001,
+    "Hard": 0.2
+  },
+  "item_performance": {},
+  "last_updated": "2025-07-07T11:23:07.454207"
+}

src/data/performance_guest_1751949545.json

@@ -0,0 +1,129 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2025-07-08T10:12:44.268613",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": "a8c17e63f951b03dc37f51167b6834f935da971039228cce1b1fdc0338aa8cfd",
+      "topic": "Mojo (programming language)"
+    },
+    {
+      "timestamp": "2025-07-08T10:12:53.405545",
+      "correct": false,
+      "difficulty": "Easy",
+      "item_id": "d70d242047ce32e010fc69695a8a1a944ecbe37de887a28da0ec09c853fb9cba",
+      "topic": "Python (programming language)"
+    },
+    {
+      "timestamp": "2025-07-08T10:13:03.254231",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": "96d6388dd0b05ec08f25b6df12fa9438bf2791174e94b6a6bc231e46a780d12f",
+      "topic": "Zen of Python"
+    },
+    {
+      "timestamp": "2025-07-08T10:13:08.799010",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": "46224de2915050b40ef08ffe55cf8cd7145b6917407c850d287cca93f36718b7",
+      "topic": "Python syntax and semantics"
+    },
+    {
+      "timestamp": "2025-07-08T10:13:13.564332",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": "d54d8b588cb7d9f3d713aeffe9e5bdf94af1b7718e46c147ace02e14c2d9e6e8",
+      "topic": "Core Python Programming"
+    },
+    {
+      "timestamp": "2025-07-08T10:13:16.999577",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": "deb77e36e422754f340189496401a09733fac8e893686d01600ef8a1f317d529",
+      "topic": "Glob (programming)"
+    },
+    {
+      "timestamp": "2025-07-08T10:13:23.685631",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": "554b5e322c6e6fc0dcc564182341a0b1f556d62c9a36d73e51e9529bbb7f44f4",
+      "topic": "General-purpose programming language"
+    },
+    {
+      "timestamp": "2025-07-08T10:13:29.510469",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": "5972464fe47cd83d10ab958e37fcaae51e78ac43993c807700150d1b6c19d037",
+      "topic": "History of Python"
+    },
+    {
+      "timestamp": "2025-07-08T10:13:33.643100",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": "c863af37208ca4545207697f5358bdfbc65c8ec4c02ca7d3bb7597fb665cb63b",
+      "topic": "Guido van Rossum"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.9312134144000004,
+    "Medium": 0.5,
+    "Hard": 0.2
+  },
+  "item_performance": {
+    "a8c17e63f951b03dc37f51167b6834f935da971039228cce1b1fdc0338aa8cfd": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-08T10:12:44.268613",
+      "topic": "Mojo (programming language)"
+    },
+    "d70d242047ce32e010fc69695a8a1a944ecbe37de887a28da0ec09c853fb9cba": {
+      "attempts": 1,
+      "correct": 0,
+      "last_seen": "2025-07-08T10:12:53.405545",
+      "topic": "Python (programming language)"
+    },
+    "96d6388dd0b05ec08f25b6df12fa9438bf2791174e94b6a6bc231e46a780d12f": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-08T10:13:03.254231",
+      "topic": "Zen of Python"
+    },
+    "46224de2915050b40ef08ffe55cf8cd7145b6917407c850d287cca93f36718b7": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-08T10:13:08.799010",
+      "topic": "Python syntax and semantics"
+    },
+    "d54d8b588cb7d9f3d713aeffe9e5bdf94af1b7718e46c147ace02e14c2d9e6e8": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-08T10:13:13.564332",
+      "topic": "Core Python Programming"
+    },
+    "deb77e36e422754f340189496401a09733fac8e893686d01600ef8a1f317d529": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-08T10:13:16.999577",
+      "topic": "Glob (programming)"
+    },
+    "554b5e322c6e6fc0dcc564182341a0b1f556d62c9a36d73e51e9529bbb7f44f4": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-08T10:13:23.685631",
+      "topic": "General-purpose programming language"
+    },
+    "5972464fe47cd83d10ab958e37fcaae51e78ac43993c807700150d1b6c19d037": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-08T10:13:29.510469",
+      "topic": "History of Python"
+    },
+    "c863af37208ca4545207697f5358bdfbc65c8ec4c02ca7d3bb7597fb665cb63b": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-08T10:13:33.643100",
+      "topic": "Guido van Rossum"
+    }
+  },
+  "last_updated": "2025-07-08T10:13:33.643100"
+}

src/data/performance_guest_1751952184.json

@@ -0,0 +1,25 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2025-07-08T10:58:04.510269",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": "5972464fe47cd83d10ab958e37fcaae51e78ac43993c807700150d1b6c19d037",
+      "topic": "History of Python"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.8400000000000001,
+    "Medium": 0.5,
+    "Hard": 0.2
+  },
+  "item_performance": {
+    "5972464fe47cd83d10ab958e37fcaae51e78ac43993c807700150d1b6c19d037": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-08T10:58:04.510269",
+      "topic": "History of Python"
+    }
+  },
+  "last_updated": "2025-07-08T10:58:04.511270"
+}

src/data/performance_user_1751958071.json

@@ -0,0 +1,32 @@
+{
+  "performance_history": [
+    {
+      "timestamp": "2025-07-08T12:32:19.564013",
+      "correct": false,
+      "difficulty": "Easy",
+      "item_id": null,
+      "topic": "Core Python Programming"
+    },
+    {
+      "timestamp": "2025-07-08T12:33:24.683614",
+      "correct": true,
+      "difficulty": "Easy",
+      "item_id": "5972464fe47cd83d10ab958e37fcaae51e78ac43993c807700150d1b6c19d037",
+      "topic": "History of Python"
+    }
+  ],
+  "difficulty_scores": {
+    "Easy": 0.7120000000000002,
+    "Medium": 0.5,
+    "Hard": 0.2
+  },
+  "item_performance": {
+    "5972464fe47cd83d10ab958e37fcaae51e78ac43993c807700150d1b6c19d037": {
+      "attempts": 1,
+      "correct": 1,
+      "last_seen": "2025-07-08T12:33:24.683614",
+      "topic": "History of Python"
+    }
+  },
+  "last_updated": "2025-07-08T12:33:24.685604"
+}

src/data/scores_demo_user.json

@@ -0,0 +1,40 @@
+{
+  "total_score": 1500,
+  "quizzes_completed": 15,
+  "badges": [
+    "beginner",
+    "learner"
+  ],
+  "achievements": [
+    "first_quiz",
+    "streak_5"
+  ],
+  "quiz_history": [
+    {
+      "timestamp": "2024-01-01T10:00:00",
+      "mode": "MCQ Quiz",
+      "score": 8,
+      "total": 10,
+      "difficulty": "Medium",
+      "percentage": 80.0
+    }
+  ],
+  "stats": {
+    "mcq": {
+      "played": 50,
+      "correct": 40
+    },
+    "flashcards": {
+      "played": 30,
+      "completed": 25
+    },
+    "facts": {
+      "played": 20,
+      "score": 18
+    }
+  },
+  "streaks": {
+    "current": 3,
+    "best": 7
+  }
+}

src/data/scores_guest_1751358767.json

@@ -0,0 +1,23 @@
+{
+    "total_score": 100,
+    "quizzes_completed": 1,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-01T14:03:02.285184",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 1,
+    "best_streak": 1
+}

src/data/scores_guest_1751358886.json

@@ -0,0 +1,50 @@
+{
+    "total_score": 200,
+    "quizzes_completed": 4,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-01T14:05:27.187628",
+            "mode": "MCQ Quiz",
+            "score": 0,
+            "total": 1,
+            "difficulty": "Hard",
+            "percentage": 0.0,
+            "points_earned": 0
+        },
+        {
+            "timestamp": "2025-07-01T14:06:10.710859",
+            "mode": "MCQ Quiz",
+            "score": 0,
+            "total": 1,
+            "difficulty": "Hard",
+            "percentage": 0.0,
+            "points_earned": 0
+        },
+        {
+            "timestamp": "2025-07-01T14:09:25.649410",
+            "mode": "Fact Game",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Hard",
+            "percentage": 100.0,
+            "points_earned": 200
+        },
+        {
+            "timestamp": "2025-07-01T14:09:32.804563",
+            "mode": "MCQ Quiz",
+            "score": 0,
+            "total": 1,
+            "difficulty": "Hard",
+            "percentage": 0.0,
+            "points_earned": 0
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 0,
+    "best_streak": 1
+}

src/data/scores_guest_1751359351.json

@@ -0,0 +1,23 @@
+{
+    "total_score": 100,
+    "quizzes_completed": 1,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-01T14:13:13.638678",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 1,
+    "best_streak": 1
+}

src/data/scores_guest_1751359606.json

@@ -0,0 +1,41 @@
+{
+    "total_score": 400,
+    "quizzes_completed": 3,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-01T14:17:07.447968",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-01T14:18:01.482211",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Medium",
+            "percentage": 100.0,
+            "points_earned": 150
+        },
+        {
+            "timestamp": "2025-07-01T14:18:39.301469",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Medium",
+            "percentage": 100.0,
+            "points_earned": 150
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 3,
+    "best_streak": 3
+}

src/data/scores_guest_1751862336.json

@@ -0,0 +1,23 @@
+{
+    "total_score": 100,
+    "quizzes_completed": 1,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-07T09:55:57.590604",
+            "mode": "Fact Game",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 1,
+    "best_streak": 1
+}

src/data/scores_guest_1751864420.json

@@ -0,0 +1,50 @@
+{
+    "total_score": 400,
+    "quizzes_completed": 4,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-07T10:31:13.321178",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-07T10:31:27.943620",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-07T10:31:37.441030",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-07T10:31:51.398366",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 4,
+    "best_streak": 4
+}

src/data/scores_guest_1751865336.json

@@ -0,0 +1,41 @@
+{
+    "total_score": 350,
+    "quizzes_completed": 3,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-07T10:46:08.756593",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-07T10:46:16.636408",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Medium",
+            "percentage": 100.0,
+            "points_earned": 150
+        },
+        {
+            "timestamp": "2025-07-07T10:46:43.859575",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 3,
+    "best_streak": 3
+}

src/data/scores_guest_1751867508.json

@@ -0,0 +1,50 @@
+{
+    "total_score": 450,
+    "quizzes_completed": 4,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-07T11:22:33.323825",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-07T11:22:46.155025",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Medium",
+            "percentage": 100.0,
+            "points_earned": 150
+        },
+        {
+            "timestamp": "2025-07-07T11:22:59.217803",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-07T11:23:07.458208",
+            "mode": "MCQ Quiz",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 4,
+    "best_streak": 4
+}

src/data/scores_guest_1751869587.json

@@ -0,0 +1,21 @@
+{
+    "total_score": 0,
+    "quizzes_completed": 1,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-07T11:58:38.071821",
+            "mode": "MCQ Quiz",
+            "score": 0,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 0.0,
+            "points_earned": 0
+        }
+    ],
+    "badges": [],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 0,
+    "best_streak": 0
+}

src/data/scores_guest_1751949545.json

@@ -0,0 +1,106 @@
+{
+    "total_score": 800,
+    "quizzes_completed": 10,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-08T10:12:25.289869",
+            "mode": "Challenge Mode",
+            "score": 0,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 0.0,
+            "points_earned": 0
+        },
+        {
+            "timestamp": "2025-07-08T10:12:44.273605",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-08T10:12:53.409539",
+            "mode": "Flashcards",
+            "score": 0,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 0.0,
+            "points_earned": 0
+        },
+        {
+            "timestamp": "2025-07-08T10:13:03.259232",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-08T10:13:08.804007",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-08T10:13:13.568333",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-08T10:13:17.004575",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-08T10:13:23.690623",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-08T10:13:29.516462",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-08T10:13:33.648094",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        }
+    ],
+    "badges": [
+        "beginner",
+        "learner"
+    ],
+    "achievements": [
+        "first_quiz",
+        "streak_5"
+    ],
+    "current_streak": 7,
+    "best_streak": 7
+}

src/data/scores_guest_1751950590.json

@@ -0,0 +1,23 @@
+{
+    "total_score": 100,
+    "quizzes_completed": 1,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-08T10:26:43.623700",
+            "mode": "Fact Game",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 1,
+    "best_streak": 1
+}

src/data/scores_guest_1751952184.json

@@ -0,0 +1,32 @@
+{
+    "total_score": 200,
+    "quizzes_completed": 2,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-08T10:57:46.096912",
+            "mode": "Fact Game",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        },
+        {
+            "timestamp": "2025-07-08T10:58:04.514264",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 2,
+    "best_streak": 2
+}

src/data/scores_user_1751958071.json

@@ -0,0 +1,23 @@
+{
+    "total_score": 100,
+    "quizzes_completed": 1,
+    "quiz_history": [
+        {
+            "timestamp": "2025-07-08T12:33:24.688611",
+            "mode": "Flashcards",
+            "score": 1,
+            "total": 1,
+            "difficulty": "Easy",
+            "percentage": 100.0,
+            "points_earned": 100
+        }
+    ],
+    "badges": [
+        "beginner"
+    ],
+    "achievements": [
+        "first_quiz"
+    ],
+    "current_streak": 1,
+    "best_streak": 1
+}

src/data/user_scores.json

@@ -0,0 +1,42 @@
+{
+  "demo_user": {
+    "total_score": 1500,
+    "quizzes_completed": 15,
+    "badges": [
+      "beginner",
+      "learner"
+    ],
+    "achievements": [
+      "first_quiz",
+      "streak_5"
+    ],
+    "quiz_history": [
+      {
+        "timestamp": "2024-01-01T10:00:00",
+        "mode": "MCQ Quiz",
+        "score": 8,
+        "total": 10,
+        "difficulty": "Medium",
+        "percentage": 80.0
+      }
+    ],
+    "stats": {
+      "mcq": {
+        "played": 50,
+        "correct": 40
+      },
+      "flashcards": {
+        "played": 30,
+        "completed": 25
+      },
+      "facts": {
+        "played": 20,
+        "score": 18
+      }
+    },
+    "streaks": {
+      "current": 3,
+      "best": 7
+    }
+  }
+}

src/data/users.json

@@ -0,0 +1,14 @@
+{
+  "demo_user": {
+    "password": "5994471abb01112afcc18159f6cc74b4f511b99806da59b3caf5a9c173cacfc5",
+    "email": "demo@example.com",
+    "created": "2024-01-01T00:00:00",
+    "last_login": "2024-01-01T00:00:00"
+  },
+  "bharath": {
+    "password": "5dbbc18c570062345ef8a30609d9a110d4a6736981f3600e39bf3f96400fc529",
+    "email": "",
+    "created": "2025-07-01T14:23:16.969698",
+    "last_login": "2025-07-01T14:23:16.969713"
+  }
+}