{"id":27337724,"url":"https://github.com/vipinchaudhary31122002/cardiopredict","last_synced_at":"2025-04-12T15:18:46.037Z","repository":{"id":282209190,"uuid":"947825884","full_name":"Vipinchaudhary31122002/CardioPredict","owner":"Vipinchaudhary31122002","description":"CardioPredict is a smart, ML-powered application that helps analyze your risk of heart disease using interactive forms, clinical features, and trained classification models. ","archived":false,"fork":false,"pushed_at":"2025-04-07T22:23:14.000Z","size":4674,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T15:18:42.617Z","etag":null,"topics":["machine-learning","matplotlib","numpy","pandas","python3","random-forest","seaborn","streamlit"],"latest_commit_sha":null,"homepage":"https://cardiopredict-esanunwppxn4ey85naeoj5.streamlit.app/","language":"Jupyter Notebook","has_issues":false,"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/Vipinchaudhary31122002.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":"2025-03-13T10:03:06.000Z","updated_at":"2025-04-07T22:23:18.000Z","dependencies_parsed_at":"2025-03-13T11:33:59.144Z","dependency_job_id":null,"html_url":"https://github.com/Vipinchaudhary31122002/CardioPredict","commit_stats":null,"previous_names":["vipinchaudhary31122002/cardiopredict"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vipinchaudhary31122002%2FCardioPredict","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vipinchaudhary31122002%2FCardioPredict/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vipinchaudhary31122002%2FCardioPredict/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vipinchaudhary31122002%2FCardioPredict/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vipinchaudhary31122002","download_url":"https://codeload.github.com/Vipinchaudhary31122002/CardioPredict/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248586220,"owners_count":21128998,"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":["machine-learning","matplotlib","numpy","pandas","python3","random-forest","seaborn","streamlit"],"created_at":"2025-04-12T15:18:45.577Z","updated_at":"2025-04-12T15:18:46.028Z","avatar_url":"https://github.com/Vipinchaudhary31122002.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🫀 CardioPredict - Heart Disease Risk Analyzer\n\n**CardioPredict** is a smart, ML-powered application that helps analyze your risk of heart disease using interactive forms, clinical features, and trained classification models. It's designed with doctors, patients, and health enthusiasts in mind — making heart health prediction more accessible than ever!\n\n---\n\n## 🚀 Features\n\n✅ **Smart Risk Prediction**: Instantly predicts whether a patient is at risk of cardiovascular disease.  \n✅ **Interactive Health Form**: User-friendly dropdowns for 18+ symptoms and risk factors.  \n✅ **Boolean Mapping**: Uses intuitive True/False and Male/Female inputs.  \n✅ **ML Integration**: Seamlessly connects to a trained machine learning model.  \n✅ **Dynamic Input Fields**: Reads from a JSON config so you can easily adjust fields.  \n✅ **Clean UI/UX**: Sidebar description, emoji-enhanced labels, and structured layout.  \n✅ **Safe and Local**: All processing happens on your machine. No data leaves your device.  \n\n---\n\n## 🛠️ Installation Guide\n\n### 1️⃣ Clone the Repository\n```bash\ngit clone https://github.com/yourusername/CardioPredict\ncd CardioPredict\n```\n\n### 2️⃣ (Optional) Create a Virtual Environment\n```bash\npython -m venv env\nsource env/bin/activate  # On Windows: env\\Scripts\\activate\n```\n\n### 3️⃣ Install Dependencies\n```bash\npip install -r requirements.txt\n```\n\n---\n\n## 🎯 Usage Guide\n\n### 🏁 Start the Application\n```bash\nstreamlit run app.py\n```\n\n### 📝 Fill Patient Data\n- Use dropdowns to provide information like:\n  - **Chest Pain**, **Fatigue**, **Shortness of Breath**\n  - **High BP**, **Diabetes**, **Cholesterol**, etc.\n  - **Age** and **Gender**\n  \n### 💡 Get Risk Prediction\n- Submit the form to instantly get:\n  - ✅ **Low Risk**\n  - ⚠️ **High Risk**\n\n\n## 👨‍💻 Contributing\n\nContributions are welcome! 🎉  \nWant to add enhancements or fix bugs?\n\n1. Fork the repo 🍴  \n2. Create a new branch (`feature-name`) 🌱  \n3. Make your changes 🛠️  \n4. Commit \u0026 push (`git commit -m 'Add feature'`) 📌  \n5. Open a pull request ✅  \n\n---\n\n## 💡 Future Enhancements\n\n🔹 Add visual analytics (feature importances, SHAP values)  \n🔹 Export prediction results as PDF report  \n🔹 Deploy to Streamlit Cloud or Hugging Face Spaces  \n🔹 Add multilingual support for international use  \n\n---\n\n## 📌 Disclaimer\n\nThis app is intended **for educational and demonstrative purposes only**. It is **not a substitute for professional medical diagnosis**. Always consult with certified healthcare providers for medical concerns.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvipinchaudhary31122002%2Fcardiopredict","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvipinchaudhary31122002%2Fcardiopredict","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvipinchaudhary31122002%2Fcardiopredict/lists"}