AI-powered academic learning platform for engineering students
Hyper Learning Tech bridges the gap between static academic resources and intelligent learning experiences. Instead of handing students a pile of PDFs and past papers, it connects syllabus β notes β previous year questions β AI tutoring into a single cohesive workflow.
Built specifically for RGPV engineering students, it covers:
- Semester-wise previous year question papers (PYQs) with branch and subject filtering
- AI-generated topic-level notes on demand, cached for instant reuse
- Structured answers for 2-mark, 5-mark, and 10-mark examination questions
- An AI tutor that retains session context for follow-up questions
- Student productivity tools: bookmarks, progress tracking, and a personalized dashboard
- A role-gated admin system for editors and platform owners
π Academic Content Management
- Subject-wise syllabus organization
- Unit-wise topic breakdown
- Topic-specific AI-generated notes (Gemini, cached in PostgreSQL)
- Version-controlled content updates
- Related PYQ mapping per topic
π Previous Year Questions (PYQs)
- Semester-wise and branch-wise paper collection
- Subject-wise filtering and question-to-unit mapping
- Fast retrieval backed by Redis caching
π€ AI-Powered Learning
AI Answer Generation β structured answers for 2, 5, 10-mark, and long-answer exam questions, with Redis caching so repeat requests are instant.
AI Learning Notes β on-demand notes for individual topics, units, or entire subjects, persisted to PostgreSQL after first generation.
AI Tutor β a conversational interface with Redis-backed session context so students can ask follow-up questions, request examples, and simplify difficult concepts without losing thread.
π Student Productivity
- Bookmarks and saved content
- Learning progress tracking
- Recently viewed topics
- Personalized dashboard
οΏ½οΏ½βπΌ Administration System
| Role | Capabilities |
|---|---|
| Student | Learn, bookmark, track progress, use AI tutor |
| Editor | Upload papers, edit content, generate notes, manage resources |
| Owner | Manage editors, approve applications, review audit logs, configure platform |
- Invitation-only editor accounts
- Owner approval workflow
- Full audit logging with login notifications
π Search
Full-text search across subjects, units, topics, notes, and PYQs in a single query.
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| Language | TypeScript 5.9 |
| Styling | Tailwind CSS v4, ShadCN/UI, Framer Motion |
| Auth | Clerk (RBAC, MFA, protected routes) |
| Database | PostgreSQL via Neon, Prisma ORM 7 |
| Cache | Redis via Upstash |
| AI | Google Gemini (@google/genai) |
| Resend | |
| Storage | Cloudinary |
| Monitoring | Sentry |
| Analytics | PostHog |
| Deployment | Vercel |
| Math Rendering | KaTeX + react-katex |
| PDF Export | html2pdf.js |
Browser (Student / Editor / Owner)
β
βΌ
Next.js 16 (App Router)
Server Components + API Routes
β
ββββββββΌβββββββββββ
β β β
βΌ βΌ βΌ
PostgreSQL Redis Google
(Neon) (Upstash) Gemini
β β
βΌ βΌ
Topics AI Answers
Notes Chat Sessions
PYQs Rate Limits
Users Context Cache
Student submits question
β
βΌ
Redis Lookup
β
ββββββ΄βββββ
Cache Hit Cache Miss
β β
βΌ βΌ
Return Gemini API
Answer β
Save to Redis
β
Return Answer
Student opens topic
β
βΌ
PostgreSQL Lookup
β
ββββββ΄βββββ
Exists Missing
β β
βΌ βΌ
Return Gemini API
Note β
Save to PostgreSQL
β
Return Note
HyperLearningTech/
βββ app/ # Next.js App Router pages and API routes
βββ components/ # Shared UI components
βββ features/
β βββ landing/ # Landing page feature module
βββ content/
β βββ rgpv/ # RGPV syllabus and paper content
βββ data/ # Static data and seed files
βββ hooks/ # Custom React hooks
βββ lib/ # Prisma client, Redis client, Gemini client, utilities
βββ prisma/ # Schema and migrations
βββ public/ # Static assets
βββ types/ # Global TypeScript types
βββ constants/ # App-wide constants
βββ .github/ # Issue templates and CI workflows
βββ proxy.ts # Edge middleware / route protection
βββ next.config.ts
βββ package.json
- Node.js 20+
- PostgreSQL database (Neon recommended)
- Upstash Redis instance
- Clerk account
- Google AI API key (Gemini)
# 1. Clone the repository
git clone https://github.com/imuniqueshiv/HyperLearningTech.git
cd HyperLearningTech
# 2. Install dependencies
npm install
# 3. Set up environment variables
cp .env.example .env
# Fill in all values in .env (see section below)
# 4. Set up the database
npx prisma migrate dev
# 5. Start the development server
npm run devOpen http://localhost:3000.
Copy .env.example to .env and fill in the following:
# ββ Database ββββββββββββββββββββββββββββββββββββββββββ
DATABASE_URL=
# ββ Upstash Redis βββββββββββββββββββββββββββββββββββββ
UPSTASH_REDIS_REST_URL=
UPSTASH_REDIS_REST_TOKEN=
# ββ Google Gemini βββββββββββββββββββββββββββββββββββββ
GEMINI_KEY_1=
GEMINI_WORKSPACE_KEY_1=
# ββ Clerk Authentication ββββββββββββββββββββββββββββββ
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
# ββ Email (Resend) ββββββββββββββββββββββββββββββββββββ
RESEND_API_KEY=
# ββ Analytics (PostHog) βββββββββββββββββββββββββββββββ
NEXT_PUBLIC_POSTHOG_KEY=
NEXT_PUBLIC_POSTHOG_HOST=
# ββ Error Monitoring (Sentry) βββββββββββββββββββββββββ
NEXT_PUBLIC_SENTRY_DSN=
SENTRY_AUTH_TOKEN=Note: The platform currently supports up to 4 Gemini API keys for load distribution. Add them as
GEMINI_KEY_2,GEMINI_KEY_3, etc.
npm run dev # Start development server
npm run build # Production build
npm run start # Start production server
npm run typecheck # TypeScript type checking
npm run lint # ESLint
npm run format # Prettier (write)
npm run format:check # Prettier (check only)| Phase | Focus | Status |
|---|---|---|
| Phase 1 | Next.js migration, PostgreSQL, Prisma, Clerk auth | β Complete |
| Phase 2 | Topic-based learning, AI note generation, versioning, search | π In Progress |
| Phase 3 | AI Tutor, progress tracking, bookmarks, personalized dashboard | π Planned |
| Phase 4 | Admin dashboard, paper upload pipeline, OCR, content moderation | π Planned |
| Phase 5 | Advanced analytics, recommendation engine, multi-university support, mobile app | π Planned |
See CHANGELOG.md for detailed release notes.
Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.
# Quick contribution workflow
git fork https://github.com/imuniqueshiv/HyperLearningTech
git checkout -b feat/your-feature-name
git commit -m "feat: describe your change"
git push origin feat/your-feature-name
# Open a Pull Request on GitHubAreas where contributions are especially valuable: UI/UX improvements, accessibility, performance optimization, documentation, and test coverage.
Please also review our Code of Conduct and Security Policy.
This project is licensed under the Apache License 2.0. See the LICENSE file for full details.
|
Shiv Raj Singh Founder & Lead Full Stack Developer LinkedIn Β· GitHub |
Nitin Pandey UI/UX Designer LinkedIn Β· GitHub |
Ramoo Kachhee Frontend Developer LinkedIn Β· GitHub |
If this project helps you, please β star the repository β it helps others find it.