ScoreLine AI is an AI-powered academic evaluation platform designed to assist teachers in efficiently analyzing student answer sheets. By leveraging OCR and AI algorithms, the system compares student responses with the correct answer key and generates insights on performance, strengths, and improvement areas. The application also supports real-time student-counselor interactions for personalized guidance.
- 🧾 Upload Answer Sheets: Teachers can upload student answer sheets and associated question papers.
- 📊 AI-Based Evaluation: The backend uses OCR and intelligent matching to evaluate student answers.
- 📃 Answer Key Integration: Teachers can upload correct answers to be used for automated scoring.
- 🧠 Chatbot Interface: Students can chat with an AI-powered mental wellness bot.
- 👩🏫 Live Counselor Chat: Students can interact with human counselors through real-time WebSocket-based messaging.
- 📈 Performance Reports: Automatically generated mental wellness and academic performance reports in PDF format.
- 🔐 Role-Based Access: Secure authentication system with separate dashboards for Teachers and Students.
| Layer | Technology |
|---|---|
| Frontend | React (Vite), JavaScript, Tailwind CSS |
| Backend | FastAPI, Python |
| Database | MongoDB |
| AI / OCR | Gemini API, ReportLab, Tesseract OCR |
| Chat | WebSocket (Socket.io), MongoDB |
| Auth | JWT, Google OAuth |
| Storage | Local/FileSystem (can switch to S3) |
- Python 3.9+
- Node.js v16+
- MongoDB running locally or on Atlas
- pip / npm
# Clone the repository
git clone https://github.com/your-username/scoreline-ai.git
cd scoreline-ai/backend
# Create virtual environment
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Run the server
uvicorn main:app --reload
## 🖼️ Application Screenshots
> All screenshots are located in the `pictures/` folder.
### 🏠 Home Page
### ℹ️ About Page
### 👤 Profile Page
### ⚙️ Evaluation in Progress
### 📈 Performance Report
