{"id":22127940,"url":"https://github.com/dmunasingha/questions-generator","last_synced_at":"2025-03-24T08:34:51.527Z","repository":{"id":259267728,"uuid":"877445610","full_name":"dmunasingha/Questions-Generator","owner":"dmunasingha","description":"An advanced, human-like question generation system built from scratch. This project dynamically learns from your input notes and data, mimicking human intelligence to generate insightful questions, fully personalized to the text you provide. No templates, just pure learning and reasoning! 🌟","archived":false,"fork":false,"pushed_at":"2024-10-23T17:39:13.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-24T00:58:56.079Z","etag":null,"topics":["human-like-ai","nlp","python","question-generator"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dmunasingha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-23T16:58:14.000Z","updated_at":"2024-10-23T17:39:17.000Z","dependencies_parsed_at":"2024-10-24T01:30:14.639Z","dependency_job_id":"8edd6188-7b3d-41d4-9630-a68899306960","html_url":"https://github.com/dmunasingha/Questions-Generator","commit_stats":null,"previous_names":["dmunasingha/questions-generator"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmunasingha%2FQuestions-Generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmunasingha%2FQuestions-Generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmunasingha%2FQuestions-Generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmunasingha%2FQuestions-Generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dmunasingha","download_url":"https://codeload.github.com/dmunasingha/Questions-Generator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245235682,"owners_count":20582287,"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","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":["human-like-ai","nlp","python","question-generator"],"created_at":"2024-12-01T17:22:38.435Z","updated_at":"2025-03-24T08:34:51.497Z","avatar_url":"https://github.com/dmunasingha.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Advanced Question Generation AI\n\n![Python](https://img.shields.io/badge/Python-3.12-blue.svg)\n![spaCy](https://img.shields.io/badge/spaCy-3.6-green.svg)\n![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)\n![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)\n![Status](https://img.shields.io/badge/status-in_progress-yellow.svg)\n\nAn advanced, human-like question generation system built from scratch. This project dynamically learns from your input notes and data, mimicking human intelligence to generate insightful questions, fully personalized to the text you provide. No templates, just pure learning and reasoning! 🌟\n\n---\n\n## 💡 Features\n\n- **Human-like Question Generation**: Understands the text you input, and formulates questions dynamically.\n- **Advanced NLP**: Uses state-of-the-art Natural Language Processing techniques for parsing and understanding text.\n- **Fully Customizable Model**: Train the system on your own data, making it adaptable to specific topics and contexts.\n- **No Templates**: No predefined rules for questions – it learns and thinks just like a human would!\n\n---\n\n## 🛠️ Technologies \u0026 Libraries\n\n- **Python 3.12.x**: Core programming language.\n- **spaCy**: NLP library for text processing, tokenization, and dependency parsing.\n- **scikit-learn**: For machine learning components.\n- **Flask** : For building a simple web-based interface.\n- **NumPy**: For data manipulation.\n  \n---\n\n## 📦 Installation\n\n### 1. Clone the Repository\n```bash\ngit clone https://github.com/dmunasingha/Questions-Generator.git\ncd Questions-Generator\n```\n\n### 2. Set Up the Environment\n\nInstall the required libraries from the `requirements.txt` file.\n\n```bash\npip install -r requirements.txt\n```\n\n### 3. Install spaCy Model\nAfter installing `spaCy`, download the required language model:\n```bash\npython -m spacy download en_core_web_sm\n```\n### 4. Copy .env file\nAfter installing the `spaCy Model`, copy the `.env.example` into `.env`:\n\nFor Windows\n```bash\ncopy .env.example .env\n```\nFor Unix-like systems (Linux or macOS)\n```\ncp .env.example .env\n```\n\n---\n\n## ⚙️ Usage\n\n1. **Command Line Interface (CLI)**:\n   - Run the main script to input your notes and generate questions:\n\n     ```bash\n     python index.py\n     ```\n\n   - The system will prompt you to input your notes, and then it will generate a set of human-like questions based on your input.\n\n2. **Web App (Flask)**:\n   - Start the Flask server:\n\n     ```bash\n     python app.py\n     ```\n\n   - Navigate to ```http://localhost:5000``` in your browser to access the web-based interface for inputting notes and viewing generated questions.\n---\n\n## 🌟 Example\n\n### Input:\n```\nTechnology plays a transformative role in education by enhancing learning experiences and providing access to resources. Online platforms and educational apps allow for personalized learning.\n```\n\n### Generated Questions:\n```\n1. What is the transformative role of technology in education?\n2. How do online platforms enhance personalized learning?\n3. Why is it important to have access to educational resources?\n```\n\n---\n\n## 🛠️ Development\n\n### Requirements\n- Python 3.12+\n- pip (for package management)\n- spaCy NLP Model (`en_core_web_sm`)\n\n### File Structure\nPlanned File structure to be implemented in the future with a model\n```\n📦 question-generation\n ┣ 📂 data\n ┃ ┣ 📜 dataset.json\n ┣ 📂 controllers\n ┃ ┣ 📜 home_controller.py\n ┃ ┣ 📜 about_controller.py\n ┣ 📂 models\n ┃ ┣ 📜 question_generator.py\n ┣ 📂 static\n ┃ ┣ 📂 js\n ┃ ┣ ┣ 📜 formValidator.js\n ┃ ┣ ┣ 📜 home.js\n ┃ ┣ 📂 css\n ┃ ┣ ┣ 📜 style.css\n ┣ 📂 templates\n ┃ ┣ 📜 about.html\n ┃ ┣ 📜 base.html\n ┃ ┣ 📜 index.html\n ┣ 📜 app.py          # Flask app\n ┣ 📜 index.py        # Main CLI entry point\n ┣ 📜 requirements.txt\n ┣ 📜 README.md\n ┣ 📜 SECURITY.md\n```\n\n---\n\n## 💻 Contributing\n\nContributions are welcome! If you'd like to contribute, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature/new-feature`).\n3. Commit your changes (`git commit -m 'Add some new feature'`).\n4. Push to the branch (`git push origin feature/new-feature`).\n5. Open a pull request.\n\n---\n\n## ⚖️ License\n\nThis project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🎯 Future Goals\n\n- Implement deeper learning capabilities for improved question generation.\n- Allow for training on larger datasets for domain-specific question generation.\n- Add more sophisticated web UI with a question editor.\n\n---\n\n## 👥 Contributors\n\n- **Dunith Munasingha** - *Lead Developer* 💻  \n  Reach me at [munasingha.dunith@gmail.com](mailto:munasingha.dunith@gmail.com)\n\n---\n\n## 🙌 Acknowledgements\n\nSpecial thanks to the developers of spaCy and scikit-learn for their amazing libraries.\n\n---\n\n\u003e **Disclaimer**: This project is for educational purposes and is constantly evolving. Feel free to explore, contribute, and adapt it to your ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmunasingha%2Fquestions-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdmunasingha%2Fquestions-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmunasingha%2Fquestions-generator/lists"}