StudeQ — AI Study Platform for Exam Prep & Smart Learning

Open source AI powered learning app for India — RAG study assistant, AI flashcards generator, smart scheduler & exam prep tool, built on a modern full stack MERN+ architecture.

Live demo: studeq.onrender.com

StudeQ dashboard screenshot — AI study platform showing flashcards, quiz, and scheduler tools Screenshot placeholder: StudeQ dashboard — AI powered study tools for exam prep

---

What is StudeQ?

StudeQ is an AI powered learning app for Indian students — a RAG driven study assistant that turns notes into AI flashcards, auto generated quizzes, and a smart study scheduler. Built for solo learners and exam aspirants who want an AI exam prep tool that actually understands their material, not generic flashcard decks.

Features

• RAG Study Assistant — Pinecone + BGE embeddings ground answers in your uploaded notes, not hallucinated generic content
• AI Flashcards Generator — auto generate spaced repetition flashcards from notes via multi LLM orchestration (Groq, NVIDIA NIM)
• AI Quiz Generator — instant practice quizzes scoped to a topic or document
• Smart Study Scheduler / Timetable — plan and track exam prep across subjects
• Real time Study Rooms — Socket.io powered collaborative sessions
• Gamification / XP System — streaks and XP hooks tied into payments and study activity
• Razorpay Payment Integration — idempotent webhook processing via BullMQ + Redis dedup
• Dark/Light Theming — responsive, mobile first UI with CSS Modules
• httpOnly Cookie Auth — secure session auth, no localStorage token leakage

Tech Stack

Layer	Technology
Frontend	React (Vite), CSS Modules
Backend	Node.js, Express
Relational DB	PostgreSQL + Prisma ORM
Document DB	MongoDB + Mongoose
Cache / Queue	Redis + BullMQ
Real-time	Socket.io
Vector Search	Pinecone + Xenova/transformers (BGE embeddings)
LLM Orchestration	Groq (Llama 3.3 70B), NVIDIA NIM
Payments	Razorpay
Hosting	Render

See ARCHITECTURE.md for the full system diagram and data flow.

Architecture

flowchart TD
    A[React/Vite Client] -->|REST + cookies| B[Express API]
    A <-->|WebSocket| C[Socket.io Study Rooms]
    B --> D[(PostgreSQL via Prisma)]
    B --> E[(MongoDB via Mongoose)]
    B --> F[Redis / BullMQ Queues]
    F --> G[Razorpay Webhook Worker]
    B --> H[Pinecone Vector DB]
    H --> I[RAG Study Assistant]
    B --> J[Groq / NVIDIA NIM LLMs]

Loading

🚀 Installation

# Clone
git clone https://github.com/kanchan-nath/["You will get the access of private repo after consulting in Discord"]
cd StudeQ
 
# Install server deps
cd server
npm install --legacy-peer-deps
 
# Install client deps
cd ../client
npm install --legacy-peer-deps

Run locally

# Terminal 1 — server
cd server
npm run dev
 
# Terminal 2 — client
cd client
npm run dev

Environment Variables

Create a .env file in server/:

Variable	Description
DATABASE_URL	Postgres connection string (Session pooler URL on Render)
MONGO_URI	MongoDB connection string
REDIS_URL	Redis/Upstash connection string
PINECONE_API_KEY	Pinecone vector store API key
GROQ_API_KEY	Groq LLM API key
NVIDIA_NIM_API_KEY	NVIDIA NIM LLM API key
RAZORPAY_KEY_ID	Razorpay key ID
RAZORPAY_KEY_SECRET	Razorpay secret
JWT_SECRET / cookie config	Auth (httpOnly cookie-based)
CLIENT_URL	Frontend origin for CORS

API Docs

See docs/API.md (coming soon) for endpoint reference.

Roadmap

• Public API docs site
• Mobile app (React Native)
• Offline flashcard mode
• Multi-language support (Hindi, regional languages)

Contributing

This is a private repository. To contribute, join our Discord first to discuss access and align with the contribution guidelines — once approved, you're welcome to contribute. See CONTRIBUTING.md for setup and codestyle once access is granted.

License

MIT — see LICENSE.