Skip to content

feat: adaptive and explainable quiz generation (Phase 1) #397

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
maheshxsharmask wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat: adaptive and explainable quiz generation (Phase 1) #397

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
166 changes: 124 additions & 42 deletions backend/server.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,19 +30,45 @@
CORS(app)
print("Starting Flask App...")

SERVICE_ACCOUNT_FILE = './service_account_key.json'
SERVICE_ACCOUNT_FILE = os.path.join(os.path.dirname(__file__), 'service_account_key.json')
SCOPES = ['https://www.googleapis.com/auth/documents.readonly']

MCQGen = main.MCQGenerator()
answer = main.AnswerPredictor()
BoolQGen = main.BoolQGenerator()
ShortQGen = main.ShortQGenerator()
qg = main.QuestionGenerator()
docs_service = main.GoogleDocsService(SERVICE_ACCOUNT_FILE, SCOPES)
try:
if os.path.exists(SERVICE_ACCOUNT_FILE):
docs_service = main.GoogleDocsService(SERVICE_ACCOUNT_FILE, SCOPES)
else:
docs_service = None
except Exception:
docs_service = None
file_processor = main.FileProcessor()
mediawikiapi = MediaWikiAPI()
qa_model = pipeline("question-answering")

def _dedup_strings(strings):
seen = set()
out = []
for s in strings:
k = (s or "").strip().lower()
if k and k not in seen:
seen.add(k)
out.append(s)
return out

def _dedup_questions(items, get_question):
seen = set()
out = []
for it in items:
q = (get_question(it) or "").strip().lower()
if q and q not in seen:
seen.add(q)
out.append(it)
return out


def process_input_text(input_text, use_mediawiki):
if use_mediawiki == 1:
Expand All @@ -56,11 +82,21 @@ def get_mcq():
input_text = data.get("input_text", "")
use_mediawiki = data.get("use_mediawiki", 0)
max_questions = data.get("max_questions", 4)
difficulty = data.get("difficulty", "Easy Difficulty")
input_text = process_input_text(input_text, use_mediawiki)
output = MCQGen.generate_mcq(
{"input_text": input_text, "max_questions": max_questions}
)
questions = output["questions"]
questions = output.get("questions", [])
questions = _dedup_questions(questions, lambda x: x.get("question_statement"))
if difficulty != "Easy Difficulty":
for q in questions:
q["question_statement"] = make_question_harder(q.get("question_statement", ""))
for q in questions:
if "context" in q:
q["explanation"] = q.get("context")
else:
q["explanation"] = input_text
return jsonify({"output": questions})


Expand All @@ -84,11 +120,22 @@ def get_shortq():
input_text = data.get("input_text", "")
use_mediawiki = data.get("use_mediawiki", 0)
max_questions = data.get("max_questions", 4)
difficulty = data.get("difficulty", "Easy Difficulty")
input_text = process_input_text(input_text, use_mediawiki)
output = ShortQGen.generate_shortq(
{"input_text": input_text, "max_questions": max_questions}
)
questions = output["questions"]
questions = output.get("questions", [])
questions = _dedup_questions(questions, lambda x: x.get("question") or x.get("question_statement") or x.get("Question"))
if difficulty != "Easy Difficulty":
for q in questions:
if "question" in q:
q["question"] = make_question_harder(q.get("question", ""))
elif "question_statement" in q:
q["question_statement"] = make_question_harder(q.get("question_statement", ""))
for q in questions:
q["context"] = q.get("context") or input_text
q["explanation"] = q.get("context")
return jsonify({"output": questions})


Expand All @@ -100,6 +147,7 @@ def get_problems():
max_questions_mcq = data.get("max_questions_mcq", 4)
max_questions_boolq = data.get("max_questions_boolq", 4)
max_questions_shortq = data.get("max_questions_shortq", 4)
difficulty = data.get("difficulty", "Easy Difficulty")
input_text = process_input_text(input_text, use_mediawiki)
output1 = MCQGen.generate_mcq(
{"input_text": input_text, "max_questions": max_questions_mcq}
Expand All @@ -110,6 +158,29 @@ def get_problems():
output3 = ShortQGen.generate_shortq(
{"input_text": input_text, "max_questions": max_questions_shortq}
)
mcq_qs = _dedup_questions(output1.get("questions", []), lambda x: x.get("question_statement"))
short_qs = _dedup_questions(output3.get("questions", []), lambda x: x.get("question") or x.get("question_statement") or x.get("Question"))
bool_qs = _dedup_strings(output2.get("Boolean_Questions", []))
if difficulty != "Easy Difficulty":
for q in mcq_qs:
q["question_statement"] = make_question_harder(q.get("question_statement", ""))
for q in short_qs:
if "question" in q:
q["question"] = make_question_harder(q.get("question", ""))
elif "question_statement" in q:
q["question_statement"] = make_question_harder(q.get("question_statement", ""))
bool_qs = [make_question_harder(q) for q in bool_qs]
for q in mcq_qs:
if "context" in q:
q["explanation"] = q.get("context")
else:
q["explanation"] = input_text
for q in short_qs:
q["context"] = q.get("context") or input_text
q["explanation"] = q.get("context")
output1["questions"] = mcq_qs
output2["Boolean_Questions"] = bool_qs
output3["questions"] = short_qs
return jsonify(
{"output_mcq": output1, "output_boolq": output2, "output_shortq": output3}
)
Expand Down Expand Up @@ -186,7 +257,8 @@ def get_content():
document_url = data.get('document_url')
if not document_url:
return jsonify({'error': 'Document URL is required'}), 400

if not docs_service:
return jsonify({'error': 'Google Docs service unavailable'}), 503
text = docs_service.get_document_content(document_url)
return jsonify(text)
except ValueError as e:
Expand Down Expand Up @@ -357,67 +429,77 @@ def generate_gform():
formId=result["formId"], body=NEW_QUESTION
).execute()

edit_url = jsonify(result["responderUri"])
edit_url = result.get("responderUri")
webbrowser.open_new_tab(
"https://docs.google.com/forms/d/" + result["formId"] + "/edit"
)
return edit_url
return jsonify({"form_link": edit_url})
Comment on lines +432 to +436
Copy link

@coderabbitai coderabbitai bot Jan 31, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Handle missing responderUri gracefully.

If the Forms API response doesn't include responderUri, form_link will be None, which may cause frontend issues. Consider providing a fallback or returning an error.

🛡️ Suggested fix 
     edit_url = result.get("responderUri")
+    if not edit_url:
+        # Fallback to constructing the URL from formId
+        edit_url = f"https://docs.google.com/forms/d/{result['formId']}/viewform"
     webbrowser.open_new_tab(
         "https://docs.google.com/forms/d/" + result["formId"] + "/edit"
     )
     return jsonify({"form_link": edit_url})
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
edit_url = result.get("responderUri")
webbrowser.open_new_tab(
"https://docs.google.com/forms/d/" + result["formId"] + "/edit"
)
return edit_url
return jsonify({"form_link": edit_url})
edit_url = result.get("responderUri")
if not edit_url:
# Fallback to constructing the URL from formId
edit_url = f"https://docs.google.com/forms/d/{result['formId']}/viewform"
webbrowser.open_new_tab(
"https://docs.google.com/forms/d/" + result["formId"] + "/edit"
)
return jsonify({"form_link": edit_url})
🤖 Prompt for AI Agents 
In `@backend/server.py` around lines 432 - 436, Check for a missing responderUri
before returning and calling webbrowser.open_new_tab: read
result.get("responderUri") into edit_url, and if it's falsy, build a safe
fallback using result["formId"] (e.g.,
"https://docs.google.com/forms/d/<formId>/edit") or return a clear error
response (jsonify with an error and 400) instead of returning None. Update the
webbrowser.open_new_tab call to use the same resolved link and ensure the
jsonify({"form_link": edit_url}) returns the resolved (fallback or error) value;
reference symbols: result, responderUri, formId, edit_url,
webbrowser.open_new_tab, jsonify.



@app.route("/get_shortq_hard", methods=["POST"])
def get_shortq_hard():
data = request.get_json()
input_text = data.get("input_text", "")
use_mediawiki = data.get("use_mediawiki", 0)
input_text = process_input_text(input_text,use_mediawiki)
input_questions = data.get("input_question", [])

output = qg.generate(
article=input_text, num_questions=input_questions, answer_style="sentences"
)

for item in output:
item["question"] = make_question_harder(item["question"])

return jsonify({"output": output})
max_questions = data.get("max_questions", 4)
input_text = process_input_text(input_text, use_mediawiki)
qa_list = qg.generate(article=input_text, use_evaluator=True, num_questions=max_questions, answer_style="sentences")
out = []
for qa in qa_list:
q_text = make_question_harder(qa.get("question"))
out.append({
"question": q_text,
"answer": qa.get("answer"),
"question_type": "Short_Hard",
"explanation": input_text
})
return jsonify({"output": out})


@app.route("/get_mcq_hard", methods=["POST"])
def get_mcq_hard():
data = request.get_json()
input_text = data.get("input_text", "")
use_mediawiki = data.get("use_mediawiki", 0)
input_text = process_input_text(input_text,use_mediawiki)
input_questions = data.get("input_question", [])
output = qg.generate(
article=input_text, num_questions=input_questions, answer_style="multiple_choice"
)

for q in output:
q["question"] = make_question_harder(q["question"])

return jsonify({"output": output})
max_questions = data.get("max_questions", 4)
input_text = process_input_text(input_text, use_mediawiki)
qa_list = qg.generate(article=input_text, use_evaluator=True, num_questions=max_questions, answer_style="multiple_choice")
out = []
for qa in qa_list:
q_text = make_question_harder(qa.get("question"))
ans = qa.get("answer")
if isinstance(ans, list):
opts = [o.get("answer") for o in ans if o.get("answer")]
correct = next((o.get("answer") for o in ans if o.get("correct")), None)
out.append({
"question_statement": q_text,
"question_type": "MCQ_Hard",
"options": opts,
"answer": correct,
"explanation": input_text
})
else:
out.append({
"question_statement": q_text,
"question_type": "MCQ_Hard",
"options": [],
"answer": ans,
"explanation": input_text
})
return jsonify({"output": out})

@app.route("/get_boolq_hard", methods=["POST"])
def get_boolq_hard():
data = request.get_json()
input_text = data.get("input_text", "")
use_mediawiki = data.get("use_mediawiki", 0)
input_questions = data.get("input_question", [])

max_questions = data.get("max_questions", 4)
input_text = process_input_text(input_text, use_mediawiki)

# Generate questions using the same QG model
generated = qg.generate(
article=input_text,
num_questions=input_questions,
answer_style="true_false"
)

# Apply transformation to make each question harder
harder_questions = [make_question_harder(q) for q in generated]

return jsonify({"output": harder_questions})
payload = {"input_text": input_text, "max_questions": max_questions}
final = BoolQGen.generate_boolq(payload)
questions = final.get("Boolean_Questions", [])
harder = [make_question_harder(q) for q in questions]
return jsonify({"output": harder})

@app.route('/upload', methods=['POST'])
def upload_file():
Expand Down
3 changes: 3 additions & 0 deletions eduaid_web/src/pages/Text_Input.jsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,8 @@ const Text_Input = () => {
return "get_shortq_hard";
} else if (questionType === "get_mcq") {
return "get_mcq_hard";
} else if (questionType === "get_boolq") {
return "get_boolq_hard";
}
}
return questionType;
Expand All @@ -106,6 +108,7 @@ const Text_Input = () => {
input_text: data,
max_questions: numQuestions,
use_mediawiki: isToggleOn,
difficulty: difficulty,
};

const responseData = await apiClient.post(`/${endpoint}`, requestData);
Expand Down