Skip to content

Latest commit

 

History

History
69 lines (48 loc) · 2.26 KB

README.md

File metadata and controls

69 lines (48 loc) · 2.26 KB
Raw

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:

    git clone https://github.com/alihassanml/QuizGenius.git
cd QuizGenius

  2. Set up a virtual environment and activate it:

    python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

  3. Install the required dependencies:

    pip install -r requirements.txt

  4. Run the application:

    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 file for details.

Contact

For any questions or feedback, please contact alihassanbscs@gmail.com.

Feel free to customize this README further to suit your specific project details and preferences.