README.md

metadata

title: Learn Geoscience Quiz Maker
emoji: 🌍
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
app_port: 7860

Learn Geoscience Quiz Maker

An intelligent quiz generator that creates personalized quizzes from PDFs, CSV files, or selected topics using the Google Gemini API. Features timed quizzes, custom scoring, and AI-powered feedback.

(Note: Consider adding a screenshot of your running application here!)

Features

• Multiple Quiz Sources: Generate quizzes from PDF documents, structured CSV files, raw text input, or by selecting from a list of topics.
• Secure API Key Handling: The app securely uses the Gemini API key from environment variables, requiring no manual user input.
• Custom Configuration: Set the number of questions, time limit, and custom scoring for correct and incorrect answers.
• Timed Quizzes: A countdown timer adds a challenging element to the quiz experience.
• AI-Powered Analysis: After the quiz, Gemini provides a detailed breakdown of your performance, identifies strengths and weaknesses, and offers actionable feedback.
• Built-in Calculator: A scientific calculator is available during the quiz for numerical questions.
• Dark/Light Mode: A sleek, modern interface with theme toggling.

Prerequisites

• A modern web browser (like Chrome, Firefox, or Edge).
• Node.js (which includes npx) for running the local development server.
• A Google Gemini API Key configured as an environment variable (API_KEY) in your deployment environment.

How to Run Locally

Follow these simple steps to run the project on your computer.

1. Get the Code

If you haven't already, clone this repository to your local machine using Git and navigate into the project directory:

git clone [https://github.com/prateekvyas1996/Learn_Geoscience_Quiz_Maker.git](https://github.com/prateekvyas1996/Learn_Geoscience_Quiz_Maker.git)
cd Learn_Geoscience_Quiz_Maker