🤖 Machine Learning app App streamlit

This my first Machine Learning App

Demo App

GitHub Codespaces

🐧 Penguin Species Prediction - Machine Learning App

An interactive web application that predicts penguin species using 8 different Machine Learning algorithms. Built with Streamlit for educational and research purposes.

📋 Table of Contents

• Overview
• Features
• Demo
• Installation
• Usage
• Machine Learning Models
• Dataset
• Technologies
• Project Structure
• Screenshots
• Contributing
• License
• Contact

🎯 Overview

This application demonstrates the power of Machine Learning for species classification using the famous Palmer Penguins dataset. Users can select from 9 different ML algorithms, adjust hyperparameters, and make real-time predictions with confidence scores.

Key Highlights

• ✅ 8 ML Models: Compare Random Forest, SVM, Neural Networks, and more
• ✅ Interactive UI: Intuitive interface with real-time predictions
• ✅ Model Comparison: Automatic benchmarking of all algorithms
• ✅ Performance Metrics: Detailed accuracy, cross-validation, and confusion matrices
• ✅ Data Visualization: Interactive charts and correlation analysis
• ✅ Educational: Perfect for learning ML classification techniques

🚀 Features

1. Model Selection

Choose from 8 state-of-the-art classification algorithms:

• 🌳 Random Forest
• 🚀 Gradient Boosting
• 🎯 Support Vector Machine (SVM)
• 👥 K-Nearest Neighbors
• 🌲 Decision Tree
• 📊 Logistic Regression
• 🎲 Naive Bayes
• ⚡ AdaBoost

2. Hyperparameter Tuning

• Dynamically adjust model parameters
• Real-time model retraining
• Custom configurations for each algorithm

3. Real-Time Prediction

• Interactive sliders for penguin features
• Instant species prediction with confidence scores
• Probability distribution visualization

4. Data Exploration

• Complete dataset overview
• Descriptive statistics
• Species distribution analysis

5. Interactive Visualizations

• Scatter plots with species coloring
• Correlation matrices
• Distribution analysis by species

6. Performance Evaluation

• Accuracy scores (test and cross-validation)
• Confusion matrix
• Detailed classification report
• Feature importance analysis
• Training time metrics

7. Model Comparison

• Automatic benchmarking of all 9 models
• Side-by-side performance comparison
• Medal ranking system 🥇🥈🥉
• Recommendations for model selection

🎬 Demo

🔗 Live Demo: https://machine-learningx.streamlit.app

💻 Installation

Prerequisites

• Python 3.8 or higher
• pip package manager

Steps

1. Clone the repository

git clone https://github.com/SalaheddinE-ai/Machine-Learning.git
cd Machine-Learning

2. Create a virtual environment (recommended)

python -m venv venv

# On Windows
venv\Scripts\activate

# On macOS/Linux
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

4. Run the application

streamlit run streamlit_app.py

The app will open in your default browser at http://localhost:8501

📦 Requirements

streamlit
pandas
numpy
scikit-learn

🎮 Usage

Quick Start

1. Select a Model: Choose an ML algorithm from the sidebar
2. Adjust Hyperparameters: Fine-tune model settings (optional)
3. Input Penguin Features: Use sliders to set characteristics
   • Island location
   • Bill length and depth
   • Flipper length
   • Body mass
   • Sex
4. View Prediction: See the predicted species with confidence score
5. Explore Performance: Check accuracy and other metrics in the Performance tab
6. Compare Models: Use the Model Comparison tab to find the best algorithm

Example Input

Island: Biscoe
Bill Length: 47.0 mm
Bill Depth: 15.0 mm
Flipper Length: 217.0 mm
Body Mass: 5000.0 g
Sex: Male

Predicted Species: Gentoo (95% confidence)

🤖 Machine Learning Models

Model	Best For	Speed	Interpretability
🌳 Random Forest	General purpose	Medium	Medium
🚀 Gradient Boosting	High accuracy	Slow	Low
🎯 SVM	Non-linear data	Medium	Low
👥 K-Nearest Neighbors	Simple cases	Fast	High
🌲 Decision Tree	Interpretability	Fast	Very High
📊 Logistic Regression	Linear relationships	Very Fast	Very High
🎲 Naive Bayes	Large datasets	Very Fast	Medium
⚡ AdaBoost	Ensemble learning	Medium	Medium

📊 Dataset

Palmer Penguins Dataset

• Source: Palmer Station, Antarctica
• Species: Adelie, Chinstrap, Gentoo
• Features: 7 variables
• Observations: 344 penguins
• Islands: Biscoe, Dream, Torgersen

Variables

Variable	Description	Type
island	Island where penguin was observed	Categorical
bill_length_mm	Length of the bill	Numeric (mm)
bill_depth_mm	Depth of the bill	Numeric (mm)
flipper_length_mm	Length of the flipper	Numeric (mm)
body_mass_g	Body mass	Numeric (g)
sex	Penguin sex	Categorical
species	Penguin species (target)	Categorical

Dataset Credit: Palmer Penguins by Allison Horst

🛠️ Technologies

Frontend

• Streamlit: Interactive web interface
• HTML/CSS: Custom styling

Backend & ML

• Scikit-learn: Machine Learning algorithms
• Pandas: Data manipulation
• NumPy: Numerical computations

Data Visualization

• Streamlit Charts: Native visualization components

📁 Project Structure

penguin-ml-prediction/
│
├── streamlit_app.py          # Main application file
├── requirements.txt           # Python dependencies
├── README.md                  # Project documentation
│
├── .gitignore                 # Git ignore file
└── LICENSE                    # License file

📸 Screenshots

Prediction Tab

Model Comparison

Data Visualization

🎯 Use Cases

• Education: Learn and teach ML classification
• Research: Experiment with different algorithms
• Data Science: Prototype classification models
• Biology: Study penguin species characteristics
• ML Practice: Hands-on experience with real data

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Ideas for Contribution

• Add more ML models
• Implement additional visualizations
• Add data preprocessing options
• Create model export functionality
• Improve UI/UX design
• Add unit tests
• Translate to other languages

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Your Name

• GitHub: @SalaheddinE-ai
• LinkedIn: salaheddine-es-aissi-elismaili
• Email: esaissielismailisalaheddine@gmail.com

Acknowledgments

• Palmer Penguins Dataset: Allison Horst
• Streamlit: For the amazing web framework
• Scikit-learn: For comprehensive ML tools
• Palmer Station, Antarctica: For collecting the penguin data

📈 Future Enhancements

• Add model persistence (save/load trained models)
• Implement ensemble voting classifier
• Add SHAP values for model explainability
• Include ROC curves and AUC scores
• Add batch prediction from CSV upload
• Implement hyperparameter optimization (GridSearch)
• Add model deployment guide
• Create API endpoint for predictions

Known Issues

• None currently reported

💬 Support

If you have any questions or issues, please:

1. Check existing Issues
2. Open a new issue with detailed information
3. Contact via email

⭐ Star History

If you find this project useful, please consider giving it a star! ⭐

---

Made with ❤️ and Python

Last Updated: November 2025