AI-powered study assistant that transforms your notes, PDFs, and links into quizzes, flashcards, and concise summaries for fast, focused learning.

---

---

✨ Features

• 🧠 Generate quizzes and flashcards from uploaded files or pasted text for efficient retrieval practice.
• 📚 Summarize long readings into structured study guides and key points.
• ⚡ Modern, responsive UI with instant global performance via Vercel.
• 🔐 Optional authentication, payments, and database support for SaaS-style plans and limits.

---

🚀 Live Demo

👉 https://study-genie-nine.vercel.app/

---

🧰 Tech Stack

Area	Stack
Frontend	Next.js + React
Backend	Next.js API Routes (Serverless)
AI	AI SDK (OpenAI / Anthropic / Cohere / Gemini)
Database	PostgreSQL / Neon
Auth (Optional)	Auth.js / Clerk
Payments (Optional)	Stripe
Hosting	Vercel

---

🧭 Prerequisites

• Node.js 18+
• npm or pnpm
• API Keys (OpenAI, Gemini, etc.)

---

⚙️ Installation

# Clone the repository
git clone https://github.com/<username>/study-genie.git

# Enter the project directory
cd study-genie

# Install dependencies
npm install

🧩 Environment Setup

Create a .env.local file in the root directory and add:
NEXT_PUBLIC_APP_URL=https://study-genie-nine.vercel.app

# AI Provider Keys
OPENAI_API_KEY=sk-...
# or
GEMINI_API_KEY=...

# Optional: Authentication (Clerk)
CLERK_API_KEY=...
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=...

# Optional: Payments (Stripe)
STRIPE_SECRET_KEY=...
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=...

# Optional: Database (PostgreSQL / Neon)
DATABASE_URL=postgres://...

🧠 Run Locally
 # Start development server
npm run dev
# Open in browser
# http://localhost:3000
🏗️ Build & Start Production
npm run build
npm start
🗂️ Project Structure
study-genie/
├── app/ or pages/          # Next.js routes and SSR handlers
├── pages/api/              # AI generation, uploads, webhooks
├── components/             # Uploader, cards, quiz, layout
├── lib/                    # AI adapters, DB clients, utilities
├── public/                 # Static assets and screenshots
└── .env.local              # Environment variables
🧩 Configuration

AI Providers: Easily switch between models (OpenAI, Gemini, Anthropic) via environment variables.

Limits: Control token length or features per plan.

Env Hygiene: Keep sensitive values server-only (avoid NEXT_PUBLIC_ for secrets).

📦 Deployment

Import repo into Vercel
.

Add environment variables in Project Settings → Environment Variables.

Build command:

npm run build