Skip to content

Gaurav-Wankhede/Heroic-PDF-Quiz-Generator-

Repository files navigation

🚀 Heroic PDF Quiz Generator

Transform any PDF into an engaging quiz experience! This innovative application harnesses the power of Google's Gemini 2.0 AI to create intelligent, contextual questions from your PDF content.

✨ Features

  • 🤖 Powered by Google's Gemini 2.0 Flash Experiment AI
  • 📝 Generates 10 thoughtful multiple-choice questions
  • 🎯 Instant scoring and performance feedback
  • 📊 Detailed quiz review with correct answers
  • 🎨 Beautiful, modern UI with dark mode support
  • ⚡ Real-time question generation with progress tracking

🛠️ Tech Stack

  • Next.js 15 with App Router
  • Vercel AI SDK
  • Google Gemini 2.0 AI
  • TypeScript
  • Tailwind CSS
  • Shadcn UI Components
  • Framer Motion for animations
  • Aceternity UI Components

🚀 Getting Started

  1. Clone the repository
  2. Install dependencies:
npm install
  1. Set up your environment variables:
    • Create a .env file in the root directory
    • Add your Google Generative AI API key:
GOOGLE_GENERATIVE_AI_API_KEY=your_api_key_here
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser

🎯 How It Works

  1. Upload any PDF file
  2. The application analyzes the content using Gemini 2.0 AI
  3. Generates 10 contextual multiple-choice questions
  4. Take the quiz and get instant feedback
  5. Review your performance with detailed explanations

🤝 Connect with the Developer

GitHub Portfolio LinkedIn

📝 License

This project is open source and available under the MIT License.


Made with ❤️ by Gaurav Wankhede