my pull

.env.example

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

.github/workflows/lint.yml

@@ -1,23 +0,0 @@
-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

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

Dockerfile

@@ -1,20 +0,0 @@
-# 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

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

app/api/routes.py

@@ -1,56 +0,0 @@
-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

@@ -1,10 +0,0 @@
-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

@@ -1,15 +0,0 @@
-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

@@ -1,11 +0,0 @@
-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

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

app/schemas/schemas.py

@@ -1,18 +0,0 @@
-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

@@ -1,50 +0,0 @@
-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

@@ -1,361 +0,0 @@
-<!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

@@ -1,10 +0,0 @@
-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

@@ -1,51 +0,0 @@
-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