Skip to content

mulikruchi07/EduCheck

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EduCheck

EduCheck is a lightweight academic submission analysis and similarity detection platform that allows faculty to upload structured student ZIP submissions, automatically extract files, detect duplicate or highly similar work, and generate detailed CSV reports with real-time progress tracking and processing controls.

Live Demo

https://educheck.ruchitechs.me

What it does

  • Upload a ZIP file containing structured student submissions.
  • Automatically extract and analyze all files recursively.
  • Detect duplicate or highly similar practical submissions.
  • Generate detailed CSV reports with full file paths.
  • Preview CSV results directly inside the browser.
  • Track real-time processing progress.
  • Pause, resume, or cancel analysis anytime.

Problem solved

Faculty often spend hours manually checking practical files and identifying copied submissions. Students commonly rename files or modify roll numbers before resubmitting duplicated work. EduCheck automates this workflow by extracting submissions, analyzing document similarities, and generating structured reports instantly.

Project structure

EduCheck/
│
├── static/
│   ├── favicon.ico
│   ├── style.css
│   └── script.js
│
├── templates/
│   └── index.html
│
├── uploads/
├── extracted/
├── reports/
│
├── app.py
├── detect_similarities.py
├── progress_manager.py
├── requirements.txt
├── README.md
└── LICENSE

Tech stack

  • Backend: FastAPI + Python
  • Frontend: HTML, CSS, Vanilla JavaScript
  • Similarity detection: Jaccard similarity algorithm
  • PDF handling: PyPDF2
  • CSV generation: Pandas
  • Processing: Lightweight threaded background execution

How it works (high level)

  1. User uploads a ZIP file containing student submission folders.
  2. EduCheck extracts and scans all documents recursively.
  3. Document contents are read and compared for similarities.
  4. Duplicate or highly similar files are identified.
  5. A detailed CSV report is generated and previewed in-browser.

Usage

Basic steps to run locally:

# Install dependencies
pip install -r requirements.txt
# Run the FastAPI server
python -m uvicorn app:app --host 0.0.0.0 --port 8000
# Open the interface in your browser
http://localhost:8000

Features

  • Real-time progress tracking
  • ZIP validation & upload protection
  • Pause / Resume / Cancel processing
  • Browser completion notifications
  • CSV preview before download
  • Full file path preservation
  • Lightweight and optimized architecture

Notes

  • Designed to remain lightweight without heavy frontend frameworks.
  • Optimized for structured academic submission folders.
  • Similarity results should be manually reviewed before academic decisions.

License

Licensed under the Apache License 2.0.

About

EduCheck is a tool that allows faculty to upload student ZIP submissions, automatically extract data, detect duplicate or copied files, and generate a clean CSV report instantly. It eliminates manual checking, saves time, and is ideal for bulk assignment evaluation.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors