Skip to content

Anooshakhalid/DeepSeek-Learning-Model--Project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

62 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SciGradex

AI‑Powered Physics, Statics & Dynamics Answer Evaluator

Python
Flask
SQLite
AI Powered

SciGradex is a web-based application for teachers to evaluate physics/statics/dynamics answers using AI. It doesn’t just give scores – it provides feedback and suggests correct solutions, making checking more effective.


Model Details

  • Base Model: LLaMA 3 (accessed via Groq API)
  • Type: Large Language Model (LLM) optimized for reasoning and context‑aware responses.

Key Qualities

  • High Reasoning Ability – Performs well on problem‑solving and evaluation tasks.
  • Structured Output – Generates scored assessments & feedback in a consistent, easy‑to‑read format.
  • Math & Symbol Support – Handles LaTeX‑style math, physics symbols, and technical content effectively.
  • Prompt Adaptability – Easily guided using pre‑defined prompt templates for specialized grading tasks.
  • Efficient & Fast – Leveraging Groq’s low‑latency infrastructure for near real‑time evaluation.

Parameters & Access

  • Available sizes: 8B & 70B parameters (we used Groq‑hosted 8B for faster inference).
  • Weights: Open‑weight (by Meta), but API access via Groq is paid (with a free trial tier).

Why Groq?

  • Ultra‑low latency inference – ideal for real‑time evaluation.
  • Scalable & reliable API for consistent model responses.


Features

  • AI-Powered Evaluation – Get a score (0–10), feedback, and a correct answer suggestion.
  • Math-Aware – Supports complex formulas, summations (Σ), fractions, symbols (λ, μ, etc.) with MathJax rendering.
  • Evaluation History – Search & filter past evaluations.
  • Secure Authentication – User registration & login with hashed passwords.
  • Modern UI – Clean, responsive design with color-coded scores & interactive controls.

Workflow

  • chunks.pkl – Pickled (binary) version of pre-processed prompt chunks for faster loading in production.
  • chunks.json – Stores prompt templates used to communicate with Groq API for consistent evaluation.
  • index.fiass – Vector index (FAISS) for storing & retrieving embeddings, allowing similarity-based search for past questions or prompts.
  • preprocess.py – Cleans and normalizes raw input (removes extra spaces, converts special characters, prepares equations for MathJax rendering).
  • app.py – Flask backend, handles routes (/submit-question, /get-history), connects with the database & AI engine.
  • scripts/preprocess.py

Step-by-Step:

  1. Input: Teacher submits a question & student answer (manually).
  2. Processing:
    • Text is fed into Groq API with a carefully designed prompt.
  3. AI Evaluation:
    • Model generates score, feedback, and correct solution suggestion.
  4. Database Storage: Results are stored in queries table for later retrieval.
  5. Frontend Display: Results are rendered with MathJax for proper equation formatting.

Tech Stack

  • Frontend: HTML5, CSS3, JavaScript, Font Awesome, MathJax
  • Backend: Python (Flask)
  • Database: SQLite3
  • AI Engine: Groq API

Screenshots

(Store these inside an assets/ folder)

Working Flow

Login & Signup

Home – Submit Evaluation

Past Evaluations


Demo Video

Watch the Demo
(Click to view full workflow: Login → Evaluate Answers → View History)


Tech Stack

  • Frontend: HTML5, CSS3, JavaScript, Font Awesome, MathJax
  • Backend: Python (Flask)
  • Database: SQLite3
  • AI Engine: Groq API

Installation

  1. Clone the repository:
    git clone https://github.com/Anooshakhalid/DeepSeek-Learning-Model--Project.git
    cd DeepSeek-Learning-Model--Project
    
    

License

This project is licensed under the MIT License – feel free to use, modify, and distribute with attribution.


Contact

About

This is the project we developed on the same problem during our internship at AnsyTech, built simultaneously with another version that included more advanced features. While this version is intentionally simpler and more streamlined, it effectively demonstrates the core concept of AI‑driven academic evaluation.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors