🚀 AI Uni Tutor 🎓
The AI Copilot for University Learning at Scale
AI Uni Tutor is an AI-powered academic copilot designed to help university students learn better, not cheat faster.
It combines LLM reasoning, course-specific RAG, and pedagogy-aligned tutoring modes to deliver personalized, ethical, and scalable education support.
Quick Start · Key Features · Configuration
🇨🇳 简体中文 (Chinese) · 🇺🇸 English
🧠 Specialized Tutoring Modes • 📚 Context-Aware RAG
💎 Pro Max UI/UX • ⚡ Real-time Streaming
What AI Uni Tutor Is
- A course-aware AI tutor
- A learning companion, not an answer engine
- A platform, not a single model wrapper
Who It’s For
- 🎓 University students (STEM-first, expanding later)
- 🧑🏫 Educators & teaching teams
- 🏫 Institutions exploring AI-assisted learning
💎 Key Features
🧠 Pedagogy-Aligned Tutoring Modes
Each interaction is explicitly scoped to a learning intent:
- Lecture Helper
→ Explains concepts using analogies, step-by-step reasoning, and Socratic questioning
- Assignment Coach
→ Guides thinking, debugging, and structure without revealing final answers
- Exam Prep
→ Generates exam-style questions, identifies weak spots, and simulates test conditions
🔒 Designed to reduce cheating incentives, not amplify them.
📚 Context-Aware RAG
• Course Retrieval: Upload textbooks, slides, and papers. The AI retrieves and grounds every answer in your specific course material using Supabase Vector Search.
• Citation Tracking: Responses are backed by source documents to ensure academic accuracy.
💎 "Pro Max" UI/UX
• Modern Aesthetic: Clean, glassmorphic interfaces with deep diffused shadows and unified Indigo-Violet gradients.
• Fluid Interactions: Levitating cards, magnetic buttons, and smooth layout transitions powered by Mantine v8.
🚀 Getting Started
Prerequisites
- Node.js: v18+
- Supabase Project: With
vector extension enabled.
- Google AI Studio Key: For accessing Gemini Pro model.
📦 Installation
1. Clone Repository
git clone https://github.com/yourusername/ai-uni-tutor.git
cd ai-uni-tutor
2. Install Dependencies
npm install
3. Configure Environment Variables
Create a .env.local file in the root directory:
cp .env.example .env.local
| Variable | Required | Description |
|---|
GEMINI_API_KEY | Yes | Your Google Gemini API Key |
SUPABASE_URL | Yes | Supabase Project URL |
SUPABASE_ANON_KEY | Yes | Supabase Anon Key (server-only) |
SUPABASE_SERVICE_ROLE_KEY | Yes | Supabase Service Role Key (for indexing) |
4. Run Development Server
npm run dev
Visit http://localhost:3000 to start your session.
🛠️ Tech Stack
| Component | Technology | Description |
|---|
| Framework | Next.js 16 | App Router, Server Actions, React 19 |
| UI Library | Mantine v8 | Design System, Hooks, Theming |
| Styling | Tailwind CSS | Utility-first styling with CSS Modules |
| Database | Supabase | PostgreSQL with pgvector for RAG |
| AI Model | Google Gemini | Gemini 1.5 Pro for Reasoning |
| Icons | Lucide React | Consistent, crisp iconography |
🛠️ Development
Available Scripts
| Script | Description |
|---|
npm run dev | Start development server |
npm run build | Build for production |
npm run lint | Run ESLint |
npm run lint:fix | Fix ESLint issues |
npm run format | Format code with Prettier |
npm run test | Run tests |
npm run commit | Interactive commit wizard |
Commit Convention
This project uses Conventional Commits with the following format:
<type>(<scope>): <description>
Types: feat, fix, docs, style, refactor, perf, test, chore, build, ci
Scopes: chat, rag, api, ui, auth, stripe, db, deps, config
Examples:
feat(chat): add message streaming support
fix(rag): resolve embedding dimension mismatch
chore(deps): upgrade Next.js to 16.1.4
Use npm run commit for an interactive commit wizard.
Git Hooks
This project uses Husky for automated checks:
- pre-commit: Runs ESLint and Prettier on staged files
- commit-msg: Validates commit message format
- pre-push: Runs build to catch errors before pushing
🤝 Contribution
We welcome contributions! Please see our Contributing Guide for details.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature)
- Commit your Changes (
git commit -m 'Add some AmazingFeature')
- Push to the Branch (
git push origin feature/AmazingFeature)
- Open a Pull Request
