Skip to content

ArchitJ6/CancerGuardian

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CancerGuardian πŸŽ—οΈπŸ”¬

πŸš€ CancerGuardian is a machine learning-powered web application designed to assist in breast cancer diagnosis using the Breast Cancer Wisconsin (Diagnostic) Dataset. This tool predicts whether a tumor is malignant or benign, helping in early detection and decision-making.


🌟 Features

βœ… Breast cancer classification using machine learning πŸ“Š
βœ… Trained on the Breast Cancer Wisconsin (Diagnostic) Dataset πŸ₯
βœ… Standardized input scaling with StandardScaler πŸ”„
βœ… Interactive web interface built with streamlit 🎨
βœ… Easy-to-run setup with pre-trained model 🎯


πŸ“‚ Project Structure

CancerGuardian/
│── assets/
β”‚   └── style.css              # CSS for UI styling
β”‚
│── dataset/
β”‚   β”œβ”€β”€ data.csv               # Original dataset
β”‚
│── model/
β”‚   β”œβ”€β”€ data_cleaned.csv       # Processed dataset
β”‚   β”œβ”€β”€ model.pkl              # Trained ML model
β”‚   β”œβ”€β”€ scaler.pkl             # StandardScaler for input normalization
β”‚   β”œβ”€β”€ train.py               # Script for training the model
β”‚
│── app.py                     # Main application script

πŸ“Š Dataset Information

This project utilizes the Breast Cancer Wisconsin (Diagnostic) Dataset, available on Kaggle: πŸ”— Dataset Link

The dataset contains features extracted from digitized images of breast mass and helps classify tumors into:

  • Malignant (cancerous) πŸ›‘
  • Benign (non-cancerous) βœ…

πŸ› οΈ Installation & Usage

1️⃣ Clone the Repository

git clone https://github.com/ArchitJ6/CancerGuardian.git
cd CancerGuardian

2️⃣ Install Dependencies

pip install -r requirements.txt

3️⃣ Run the Application

streamlit run app.py

πŸ—οΈ How It Works

1️⃣ User inputs tumor-related features via the web interface πŸ–₯️

2️⃣ Input is standardized using StandardScaler πŸ“

3️⃣ Pre-trained model.pkl predicts whether the tumor is malignant or benign 🧬

4️⃣ Result is displayed with an intuitive UI 🎨


🀝 Contributing

Contributions are welcome! Feel free to fork the repository, make improvements, and submit a pull request. πŸš€


πŸ“œ License

This project is licensed under the MIT License. πŸ“œ


🌟 Show Your Support

If you found this project helpful, ⭐️ star the repository and share it with others!

Happy coding! πŸ’™

About

CancerGuardian is a machine learning-powered web app that helps predict breast cancer diagnoses based on cytology measurements. 🩺✨ Built with Streamlit, Scikit-Learn, and Plotly, this tool visualizes tumor characteristics and provides predictions using a trained model. πŸš€

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors