{"id":22619199,"url":"https://github.com/ymorsi7/quranicsentiment","last_synced_at":"2025-10-13T01:48:29.967Z","repository":{"id":266184630,"uuid":"897638194","full_name":"ymorsi7/QuranicSentiment","owner":"ymorsi7","description":"Web app that provides relevant Quranic verses based on emotional states, combining sentiment analysis with spiritual guidance.","archived":false,"fork":false,"pushed_at":"2025-01-01T12:08:29.000Z","size":4721,"stargazers_count":1,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-13T01:48:29.538Z","etag":null,"topics":["data-science","islam","islamic","nlp","quran","sentiment-analysis","sentimentanalysis"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ymorsi7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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-12-03T01:15:13.000Z","updated_at":"2025-06-09T11:33:49.000Z","dependencies_parsed_at":"2025-02-03T11:50:43.988Z","dependency_job_id":null,"html_url":"https://github.com/ymorsi7/QuranicSentiment","commit_stats":null,"previous_names":["ymorsi7/quranicsentiment"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ymorsi7/QuranicSentiment","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ymorsi7%2FQuranicSentiment","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ymorsi7%2FQuranicSentiment/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ymorsi7%2FQuranicSentiment/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ymorsi7%2FQuranicSentiment/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ymorsi7","download_url":"https://codeload.github.com/ymorsi7/QuranicSentiment/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ymorsi7%2FQuranicSentiment/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279013906,"owners_count":26085326,"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-12T02:00:06.719Z","response_time":53,"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":["data-science","islam","islamic","nlp","quran","sentiment-analysis","sentimentanalysis"],"created_at":"2024-12-08T21:14:28.545Z","updated_at":"2025-10-13T01:48:29.944Z","avatar_url":"https://github.com/ymorsi7.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QuranicSentiment 🕌 ✨\n\nAn intelligent web application that provides relevant Quranic verses based on emotional states, combining sentiment analysis with spiritual guidance.\n\n🌐 **Live Site**: [https://ymorsi7.github.io/QuranicSentiment/](https://ymorsi7.github.io/QuranicSentiment/)\n\n**NOTE: This is NOT a ChatGPT wrapper 😂**\n\n![QuranicSentiment Interface](docs/page.png)\n\n## Features 🌟\n\n- **Emotion Detection** 🎭\n  - Real-time analysis of user-inputted emotions\n  - Support for both direct emotion selection and free-text input\n  - Advanced sentiment analysis using VADER and TextBlob\n  - Six primary emotional categories: Joyful, Peaceful, Fearful, Angry, Remorseful, and Reflective\n\n- **Verse Matching** 📖\n  - Intelligent matching of emotional states to relevant Quranic verses\n  - Context-aware verse selection using both sentiment and linguistic analysis\n  - Support for both exact and thematic emotional matches\n  - Related verses suggestions based on content similarity\n\n- **User Interface** 💫\n  - Clean, modern, and responsive design\n  - Intuitive emotion selection buttons\n  - Smooth animations and transitions\n  - Beautiful neumorphic styling\n\n## Technical Stack 🛠️\n\n- **Frontend**:\n  - HTML5, CSS3, JavaScript\n  - Custom CSS animations and transitions\n  - Responsive design with CSS Grid and Flexbox\n  - Neumorphic UI components\n\n- **Backend**:\n  - Python 3.x\n  - Flask web framework\n  - Natural Language Processing:\n    - VADER Sentiment Analysis\n    - TextBlob\n    - NLTK\n  - Pandas for data processing\n\n- **Data**:\n  - JSON-based Quran database\n  - Structured emotional word dictionaries\n  - Sentiment mapping system\n \n## Machine Learning Pipeline 🧠\n\n- Sentiment Analysis:\n\n  - VADER scoring (neg, neu, pos, compound)\n\n  - Custom linguistic feature extraction\n\n  - Emotion-word dictionary mapping\n\n- Model Performance:\n\n  - 89% accuracy on verse classification\n\n  - 0.87 F1 Score\n\n  - 0.14 Balanced Error Rate\n\n- Verse Classification:\n\n  - Two-stage classification process\n\n  - Multi-label emotion mapping\n\n  - Confidence scoring system\n\n## Data Processing 📊\n\n- Preprocessing:\n\n  - Tokenization and lemmatization\n\n  - Stopword removal\n\n  - Feature extraction including sentiment polarity\n\n- Dataset Statistics:\n\n  - 6,236 total verses\n\n  - 6 emotional categories\n\n  - Distribution: 15% Joyful, 25% Peaceful, 10% Angry, 20% Fearful, 20% Remorseful, 10% Reflective\n\n## Installation 🚀\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/ymorsi7/QuranicSentiment.git\ncd QuranicSentiment\n```\n\n2. Install required Python packages:\n```bash\npip install -r requirements.txt\n```\n\n3. Run the application:\n```bash\npython app.py\n```\n\n4. Open your browser and navigate to:\n```\nhttp://localhost:5000\n```\n\n## Usage 📱\n\n1. **Direct Emotion Selection**:\n   - Click on any emotion button that matches your current feeling\n   - Receive a relevant Quranic verse instantly\n\n2. **Text Input**:\n   - Type how you're feeling in the input box\n   - Click \"Analyze\" or press Enter\n   - The system will detect your emotion and provide a matching verse\n\n3. **Related Verses**:\n   - Explore similar verses shown below the main verse\n   - Click on any related verse to view it\n\n## Emotional Categories 🎭\n\n- **Joyful** 😊: Verses about happiness, gratitude, and divine blessings\n- **Peaceful** 😌: Content focusing on tranquility, security, and inner peace\n- **Fearful** 😨: Verses addressing anxiety, worry, and divine protection\n- **Angry** 😠: Content about patience, self-control, and forgiveness\n- **Remorseful** 😔: Verses about seeking forgiveness and divine mercy\n- **Reflective** 🤔: Content encouraging contemplation and understanding\n\n## Project Structure 📁\n\n```\nQuranicSentiment/\n├── docs/\n│   ├── icon.png\n│   ├── page.png\n│   └── index.html\n├── app.py\n├── main.py\n├── quran.json\n└── README.md\n```\n\n\n## Contributing 🤝\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## License 📄\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Acknowledgments 🙏\n\n- Quran data source\n- VADER Sentiment Analysis\n- TextBlob and NLTK communities\n- All contributors and supporters\n\n## Contact 📬\n\nContributors:\n- Yusuf Morsi\n- Younus Ahmad\n- Ali Alani\n\nProject Links:\n- Repository: [https://github.com/ymorsi7/QuranicSentiment](https://github.com/ymorsi7/QuranicSentiment)\n- Live Site: [https://ymorsi7.github.io/QuranicSentiment/](https://ymorsi7.github.io/QuranicSentiment/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fymorsi7%2Fquranicsentiment","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fymorsi7%2Fquranicsentiment","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fymorsi7%2Fquranicsentiment/lists"}