Added

.env.example

@@ -0,0 +1,2 @@
+GOOGLE_API_KEY=<google_api_key>
+DATABASE_URL=postgresql+asyncpg://<username>:<password>@<host>:<port>/<database_name>

.github/workflows/lint.yml

@@ -0,0 +1,23 @@
+name: Ruff lint
+
+on: [push, pull_request]
+
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff
+
+      - name: Run Ruff
+        run: ruff check .

.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+.env
+
+venv/
+
+*.log
+
+app.log
+

Dockerfile

@@ -0,0 +1,20 @@
+# Use official Python image
+FROM python:3.10-slim
+
+# Set work directory
+WORKDIR /app
+
+# Copy requirements
+COPY requirements.txt .
+
+# Install dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy app code
+COPY . .
+
+# Expose port (Hugging Face Spaces expects 7860 or 8000, but FastAPI default is 8000)
+EXPOSE 7860
+
+# Start FastAPI with uvicorn on port 7860 for Hugging Face Spaces
+CMD ["uvicorn", "app.api.routes:router", "--host", "0.0.0.0", "--port", "7860"]

app/api/__init__.py

@@ -0,0 +1 @@
+from .routes import router  #noqa

app/api/routes.py

@@ -0,0 +1,56 @@
+from fastapi import APIRouter,status, Query, Request
+from fastapi.responses import HTMLResponse
+from app.services.gemini import GenerateAnswer
+from app.schemas import SOLOLevel, MCQResponse
+from app.core.exceptions import CustomException
+from fastapi.templating import Jinja2Templates
+from app.core.logging import logger
+
+templates = Jinja2Templates(directory="app/templates")
+
+answer_service = GenerateAnswer()
+
+router = APIRouter()
+
+
+@router.get("/generate_mcq", response_class=HTMLResponse)
+
+async def generate_mcq(
+    request: Request,
+    topic: str = Query(default=None),
+    solo_level: SOLOLevel = Query(default=None),
+):
+    """
+    Generate a multiple-choice question (MCQ) based on the provided topic and SOLO level in jinja template.
+    """
+    if topic and solo_level:
+        mcq = await answer_service.generate_mcq(
+            topic=topic, solo_level=solo_level
+        )  # generates mcq
+        if not mcq:
+            raise CustomException(detail="No MCQ generated.")
+        return templates.TemplateResponse(
+            "index.html", {"request": request, "mcq": mcq}
+        )
+    return templates.TemplateResponse("index.html", {"request": request})
+
+
+@router.get(
+    "/api/generate_mcq", status_code=status.HTTP_200_OK, tags=["MCQ Generation "]
+)
+async def generate_mcq_api(
+    topic: str,
+    solo_level: SOLOLevel = Query(...),
+) -> MCQResponse:
+    """
+    Generate a multiple-choice question (MCQ) based on the provided topic and SOLO level.
+    """
+    try:
+        mcq = await answer_service.generate_mcq(topic=topic, solo_level=solo_level)
+        if not mcq:
+            raise CustomException(detail="No MCQ generated.")
+        return mcq
+
+    except Exception:
+        logger.exception("Unexpected error while generating MCQ.")
+        raise CustomException(detail="Internal server error during MCQ generation.")

app/core/config.py

@@ -0,0 +1,10 @@
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+class Settings(BaseSettings):
+    GOOGLE_API_KEY: str
+
+    model_config=SettingsConfigDict(
+        env_file=".env"
+    )
+
+settings = Settings()

app/core/exceptions.py

@@ -0,0 +1,15 @@
+from http import HTTPStatus
+from fastapi import HTTPException, status
+
+
+class CustomException(HTTPException):
+    def __init__(
+        self,
+        status_code: int = status.HTTP_500_INTERNAL_SERVER_ERROR,
+        detail: str | None = None,
+    ):
+        if not detail:
+            detail = HTTPStatus(status_code).description
+
+        super().__init__(status_code=status_code, detail=detail)
+    

app/core/logging.py

@@ -0,0 +1,11 @@
+import logging
+
+def logger_setup():
+    logging.basicConfig(
+        level=logging.INFO,
+        format="%(asctime)s - %(levelname)s - %(message)s"
+    )
+    logger = logging.getLogger(__name__)
+    return logger
+
+logger = logger_setup()

app/schemas/__init__.py

@@ -0,0 +1 @@
+from .schemas import * #noqa

app/schemas/schemas.py

@@ -0,0 +1,18 @@
+from enum import Enum
+from pydantic import BaseModel, Field
+
+class SOLOLevel(str,Enum):
+    """
+    Enum for SOLO levels.
+    """
+    UNISTRUCTURAL = "unistructural"
+    MULTISTRUCTURAL = "multistructural"
+
+
+class MCQResponse(BaseModel):
+    """
+    Response model for MCQ generation.
+    """
+    question_text: str = Field(..., description="The generated question text.")
+    options: list[str] = Field(..., description="List of answer options.")
+    correct_answer: str = Field(..., description="The correct answer from the options.")

app/services/gemini.py

@@ -0,0 +1,50 @@
+from langchain_google_genai import ChatGoogleGenerativeAI
+from langchain_core.prompts import PromptTemplate
+from app.core.config import settings
+from app.schemas import MCQResponse
+
+
+class GenerateAnswer:
+    """
+    Class to generate answers using Google Gemini API.
+    """
+
+    def __init__(self):
+        self.llm = ChatGoogleGenerativeAI(
+            model="gemini-2.0-flash",
+            temperature=0.6,
+            api_key=settings.GOOGLE_API_KEY,
+        )
+
+    async def generate_mcq(self, topic: str, solo_level: str):
+        """
+        Generate an answer to the given question using Google Gemini API.
+        """
+        prompt = PromptTemplate(
+            template="""You are an AI tutor. Based on the SOLO taxonomy level and the content snippet provided, generate a single multiple-choice question (MCQ) that matches the SOLO level.
+
+            Content Snippet:
+            \"\"\"
+            Photosynthesis is the process by which plants use sunlight, water, and carbon dioxide to create glucose and oxygen. Chlorophyll absorbs sunlight.
+            \"\"\"
+
+
+            SOLO Level: {solo_level}
+            You should be based on this Topic: {topic}
+
+            SOLO Level Consideration:
+            - Unistructural: Focus on recalling a single piece of information from the content_snippet.
+            - Multistructural: Focus on recalling several pieces of information from the content_snippet.
+
+            Generate one MCQ with:
+            - "question_text": A single question aligned to the SOLO level
+            - "options": 3–4 plausible answer choices
+            - "correct_answer": The correct answer (must match one of the options)""",
+            input_variables=["topic", "solo_level"],
+            )
+        model=self.llm.with_structured_output(MCQResponse)
+        chain=prompt | model
+        response= await chain.ainvoke({"topic": topic, "solo_level": solo_level})
+        return response
+
+

app/templates/index.html

@@ -0,0 +1,361 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <title>MCQ Generator</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <style>
+        :root {
+            --primary: #4a6fa5;
+            --secondary: #6a98d8;
+            --accent: #ff6b6b;
+            --light: #f8f9fa;
+            --dark: #343a40;
+            --success: #28a745;
+            --danger: #dc3545;
+        }
+
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+            transition: all 0.3s ease;
+        }
+
+        body {
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            line-height: 1.6;
+            color: var(--dark);
+            background: linear-gradient(135deg, #f5f7fa 0%, #c3cfe2 100%);
+            min-height: 100vh;
+            padding: 0;
+        }
+
+        .container {
+            max-width: 800px;
+            margin: 0 auto;
+            padding: 20px;
+        }
+
+        header {
+            background-color: var(--primary);
+            color: white;
+            padding: 20px 0;
+            border-radius: 0 0 10px 10px;
+            box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+            text-align: center;
+            margin-bottom: 30px;
+        }
+
+        header h1 {
+            margin: 0;
+            font-size: 2.5rem;
+            font-weight: 700;
+        }
+
+        header p {
+            margin-top: 10px;
+            font-size: 1.2rem;
+            opacity: 0.9;
+        }
+
+        .card {
+            background: white;
+            border-radius: 12px;
+            box-shadow: 0 8px 16px rgba(0, 0, 0, 0.1);
+            padding: 30px;
+            margin-bottom: 30px;
+            position: relative;
+            overflow: hidden;
+        }
+
+        .card::before {
+            content: '';
+            position: absolute;
+            top: 0;
+            left: 0;
+            width: 100%;
+            height: 5px;
+            background: linear-gradient(90deg, var(--primary), var(--secondary), var(--accent));
+        }
+
+        .form-group {
+            margin-bottom: 20px;
+        }
+
+        label {
+            display: block;
+            margin-bottom: 8px;
+            font-weight: 600;
+            color: var(--dark);
+        }
+
+        input,
+        select {
+            width: 100%;
+            padding: 12px 15px;
+            border: 2px solid #dee2e6;
+            border-radius: 8px;
+            font-size: 16px;
+            color: var(--dark);
+        }
+
+        input:focus,
+        select:focus {
+            border-color: var(--secondary);
+            box-shadow: 0 0 0 3px rgba(106, 152, 216, 0.25);
+            outline: none;
+        }
+
+        .btn {
+            display: inline-block;
+            font-weight: 600;
+            text-align: center;
+            white-space: nowrap;
+            vertical-align: middle;
+            user-select: none;
+            border: none;
+            padding: 12px 24px;
+            font-size: 16px;
+            line-height: 1.5;
+            border-radius: 8px;
+            cursor: pointer;
+            transition: all 0.3s ease;
+        }
+
+        .btn-primary {
+            color: white;
+            background: linear-gradient(45deg, var(--primary), var(--secondary));
+            box-shadow: 0 4px 6px rgba(74, 111, 165, 0.2);
+        }
+
+        .btn-primary:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 6px 8px rgba(74, 111, 165, 0.3);
+        }
+
+        .btn-block {
+            display: block;
+            width: 100%;
+        }
+
+        .question {
+            background: white;
+            border-radius: 12px;
+            box-shadow: 0 8px 16px rgba(0, 0, 0, 0.1);
+            padding: 25px;
+            margin-top: 30px;
+            position: relative;
+            border-left: 5px solid var(--primary);
+        }
+
+        .question strong {
+            color: var(--primary);
+            font-size: 1.2rem;
+            margin-bottom: 15px;
+            display: block;
+        }
+
+        .question ul {
+            list-style-type: none;
+            padding: 0;
+            margin: 20px 0;
+        }
+
+        .question li {
+            padding: 10px 15px;
+            border: 1px solid #dee2e6;
+            border-radius: 8px;
+            margin-bottom: 10px;
+            transition: all 0.2s ease;
+            cursor: pointer;
+        }
+
+        .question li:hover {
+            background-color: #f8f9fa;
+            transform: translateX(5px);
+        }
+
+        .correct-answer {
+            margin-top: 20px;
+            padding: 15px;
+            background-color: rgba(40, 167, 69, 0.1);
+            border-left: 3px solid var(--success);
+            border-radius: 8px;
+            display: none;
+        }
+
+        .correct-answer strong {
+            color: var(--success);
+            font-size: 1.1rem;
+            margin-bottom: 5px;
+            display: block;
+        }
+
+        .action-buttons {
+            margin-top: 15px;
+            display: none;
+        }
+
+        .btn-retry {
+            background-color: var(--primary);
+            color: white;
+            margin-right: 10px;
+        }
+
+        .btn-show-answer {
+            background-color: var(--secondary);
+            color: white;
+        }
+
+        footer {
+            text-align: center;
+            padding: 20px;
+            margin-top: 30px;
+            color: var(--dark);
+            font-size: 0.9rem;
+        }
+
+        /* Responsive design */
+        @media (max-width: 768px) {
+            .container {
+                padding: 10px;
+            }
+
+            header h1 {
+                font-size: 2rem;
+            }
+
+            .card {
+                padding: 20px;
+            }
+
+            .btn {
+                padding: 10px 20px;
+            }
+        }
+    </style>
+</head>
+
+<body>
+    <div class="container">
+        <header>
+            <h1>MCQ Generator</h1>
+            <p>Create custom multiple-choice questions </p>
+        </header>
+
+        <div class="card">
+            <form method="get" action="/generate_mcq">
+                <div class="form-group">
+                    <label for="topic">Topic:</label>
+                    <input type="text" id="topic" name="topic" placeholder="Enter a subject or topic" required>
+                </div>
+
+                <div class="form-group">
+                    <label for="solo_level">SOLO Level:</label>
+                    <select id="solo_level" name="solo_level" required>
+                        <option value="" disabled selected>Select a level</option>
+                        <option value="unistructural">Unistructural (Basic facts)</option>
+                        <option value="multistructural">Multistructural (Multiple concepts)</option>
+
+                    </select>
+                </div>
+
+                <button type="submit" class="btn btn-primary btn-block">Generate Question</button>
+            </form>
+        </div>
+
+        {% if mcq %}
+        <div class="question">
+            <strong>Question:</strong> {{ mcq.question_text }}
+
+            <ul id="options-list">
+                {% for option in mcq.options %}
+                <li data-correct="{{ 'true' if option == mcq.correct_answer else 'false' }}"
+                    onclick="checkAnswer(this)">{{ option }}</li>
+                {% endfor %}
+            </ul>
+
+            <div class="action-buttons" id="action-buttons">
+                <button class="btn btn-retry" onclick="resetQuiz()">Try Again</button>
+                <button class="btn btn-show-answer" onclick="showAnswer()">Show Answer</button>
+            </div>
+
+            <div class="correct-answer" id="feedback">
+                <strong>✅ Correct Answer:</strong> {{ mcq.correct_answer }}
+            </div>
+        </div>
+        {% endif %}
+
+        <footer>
+            <p>MCQ Generator</p>
+        </footer>
+    </div>
+
+    <script>
+        // Add some simple interactivity
+        document.addEventListener('DOMContentLoaded', function () {
+            // Highlight form fields on focus
+            const formElements = document.querySelectorAll('input, select');
+            formElements.forEach(element => {
+                element.addEventListener('focus', function () {
+                    this.style.transform = 'translateY(-2px)';
+                });
+
+                element.addEventListener('blur', function () {
+                    this.style.transform = 'translateY(0)';
+                });
+            });
+        });
+
+        // MCQ interaction functions
+        function checkAnswer(selectedLi) {
+            const isCorrect = selectedLi.dataset.correct === 'true';
+            const options = document.querySelectorAll('#options-list li');
+
+            // Disable all options
+            options.forEach(opt => {
+                opt.onclick = null;
+                opt.style.cursor = 'default';
+            });
+
+            if (isCorrect) {
+                selectedLi.style.backgroundColor = 'rgba(40, 167, 69, 0.1)';
+                selectedLi.style.borderColor = 'var(--success)';
+                document.getElementById('feedback').style.display = 'block';
+            } else {
+                selectedLi.style.backgroundColor = 'rgba(220, 53, 69, 0.1)';
+                selectedLi.style.borderColor = 'var(--danger)';
+                document.getElementById('action-buttons').style.display = 'block';
+            }
+        }
+
+        function resetQuiz() {
+            const options = document.querySelectorAll('#options-list li');
+            options.forEach(opt => {
+                opt.style.backgroundColor = '';
+                opt.style.borderColor = '#dee2e6';
+                opt.onclick = function () { checkAnswer(this); };
+                opt.style.cursor = 'pointer';
+            });
+
+            document.getElementById('action-buttons').style.display = 'none';
+            document.getElementById('feedback').style.display = 'none';
+        }
+
+        function showAnswer() {
+            const options = document.querySelectorAll('#options-list li');
+            options.forEach(opt => {
+                if (opt.dataset.correct === 'true') {
+                    opt.style.backgroundColor = 'rgba(40, 167, 69, 0.1)';
+                    opt.style.borderColor = 'var(--success)';
+                }
+            });
+
+            document.getElementById('feedback').style.display = 'block';
+            document.getElementById('action-buttons').style.display = 'none';
+        }
+    </script>
+</body>
+
+</html>

main.py

@@ -0,0 +1,10 @@
+from fastapi import FastAPI
+from app.api import router
+import uvicorn
+
+app=FastAPI()
+app.include_router(router)
+
+
+if __name__=="__main__":
+    uvicorn.run(app, host="0.0.0.0", port=3000)

requirements.txt

@@ -0,0 +1,51 @@
+annotated-types==0.7.0
+anyio==4.9.0
+cachetools==5.5.2
+certifi==2025.4.26
+charset-normalizer==3.4.2
+click==8.1.8
+fastapi==0.115.12
+filetype==1.2.0
+google-ai-generativelanguage==0.6.18
+google-api-core==2.24.2
+google-auth==2.40.1
+googleapis-common-protos==1.70.0
+greenlet==3.2.1
+grpcio==1.71.0
+grpcio-status==1.71.0
+h11==0.16.0
+httpcore==1.0.9
+httpx==0.28.1
+idna==3.10
+Jinja2==3.1.6
+jsonpatch==1.33
+jsonpointer==3.0.0
+langchain-core==0.3.59
+langchain-google-genai==2.1.4
+langsmith==0.3.42
+Mako==1.3.10
+MarkupSafe==3.0.2
+orjson==3.10.18
+packaging==24.2
+proto-plus==1.26.1
+protobuf==5.29.4
+pyasn1==0.6.1
+pyasn1_modules==0.4.2
+pydantic==2.11.4
+pydantic-settings==2.9.1
+pydantic_core==2.33.2
+python-dotenv==1.1.0
+PyYAML==6.0.2
+requests==2.32.3
+requests-toolbelt==1.0.0
+rsa==4.9.1
+ruff==0.11.8
+sniffio==1.3.1
+SQLAlchemy==2.0.40
+starlette==0.46.2
+tenacity==9.1.2
+typing-inspection==0.4.0
+typing_extensions==4.13.2
+urllib3==2.4.0
+uvicorn==0.34.2
+zstandard==0.23.0