Add initial project files

.gitignore

@@ -0,0 +1,5 @@
+env/
+.env
+.env.*
+.env.local
+__pycache__/

README.md

@@ -1,14 +1,13 @@
 ---
 title: Quizy
-emoji: 🐢
-colorFrom: red
-colorTo: blue
+emoji: 🏆
+colorFrom: green
+colorTo: yellow
 sdk: gradio
 sdk_version: 5.33.0
 app_file: app.py
 pinned: false
-license: mit
+tag: agent-demo-track
 short_description: Quiz Generator by PDFs
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+videoOverview: https://youtu.be/DcDEcS23ssc
+---

app.py

@@ -0,0 +1,128 @@
+import os
+import json
+import gradio as gr
+import PyPDF2 as pypdf
+from prompts import prompts
+from stylesheet import style
+from dotenv import load_dotenv
+from azure.ai.inference import ChatCompletionsClient
+from azure.ai.inference.models import SystemMessage, UserMessage
+from azure.core.credentials import AzureKeyCredential
+
+load_dotenv()
+
+css, js = style()
+
+
+# AI Response Generation Function
+def ai(system_prompt, user_prompt):
+    endpoint = "https://abhin-marwbf2g-eastus2.cognitiveservices.azure.com/openai/deployments/gpt-4o"
+    model_name = "gpt-4o"
+    api_key = os.getenv("API_KEY")
+    client = ChatCompletionsClient(
+        endpoint=endpoint,
+        credential=AzureKeyCredential(api_key),
+    )
+    response = client.complete(
+        messages=[
+            SystemMessage(content=system_prompt),
+            UserMessage(content=user_prompt),
+        ],
+        max_tokens=4096,
+        temperature=1.0,
+        top_p=1.0,
+        model=model_name,
+    )
+    # print("---------AI RESPONSE RECEIVED-----------")
+    return response.choices[0].message.content
+
+
+# PDF To Text Conversion Function
+def convertPdfIntoText(file):
+    if file is None:
+        return "No file uploaded."
+    pypdf_reader = pypdf.PdfReader(file.name)
+    text = ""
+    for page in pypdf_reader.pages:
+        text += page.extract_text() + "\n"
+    # print("---------PDF TEXT EXTRACTION DONE-----------")
+    return text.strip()
+
+
+# Gradio Interface Setup
+with gr.Blocks(title="Quizy", css=css, head=js) as demo:
+    gr.Markdown("# Quizy: Quiz Generator")
+    gr.Markdown("Upload a PDF file to generate a quiz based on its content.")
+
+    file_input = gr.File(label="Upload PDF File", file_types=[".pdf"])
+    submit_btn = gr.Button("Generate Quiz", visible=True, elem_id="generate-btn")
+
+    with gr.Accordion("Quiz", open=False, visible=False) as quiz_accordion:
+        output_container = gr.HTML()
+
+    # Main Function
+    def generate_quiz(file):
+        if file is None:
+            return "<p>No file uploaded.</p>", gr.Accordion(visible=False)
+
+        inputData = convertPdfIntoText(file)
+
+        systemPrompt, userPrompt = prompts(inputData)
+        response = ai(systemPrompt, userPrompt)
+
+        clean_response = response.strip().removeprefix("```json").removesuffix("```")
+        clean_response = clean_response.strip()
+        quiz_data = json.loads(clean_response)
+
+        html = "<div class='quiz-container'>"
+
+        # Store the answers in a separate div for JavaScript access
+        answers_json = {
+            str(i): question["answer"] for i, question in enumerate(quiz_data["quiz"])
+        }
+        html += f"<div id='quiz-answers' style='display:none;'>{json.dumps(answers_json)}</div>"
+
+        for i, question in enumerate(quiz_data["quiz"]):
+            question_type = question["type"]
+
+            answer_json = json.dumps(question["answer"]).replace('"', "&quot;")
+            html += f"<div class='question' data-id='{i}' data-type='{question_type}' data-answer='{answer_json}'>"
+            html += f"<h3>Question {i+1}: {question['question']}</h3>"
+
+            if question_type == "single_choice":
+                if "options" in question:
+                    html += "<div class='options'>"
+                    for option in question["options"]:
+                        html += f"<div><input type='radio' name='q{i}' value='{option}'> {option}</div>"
+                    html += "</div>"
+            if question_type == "true_false":
+                html += "<div class='options'>"
+                html += "<div><input type='radio' name='q{i}' value='True'> True</div>"
+                html += (
+                    "<div><input type='radio' name='q{i}' value='False'> False</div>"
+                )
+                html += "</div>"
+            elif question_type == "multiple_choice":
+                if "options" in question:
+                    html += "<div class='options'>"
+                    for option in question["options"]:
+                        html += f"<div><input type='checkbox' name='q{i}[]' value='{option}'> {option}</div>"
+                    html += "</div>"
+            elif question_type == "fill_in_the_blank":
+                html += "<input type='text' placeholder='Enter your answer here...'>"
+
+            html += "</div>"
+
+        html += "<button class='submit-btn' onclick='checkAnswers()'>Submit</button>"
+        html += "<div id='result'></div>"
+        html += "</div>"
+
+        return html, gr.Accordion(visible=True)
+
+    submit_btn.click(
+        fn=generate_quiz,
+        inputs=file_input,
+        outputs=[output_container, quiz_accordion],
+    )
+
+demo.launch()

prompts.py

@@ -0,0 +1,74 @@
+def prompts(data: str) -> tuple[str, str]:
+    """
+    System and User prompts for a quiz question generation task.
+
+    Args:
+        data (str): The input data string containing factual or conceptual information.
+
+    Returns:
+        tuple[str, str]: A tuple containing the system prompt and the user prompt.
+    """
+
+    if not isinstance(data, str):
+        raise ValueError("Input data must be a string.")
+
+    if not data.strip():
+        raise ValueError("Input data cannot be an empty string.")
+
+    data = data.strip()
+    json_example = r"""
+    {"quiz": [
+                {"question": "What is the capital of France?",
+                  "type": "single_choice", 
+                  "options": ["Paris", "London", "Berlin", "Madrid"],
+                  "answer": "Paris"
+                },
+                {"question": "Select all the programming languages:",
+                  "type": "multiple_choice", 
+                  "options": ["Python", "HTML", "Java", "CSS"],
+                  "answer": ["Python", "Java"]
+                },
+                {"question": "The sky is blue. (True/False)",
+                  "type": "true_false",
+                  "answer": "True"
+                },
+                {"question": "________ is known as the Red Planet.",
+                  "type": "fill_in_the_blank",
+                  "answer": "Mars"
+                }
+              ]
+    }
+    """
+    system_prompt = f"""
+You are a Quiz Question Generator AI. Your task is to read and understand the provided input data (a plain text string containing factual or conceptual information), and generate a set of quiz questions based on it.
+
+The questions should:
+- Be clear, relevant, and varied in format (e.g., multiple choice, single choice, true/false, fill-in-the-blank, etc.).
+- Be phrased in a way that tests comprehension, recall, or reasoning based on the input data.
+- Include 3 to 4 answer options where applicable (e.g., multiple/single choice).
+- Clearly indicate the correct answer(s).
+
+Return your output in **valid raw JSON format** using the following structure:
+
+```json
+{json_example}
+```
+Additional Guidelines:
+Ensure the question and answer pair is clearly and correctly based on the input data string.
+
+Do not hallucinate facts that are not present in the provided data.
+
+Keep the language simple and clear.
+
+Avoid repetition across questions.
+
+Only return the JSON structure as your final output. Do not include any commentary or explanation.
+"""
+    user_prompt = f"""
+Please generate a set of quiz questions based on the following data:
+
+{data}
+
+Return the questions in JSON format as described, including the correct answers for each. Use a variety of question types such as multiple choice, single choice, true/false, and fill-in-the-blank.
+"""
+    return system_prompt.strip(), user_prompt.strip()

requirements.txt

@@ -0,0 +1,60 @@
+aiofiles==24.1.0
+annotated-types==0.7.0
+anyio==4.9.0
+azure-ai-inference==1.0.0b9
+azure-core==1.34.0
+certifi==2025.4.26
+charset-normalizer==3.4.2
+click==8.2.1
+colorama==0.4.6
+dotenv==0.9.9
+fastapi==0.115.12
+ffmpy==0.6.0
+filelock==3.18.0
+fsspec==2025.5.1
+gradio==5.32.1
+gradio_client==1.10.2
+groovy==0.1.2
+h11==0.16.0
+httpcore==1.0.9
+httpx==0.28.1
+huggingface-hub==0.32.4
+idna==3.10
+isodate==0.7.2
+Jinja2==3.1.6
+markdown-it-py==3.0.0
+MarkupSafe==3.0.2
+mdurl==0.1.2
+numpy==2.2.6
+orjson==3.10.18
+packaging==25.0
+pandas==2.2.3
+pillow==11.2.1
+pydantic==2.11.5
+pydantic_core==2.33.2
+pydub==0.25.1
+Pygments==2.19.1
+PyPDF2==3.0.1
+python-dateutil==2.9.0.post0
+python-dotenv==1.1.0
+python-multipart==0.0.20
+pytz==2025.2
+PyYAML==6.0.2
+requests==2.32.3
+rich==14.0.0
+ruff==0.11.12
+safehttpx==0.1.6
+semantic-version==2.10.0
+shellingham==1.5.4
+six==1.17.0
+sniffio==1.3.1
+starlette==0.46.2
+tomlkit==0.13.2
+tqdm==4.67.1
+typer==0.16.0
+typing-inspection==0.4.1
+typing_extensions==4.14.0
+tzdata==2025.2
+urllib3==2.4.0
+uvicorn==0.34.3
+websockets==15.0.1

stylesheet.py

@@ -0,0 +1,100 @@
+def style():
+    css = """
+             .submit-btn {
+                padding: 10px 20px;
+                color: #333;
+                background-color: #face00;
+                border: 1px solid #ddd;
+                border-radius: 5px;
+                margin-top: 20px;
+                }
+             #result {
+                display: none;
+                margin: 0;
+                padding-left: 20px;
+                padding-bottom: 20px;
+                color: #000000;
+                background-color: darkviolet
+                }
+             input[type="text"] {
+                width: 100%;
+                padding: 10px;
+                color: #333333;
+                border-radius: 5px;
+                }
+    """
+    js = """
+            <script>
+            function checkAnswers() {
+                let score = 0;
+                let total = 0;
+                const questions = document.querySelectorAll(".question");
+                let userAnswer = "";
+                const resultElement = document.getElementById("result");
+
+                questions.forEach((question) => {
+                  total++;
+                  const questionType = question.getAttribute("data-type");
+                  const correctAnswerJSON = question.getAttribute("data-answer");
+                  const correctAnswer = JSON.parse(correctAnswerJSON);
+                  const inputs = question.querySelectorAll("input");
+
+                  if (questionType === "single_choice" || questionType === "true_false") {
+                    // For radio buttons (single selection)
+                    inputs.forEach((input) => {
+                      if (input.checked) {
+                        userAnswer = input.value;
+                      }
+                    });
+
+                    if (userAnswer === correctAnswer) {
+                      score++;
+                    }
+                  } else if (questionType === "multiple_choice") {
+                    // For checkboxes (multiple selection)
+                    const selectedOptions = Array.from(inputs)
+                      .filter((input) => input.checked)
+                      .map((input) => input.value);
+
+                    // Compare arrays (needs to match exactly)
+                    const correctArray = Array.isArray(correctAnswer)
+                      ? correctAnswer
+                      : [correctAnswer];
+                    if (
+                      selectedOptions.length === correctArray.length &&
+                      selectedOptions.every((opt) => correctArray.includes(opt))
+                    ) {
+                      score++;
+                    }
+                  } else if (questionType === "fill_in_the_blank") {
+                    // For text input
+                    userAnswer = inputs[0].value.trim().toLowerCase();
+                    const correctText = String(correctAnswer).trim().toLowerCase();
+
+                    if (userAnswer === correctText) {
+                      score++;
+                    }
+                  }
+                });
+
+                // Display the result
+                resultElement.style.display = "block";
+                if (score === total) {
+                  resultElement.innerHTML = `<h2>Result: </h2> <br />
+                  <h3>Congratulations! You answered all questions correctly!</h3>
+                  <h3>Your score: ${score}/${total}</h3>`;
+                } else if (score < total / 2) {
+                  resultElement.innerHTML = `<h2>Result: </h2> <br /> <h3>Keep trying! You can do better!</h3> <h3>Your score: ${score}/${total}</h3>`;
+                } else {
+                  resultElement.innerHTML = `<h2>Result: </h2> <br />
+                  <h3>Good job! You answered ${score} out of ${total} questions correctly.</h3>
+                  <h3>Your score: ${score}/${total}</h3>`;
+                }
+                // resultElement.style.backgroundColor = score > (total/2) ? '#e6ffe6' : '#fff0f0';
+                resultElement.style.border = "1px solid #ddd";
+                resultElement.style.borderRadius = "5px";
+                resultElement.style.marginTop = "20px";
+            }
+            </script>
+    """
+    return css, js