{"id":15063690,"url":"https://github.com/aliktk/mcq-generator","last_synced_at":"2026-02-19T00:03:18.269Z","repository":{"id":257359817,"uuid":"857833381","full_name":"Aliktk/MCQ-Generator","owner":"Aliktk","description":"The MCQ Generator web app leverages OpenAI's language models via LangChain to generate multiple-choice questions (MCQs) from uploaded PDF or text files. Users can customize settings such as the number of questions, subject, and difficulty level. The app provides real-time feedback on complexity and displays the MCQs in a clear, easy formate.","archived":false,"fork":false,"pushed_at":"2024-09-16T18:48:41.000Z","size":32,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-14T15:04:05.366Z","etag":null,"topics":["llms","mcq-test","openai-api","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Aliktk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-15T18:14:44.000Z","updated_at":"2024-09-18T21:26:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"5060bdd0-38d0-4c83-8311-427719a7fb09","html_url":"https://github.com/Aliktk/MCQ-Generator","commit_stats":null,"previous_names":["aliktk/mcq-generator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Aliktk/MCQ-Generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliktk%2FMCQ-Generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliktk%2FMCQ-Generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliktk%2FMCQ-Generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliktk%2FMCQ-Generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aliktk","download_url":"https://codeload.github.com/Aliktk/MCQ-Generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliktk%2FMCQ-Generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019294,"owners_count":26086709,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["llms","mcq-test","openai-api","streamlit"],"created_at":"2024-09-25T00:06:06.969Z","updated_at":"2025-10-14T15:07:08.560Z","avatar_url":"https://github.com/Aliktk.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **MCQ Generator: AI-Powered Multiple-Choice Question Creator**\n\n[![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue?style=for-the-badge\u0026logo=linkedin)](https://www.linkedin.com/in/ali-nawaz-khattak/)\n\n## Overview\n\nThe **MCQ Generator** is an AI-driven project that automates the generation of multiple-choice questions (MCQs) from a given text, evaluates their difficulty, and presents them through an interactive web interface. This tool combines OpenAI's language models with LangChain and Streamlit to deliver a seamless experience for creating and interacting with educational content.\n\n---\n\n## 📝 Table of Contents\n\n- [**MCQ Generator: AI-Powered Multiple-Choice Question Creator**](#mcq-generator-ai-powered-multiple-choice-question-creator)\n  - [Overview](#overview)\n  - [📝 Table of Contents](#-table-of-contents)\n  - [📁 Project Structure](#-project-structure)\n  - [✨ Features](#-features)\n  - [💻 Installation](#-installation)\n  - [🚀 Usage](#-usage)\n  - [⚙️ Configuration](#️-configuration)\n  - [📊 Data](#-data)\n  - [🔬 Experiments](#-experiments)\n  - [🙏 Acknowledgements](#-acknowledgements)\n\n---\n\n## 📁 Project Structure\n\n```bash\nMCQ-Generator/\n├── .gitignore\n├── README.md\n├── mcq_training_data.txt\n├── requirements.txt\n├── response.json\n├── setup.py\n├── streamlit.py\n├── experiments/\n│   ├── data/Machine_Learning_Quiz.csv\n│   └── mcq.ipynb\n└── src/\n    ├── __init__.py\n    └── mcqgenerator/\n        ├── MCQgenerator.py\n        ├── logger.py\n        └── utils.py\n```\n\n## ✨ Features\n\n- **MCQ Generation**: Generate MCQs from provided text using advanced natural language processing techniques.\n- **Complexity Evaluation**: Assess the complexity of the generated MCQs.\n- **Web Interface**: User-friendly web interface to interact with the MCQ generator.\n\n## 💻 Installation\n\nTo install the necessary dependencies, run the following command:\n\n```bash\npip install -r requirements.txt\n```\n\n## 🚀 Usage\n\nTo use the MCQ generator, run the `streamlit.py` script:\n\n```bash\nstreamlit run streamlit.py\n```\n\n## ⚙️ Configuration\n* Adjust project settings in `setup.py`.\n* Manage logging configurations in `src/mcqgenerator/logger.py`.\n\nYou can configure various aspects of the project in the `setup.py` file and adjust logging settings in `src/mcqgenerater/logger.py`.\n\n## 📊 Data\n* Sample training data is available in `mcq_training_data.txt`.\n* Example responses are provided in `response.json`.\n\n## 🔬 Experiments\n\nThe `experiments` directory contains a Jupyter notebook (`mcq.ipynb`) and a CSV file with machine learning quiz data (`machine_learning_quiz.csv`).\n\n## 🙏 Acknowledgements\n\nA huge thanks to the teams behind LangChain and Streamlit for providing robust tools. Special appreciation to ineuron for the project opportunity.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliktk%2Fmcq-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faliktk%2Fmcq-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliktk%2Fmcq-generator/lists"}