📚 Autograde

     

🔗 Visit the full application here:
https://autograde-teacher.vercel.app/

---

AI-Powered Descriptive Answer Sheet Grading
Automate handwritten answer sheet checking with Meta-LLaMA.
Save hours of manual work and boost grading accuracy.

🌟 Features That Transform Teacher Workflows

📤	Answer Sheet Upload Upload student PDFs and answer keys easily
🧠	Intelligent OCR & Evaluation Auto digitize handwriting and compare with answer keys using LLMs
✅	Teacher Review & Override Manually check, edit, or approve final scores
📊	Dynamic Reports & Exports Download question-wise Excel reports instantly
📈	Real-Time Processing Insights Monitor progress and evaluation status live

---

🛠️ Tech Stack

Category	Technology	Purpose
Framework	Next.js 14	Full-stack React framework
Backend	Node.js 20+	Server-side APIs & processing
LLM	🧠 Meta-LLaMA 3.2 Vision, 3.3 Instruct	Handwriting recognition & semantic answer evaluation
Styling	Tailwind CSS, shadcn/ui	Modern responsive UI
Database	PostgreSQL (Neon Serverless)	Store results & users
ORM	Drizzle ORM	Type-safe DB queries
Caching	Upstash Redis	Cache uploaded Answer keys for fast reuse
Storage	Cloudinary	Store scanned answer sheets & keys securely
Hosting	Vercel, 🚉 Railway, ☁️ Koyeb, 🚀 Render	Deploy frontend & backend
DevOps	Docker,GitHub Actions	CI/CD pipeline & containerization

---

📸 Project Screenshots

🏠 Home Page

---

📤 Answer Sheet Upload & Processing

---

📊 Reports & Analytics

---

🚀 Quick Start Guide

1. Clone & Setup

git clone https://github.com/alantomanu/Autograde.git
cd Autograde
npm install

2. Configure Environment

Create .env.local and add:

#Cloudinary (for storing answer sheet images)
NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=your_cloud_name
NEXT_PUBLIC_CLOUDINARY_API_KEY=your_api_key
NEXT_PUBLIC_CLOUDINARY_API_SECRET=your_api_secret
NEXT_PUBLIC_CLOUDINARY_URL=cloudinary://your_api_key:your_api_secret@your_cloud_name

#Google OAuth (for teacher login)
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret

#NextAuth (for secure authentication)
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your_secure_nextauth_secret

#Neon Serverless PostgreSQL (for storing user & results data)
DATABASE_URL="postgresql://your_db_user:your_db_password@your_neon_host/your_db_name?sslmode=require"

#Upstash Redis (for caching answer keys & sessions)
UPSTASH_REDIS_REST_URL=https://your_upstash_url
UPSTASH_REDIS_REST_TOKEN=your_upstash_token

#API Base URL (for connecting frontend to backend services)
NEXT_PUBLIC_API_BASE_URL=https://autograde-server.koyeb.app
# 👉 Server code: https://github.com/alantomanu/autograde-server.git

3. Run Development Server

npm run dev

Visit http://localhost:3000 to get started.

---

🤝 Contribute to AutoGrade

We welcome contributions! Here’s how you can help:

1. 🐞 Report Bugs — Open an issue with clear steps
2. ✨ Suggest Features — Share ideas to make it better
3. 🔥 Submit Pull Requests — Fork, make changes, and PR!

---

📬 Contact

Questions or ideas? Reach out anytime: 📧 alantomanu501@gmail.com

---

_{Built with ❤️ by the AutoGrade Team | © 2025 AutoGrade}