Smart Exam Question Generator – AI-Based Assessment Tool

📝 Description

The Smart Exam Question Generator allows educators to easily create high-quality assessment materials by leveraging the power of AI. This application enables teachers to:

• Upload a syllabus or course content
• Automatically generate multiple-choice, short answer, and long answer questions
• Get questions tagged by Bloom's Taxonomy cognitive levels
• Create fully-formatted mock exam papers with answer keys
• Manage a question bank for future use

This tool streamlines the assessment creation process while ensuring educational value through proper alignment with cognitive learning objectives.

🛠️ Technologies Used

• Python 3.11
• Flask (Web Framework)
• SQLAlchemy (ORM)
• Flask-Login (Authentication)
• Django Admin (Admin Panel)

• HTML5, CSS3, JavaScript
• Bootstrap 5
• Jinja2
• Font Awesome

• OpenAI API (GPT-4o)

• Textract (Document Text Extraction)
• JSON (Data Formatting)

🔍 Features and Functionalities

1. User Authentication: Secure login, registration, and session handling
2. Syllabus Upload: Supports PDF, DOC/DOCX, and TXT
3. AI Question Generator: Questions categorized by Bloom’s Taxonomy
4. Question Bank: Save, edit, and manage generated questions
5. Mock Paper Creation: Build printable papers with answer keys
6. Admin Panel: Django-based dashboard to manage users, content, and analytics
7. API Key Configuration: Secure OpenAI API integration via environment variables

🚀 How to Run

Requirements: Python 3.11+, OpenAI API Key

1. Clone the repository:
   git clone https://github.com/yourusername/smart-exam-generator.git
2. Create and activate virtual environment:
   python -m venv venv && source venv/bin/activate
3. Install dependencies:
   pip install -r requirements.txt
4. Set environment variables:
   export OPENAI_API_KEY=your_key
export SESSION_SECRET=your_secret
5. Run the app:
   gunicorn --bind 0.0.0.0:5000 main:app
6. Open in browser: http://localhost:5000

Default Login Credentials:

• User: demo / password
• Admin: admin / password123 (Access at http://localhost:8000/admin/)