AI Quiz Generator Web Application by Raunak WeteAI Quiz Generator Web Application by Raunak Wete

AI Quiz Generator Web Application

Raunak Wete

Completed work

AI Engineer

Web Developer

FastAPI

Python

React

Education

🚀 AI Quiz Generator: Turn PDFs into Interactive Quizzes! 🤖📚

Welcome to the AI Quiz Generator project, where learning meets innovation! This web application takes PDF documents and turns them into interactive multiple-choice quizzes. Test your knowledge on any topic with ease and get instant feedback on your score!

🌟 Star this repo if you like it and follow for more cool projects!

✨ Features

AI-Powered Quiz Generation: Upload a PDF, select a topic, and let the AI generate relevant quiz questions in seconds.

Interactive UI: Answer questions, get instant feedback, and track your progress.

Score Tracker: Get your final score after completing the quiz.

Built with FastAPI (Backend) & React (Frontend): A sleek combination of modern technologies.

TailwindCSS: Beautiful and responsive UI to ensure a smooth user experience.

🔧 Technologies Used

Backend:

FastAPI: For serving APIs that manage PDF uploads and question generation.

Frontend:

React.js: For building a responsive and user-friendly quiz-taking interface.

TailwindCSS: For a modern, customizable UI design.

AI:

AI Model for Quiz Generation: Automatically generates MCQs based on topics in a PDF file.

Database: No database required for this project—everything is processed in real-time.

🚀 How It Works

Upload Your PDF: Simply upload a PDF document containing the information you want to quiz on.

Select a Topic: Enter a topic (e.g., "IoT", "Machine Learning", etc.) to focus your quiz.

Start Quiz: The app generates relevant multiple-choice questions based on your document.

Answer Questions: As you progress through the quiz, answer the questions and see instant feedback on your answers.

Get Your Score: At the end of the quiz, see your final score and review your answers.

📂 Project Setup

🛠️ Backend (FastAPI)

Clone this repository:

git clone https://github.com/raunakwete43/quizcrafter.git
cd quizcrafter

Install dependencies:

pip install -r backend/requirements.txt

Start the FastAPI server:

cd backend
uvicorn main:app --reload

The backend will be running at http://localhost:8000.

💻 Frontend (React)

Navigate to the frontend directory:

cd frontend

Install dependencies:

npm install

Start the Vite(React) development server:

npm run dev

The frontend will be running at http://localhost:3000.

📄 How to Use

Upload PDF: Go to the homepage and click on the "Upload PDF" button.

Enter a Topic: After uploading, type a topic (e.g., "Machine Learning") into the provided field.

Start the Quiz: Click "Start Quiz" and wait for the quiz to load.

Answer Questions: Choose your answers and move between questions using the "Back" and "Next" buttons.

Submit: Click "Submit" to see your final score.

💡 Why Use This Project?

Effortless Learning: Automatically convert any PDF into a quiz with a single click.

Fast and Efficient: The AI quickly generates multiple-choice questions, saving you time.

Perfect for Students & Educators: Turn any document into an interactive learning tool.

Beautiful UI: The app’s UI is built with React and TailwindCSS, ensuring a smooth and delightful experience.

🎯 Contributing

We welcome contributions to make this project better! If you’d like to contribute, follow these steps:

Fork the repo.

Clone your fork: git clone https://github.com/raunakwete43/quizcrafter

Make your changes and create a pull request with a detailed description of your contribution.

⚠️ NOTE

If you are hosting the backend and frontend separately or on different domains, ensure the frontend API requests point to the correct backend URL (for example, replace http://localhost:8000 with your hosted backend URL). This is important to ensure proper communication between the two components.