This is a starter Flask web application that allows users to upload two PDF files:
- A student assignment
- A grading rubric
These files will later be processed using OCR and LLMs for automated grading and feedback.
- Upload two PDF files via a simple web UI
- Validates file types (PDF only)
- Stores uploaded files in a local
uploads/
folder - Ready for integration with PDF text extraction and AI processing
assignment-assistant/
├── app.py # Flask backend
├── templates/
│ └── index.html # Upload UI
├── uploads/ # Stores uploaded PDFs (ignored by Git)
├── requirements.txt # Python dependencies
├── .gitignore # Excludes uploads, cache, env files
└── README.md # Project documentation
git clone https://github.com/your-username/assignment-assistant.git
cd assignment-assistant
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python app.py
Then open your browser and go to: 👉 http://localhost:5000
- Python 3.8+
- Flask 2.x
- Uploaded files are stored locally in
uploads/
and are ignored by Git. - Make sure to sanitize and validate all user inputs in production environments.
MIT License – feel free to use and modify.
Built by Ler-Kuan, Chan – [lkchan@sc.edu.my]