{"id":25726884,"url":"https://github.com/rydzze/mentalassess","last_synced_at":"2026-05-19T07:02:41.213Z","repository":{"id":277264427,"uuid":"908796260","full_name":"rydzze/MentalAssess","owner":"rydzze","description":"Project for Expert Systems","archived":false,"fork":false,"pushed_at":"2025-02-13T01:50:56.000Z","size":145,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-31T18:04:50.772Z","etag":null,"topics":["clisp","diagnostic-tool","expert-systems","flask","mental-health","python"],"latest_commit_sha":null,"homepage":"","language":"Hack","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/rydzze.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-27T01:56:56.000Z","updated_at":"2025-04-21T10:40:40.000Z","dependencies_parsed_at":"2025-02-25T23:27:46.463Z","dependency_job_id":null,"html_url":"https://github.com/rydzze/MentalAssess","commit_stats":null,"previous_names":["rydzze/mentalassess"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rydzze/MentalAssess","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rydzze%2FMentalAssess","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rydzze%2FMentalAssess/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rydzze%2FMentalAssess/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rydzze%2FMentalAssess/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rydzze","download_url":"https://codeload.github.com/rydzze/MentalAssess/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rydzze%2FMentalAssess/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281563785,"owners_count":26522704,"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-29T02:00:06.901Z","response_time":59,"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":["clisp","diagnostic-tool","expert-systems","flask","mental-health","python"],"created_at":"2025-02-25T23:27:44.698Z","updated_at":"2025-10-29T05:04:14.584Z","avatar_url":"https://github.com/rydzze.png","language":"Hack","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧠 MentalAssess: Expert System for Mental Health Diagnosis  \n\n## 📌 Introduction  \n\nMental health issues such as **depression, anxiety, and stress** are increasingly recognized as serious concerns affecting individuals worldwide. However, early diagnosis and treatment remain challenging due to the **subjective nature** of mental health symptoms.  \n\n\u003e 🔹 **MentalAssess** is a **web-based expert system** that assists in diagnosing mental health disorders using a **rule-based approach with Certainty Factor (CF) methodology)**.  \n🔹 The system improves diagnostic **accuracy and reliability** by integrating **user-reported symptoms** with expert knowledge.  \n\n## ❗ Problem Statements\n\nDespite advancements in AI and expert systems, existing mental health assessment tools face **several challenges**:  \n\n🔸 **Rigid Rule-Based Systems** – Many systems fail to capture the **complexity and variability** of psychological conditions.  \n🔸 **Inconsistent Diagnoses** – Mental health symptoms are **highly subjective**, leading to **potential misdiagnoses**.  \n🔸 **Handling Uncertainty** – Many expert systems struggle to manage **uncertainty in symptom reporting** effectively.  \n\n## 🎯 Objectives  \n\nThe **MentalAssess** system aims to:  \n\n✅ Enhance **early detection** of mental health disorders.  \n✅ Improve **diagnostic reliability** using the **Certainty Factor (CF) approach**.  \n✅ Provide a **user-friendly** and **accessible** web-based platform.  \n✅ Generate **personalized diagnostic reports** based on user inputs.  \n\n## 🔥 System Features  \n\n🚀 **Web-Based Expert System** – Built with **Python, CLIPS, and Flask** for seamless deployment.  \n🧮 **Certainty Factor (CF) Methodology** – Handles **uncertainty** in diagnosing mental health conditions.  \n🎨 **User-Friendly Interface** – Developed using **HTML, CSS, and PHP** for an **intuitive** user experience.  \n🐳 **Docker Integration** – Ensures **smooth** and **isolated** deployment of the application.  \n📧 **Automated Email Reports** – Users can receive their **diagnostic results via email** for future reference.  \n\n## 🛠️ Installation Guide  \n\n### 📌 Prerequisites  \n\nBefore running **MentalAssess**, make sure you have:\n- 🐍 **Python 3.9+**  \n- 🐳 **Docker** (Optional)\n\n### ⚙️ Steps to Install and Run  \n\n1️⃣ **Clone the repository** 🖥️  \n \n```bash\ngit clone https://github.com/rydzze/MentalAssess.git\ncd MentalAssess\n```\n\n2️⃣ **Install dependencies** 📦\n\n``` bash\npip install -r requirements.txt\n```\n\n3️⃣ **Prepare the .env file** 🛠️\n\nCreate a .env file in the root directory and configure the following environment variables:\n\n```\nSECRET_KEY=MentalAssess\nMAIL_SERVER=smtp.gmail.com\nMAIL_PORT=587\nMAIL_USE_TLS=True\nMAIL_USE_SSL=False\nMAIL_USERNAME=your-email-address@gmail.com\nMAIL_PASSWORD=your-app-password\nMAIL_DEFAULT_SENDER=\"MentalAssess Results \u003cyour-gmail@gmail.com\u003e\"\n```\n\n4️⃣ **Run the application**\n\n**1. Using Python** 🐍\n\n```\npython run.py\n```\n\n**2. Using Docker (Alternative)** 🐳\n\n```\ndocker build -t mentalassess .\ndocker run -d -p 988:988 --env-file .env --name mentalassess mentalassess\n```\n\n5️⃣ **Access the system via:** 🌍\n\n```\nhttp://localhost:988\n```\n\n## 📸 **Screenshots of User Interface**\n\n![image](https://github.com/user-attachments/assets/19bdd134-1275-4c13-bde4-c54974aba875)\n\n![image](https://github.com/user-attachments/assets/d6a11b4e-1ef2-4510-bce7-51b34b92c22f)\n\n![image](https://github.com/user-attachments/assets/19190641-7315-4a35-848c-9c65c7622653)\n\n## 🏆 **Contribution**\n\nWe would like to express our gratitude to the following individuals for their contributions to MentalAssess:\n\n- [Muhammad Ariff Ridzlan](https://github.com/rydzze)\n- [Muhammad Hafiz](https://github.com/IbnAsmuni)\n- [Noor Alia Alisa](https://github.com/alia4lisa)\n- [Siti Nur Aisyah](https://github.com/ayesharizani)\n\nYour dedication and expertise have been instrumental in the development of this system. 🚀💡\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frydzze%2Fmentalassess","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frydzze%2Fmentalassess","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frydzze%2Fmentalassess/lists"}