This application allows users to upload study materials and automatically generates interactive quizzes using the Deepseek API. Built with Python (FastAPI) backend and React frontend.
- Upload study materials in various formats (txt, doc, docx, pdf)
- Automatic quiz generation using AI
- Interactive quiz interface with multiple choice questions
- Immediate feedback and scoring
- Modern and responsive UI
- Python 3.8 or higher
- Node.js 16 or higher
- Deepseek API key
-
Navigate to the backend directory:
cd backend -
Create a virtual environment and activate it:
python -m venv venv .\venv\Scripts\activate # Windows source venv/bin/activate # Linux/Mac
-
Install dependencies:
pip install -r requirements.txt
-
Create a
.envfile in the backend directory and add your Deepseek API key:DEEPSEEK_API_KEY=your_api_key_here -
Start the backend server:
uvicorn main:app --reload
-
Navigate to the frontend directory:
cd front 6618 end -
Install dependencies:
npm install
-
Start the development server:
npm run dev
- Open your browser and navigate to
http://localhost:5173 - Upload your study material using the drag-and-drop interface
- Click "Generate Quiz" to create a quiz based on your material
- Answer the questions and get immediate feedback
- View your final score and start a new quiz if desired
-
Backend:
- FastAPI
- Python
- Deepseek API
-
Frontend:
- React
- TypeScript
- Chakra UI
- Vite
Make sure to keep your Deepseek API key secure and never commit it to version control.