Spaces:
Sleeping
Sleeping
| 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](https://nodejs.org/) (which includes `npx`) for running the local development server. | |
| - A [Google Gemini API Key](https://ai.google.dev/gemini-api/docs/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: | |
| ```bash | |
| 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 |