An open API service indexing awesome lists of open source software.

https://github.com/vishalsiingh/disease-prediction


https://github.com/vishalsiingh/disease-prediction

Last synced: 18 days ago
JSON representation

Awesome Lists containing this project

README

        

# 🚀 Disease Prediction App

Welcome to the **Disease Prediction App**, a **Machine Learning-powered** web application built with **Streamlit**. This app allows users to input symptoms and predicts possible diseases using a trained model.

---

## ✨ Features
✅ **Easy-to-use** Streamlit interface
✅ **Accurate disease prediction** based on user inputs
✅ **Interactive visualizations** using Matplotlib
✅ **CSV data support** for model training
✅ **One-click deployment** on Streamlit Cloud

---

## 🛠 Installation Guide

### **1️⃣ Clone the Repository**
```bash
git clone https://github.com/your-username/disease-prediction.git
cd disease-prediction
```

### **2️⃣ Set Up a Virtual Environment**
```bash
python -m venv venv
source venv/bin/activate # macOS/Linux
venv\Scripts\activate # Windows
```

### **3️⃣ Install Dependencies**
```bash
pip install -r requirements.txt
```

### **4️⃣ Verify Module Installation**
Check if `matplotlib` is installed:
```bash
pip show matplotlib
```
If missing, install it:
```bash
pip install matplotlib
```

### **5️⃣ Run the Streamlit App**
```bash
streamlit run app.py
```

---

## 🚀 Deploying on Streamlit Cloud
### **Steps to Deploy**
1️⃣ Push your code to a **GitHub repository**.
2️⃣ Ensure `requirements.txt` includes:
```
streamlit
pandas
numpy
matplotlib
scikit-learn
```
3️⃣ Visit **[Streamlit Cloud](https://share.streamlit.io/)** and deploy your app.
4️⃣ Restart or redeploy if needed.
5️⃣ Check logs for debugging if any issues occur.

### 🌐 **Live Demo**
🎯 **Access the deployed app here:** [🔗 Disease Prediction App](https://vishalsiingh-disease-prediction-app-fumaid.streamlit.app)

---

## 📂 File Structure
```
/ disease-prediction
├── app.py # Main Streamlit app
├── model.py # ML model training
├── requirements.txt # Dependencies
├── README.md # Project documentation
├── data/ # Dataset folder
├── images/ # Any app-related images
```

---

## 🤝 Contributing
💡 Pull requests are welcome! For major changes, open an issue first to discuss what you'd like to modify.

---

## 📜 License
This project is licensed under the **MIT License**.

---

## 📬 Contact
For any questions, feel free to reach out:
📧 **Email:** [email protected]