https://github.com/alihassanml/quizgenius
QuizGenius is an interactive Multiple Choice Questions (MCQ) application powered by LangChain, Streamlit, and Gemini. It allows users to generate and answer MCQs on various topics, providing immediate feedback and performance rewards.
https://github.com/alihassanml/quizgenius
Last synced: 8 months ago
JSON representation
QuizGenius is an interactive Multiple Choice Questions (MCQ) application powered by LangChain, Streamlit, and Gemini. It allows users to generate and answer MCQs on various topics, providing immediate feedback and performance rewards.
- Host: GitHub
- URL: https://github.com/alihassanml/quizgenius
- Owner: alihassanml
- License: mit
- Created: 2024-06-28T07:22:40.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-28T16:02:46.000Z (over 1 year ago)
- Last Synced: 2025-01-01T15:11:48.694Z (10 months ago)
- Language: Python
- Size: 10.7 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Langchian Gemini QuizGenius Application
QuizGenius is an interactive Multiple Choice Questions (MCQ) application powered by LangChain, Streamlit, and Gemini. It allows users to generate and answer MCQs on various topics, providing immediate feedback and performance rewards.
## Features
- **Dynamic MCQ Generation**: Generate MCQs based on any topic entered by the user.
- **Difficulty Levels**: Choose from basic, intermediate, and advanced levels.
- **Customizable Quiz Length**: Select the number of MCQs to be included in the quiz.
- **Real-time Feedback**: Submit answers and receive instant feedback on correctness.
- **Performance Evaluation**: Get your results in percentage form and earn rewards based on performance.
## Installation
To install and run QuizGenius, follow these steps:
1. Clone the repository:
```bash
git clone https://github.com/alihassanml/QuizGenius.git
cd QuizGenius
```
2. Set up a virtual environment and activate it:
```bash
python -m venv venv
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
```
3. Install the required dependencies:
```bash
pip install -r requirements.txt
```
4. Run the application:
```bash
streamlit run app.py
```
## Usage
1. Open the application in your browser.
2. Enter a topic for which you want to generate MCQs.
3. Select the difficulty level (basic, intermediate, advanced).
4. Choose the number of MCQs to generate.
5. Answer the questions and submit your answers.
6. View your results and see the percentage of correct answers.
7. Earn rewards based on your performance.
## Technologies Used
- **LangChain**: For generating dynamic MCQs based on user input.
- **Streamlit**: For building the interactive user interface.
- **Gemini**: For additional processing and functionality enhancements.
## Contributing
Contributions are welcome! If you have suggestions for improvements or find any issues, please open an issue or submit a pull request.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Contact
For any questions or feedback, please contact [alihassanbscs@gmail.com](mailto:alihassanbscs@gmail.com).
---
Feel free to customize this README further to suit your specific project details and preferences.