Skip to content

hatixntsoa/iris.classifier

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Iris Classifier 🌸🤖

A professional beginner-friendly Machine Learning project designed to classify iris flowers using the famous Iris Dataset.
This project demonstrates the fundamentals of supervised learning for classification, implemented with Linear Regression and enhanced by feature scaling to improve model accuracy and robustness.

It is intended as a guided, reproducible project for those starting in Machine Learning, while maintaining production-ready structure and best practices for deployment and experimentation.


🎯 Project Goals

  • Introduce supervised learning concepts in a real-world dataset.
  • Implement a classification task using Linear Regression.
  • Apply feature scaling for improving prediction accuracy.
  • Demonstrate reproducibility and professional project structure for ML workflows.
  • Provide export options for models across formats (Scikit-learn, TensorFlow, PyTorch, etc.).

⚙️ Setup

You have two ways to use this project:

🔹 Option 1 — Run on Kaggle

  1. Visit the Iris Classifier Repository on GitHub.
  2. Click “Use this template” to create your own repository.
  3. On Kaggle, create a new Notebook and select “Link to GitHub” → choose your repository.
  4. Begin experimenting directly on Kaggle with zero installation overhead.

🔹 Option 2 — Run Locally or on a Cloud Machine

  1. Clone the repository:
git clone https://github.com/hatixntsoa/iris.classifier.git
cd iris.classifier
  1. Create a virtual environment:

    python -m venv .venv
  2. Activate the environment:

    • On Linux/Mac:

      source .venv/bin/activate
    • On Windows:

      venv\Scripts\activate
  3. Install dependencies:

    pip install -r requirements.txt

📊 Learning Outcomes

By completing this project, you will:

  • Understand the Iris Dataset and its role in ML research.
  • Learn how to perform data preprocessing and scaling.
  • Train and evaluate a Linear Regression classifier for multi-class prediction.
  • Explore export and deployment options for trained models.
  • Gain confidence in building well-structured, reproducible ML pipelines.

📜 License

This project is licensed under the MIT License.

Releases

No releases published

Packages

No packages published