{"id":20130672,"url":"https://github.com/md-emon-hasan/ml-project-iris-classifier-with-github-action","last_synced_at":"2025-07-01T12:04:25.594Z","repository":{"id":254966718,"uuid":"848113353","full_name":"Md-Emon-Hasan/ML-Project-Iris-Classifier-with-GitHub-Action","owner":"Md-Emon-Hasan","description":"🌸 ML Project integrated with GitHub Actions for CI/CD. It automates testing and deployment, ensuring a streamlined and efficient workflow.","archived":false,"fork":false,"pushed_at":"2024-08-28T11:48:12.000Z","size":86817,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-13T08:46:26.031Z","etag":null,"topics":["ci-cd","cicd","data-science","github-action","iris-classification","iris-dataset","mahcine-learning"],"latest_commit_sha":null,"homepage":"https://iris-classifier-flask.onrender.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Md-Emon-Hasan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-08-27T06:44:18.000Z","updated_at":"2024-08-28T11:48:15.000Z","dependencies_parsed_at":"2024-08-28T13:12:18.899Z","dependency_job_id":null,"html_url":"https://github.com/Md-Emon-Hasan/ML-Project-Iris-Classifier-with-GitHub-Action","commit_stats":null,"previous_names":["md-emon-hasan/iris-classifier-flask","md-emon-hasan/ml-project-iris-classifier-with-github-action"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Md-Emon-Hasan%2FML-Project-Iris-Classifier-with-GitHub-Action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Md-Emon-Hasan%2FML-Project-Iris-Classifier-with-GitHub-Action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Md-Emon-Hasan%2FML-Project-Iris-Classifier-with-GitHub-Action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Md-Emon-Hasan%2FML-Project-Iris-Classifier-with-GitHub-Action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Md-Emon-Hasan","download_url":"https://codeload.github.com/Md-Emon-Hasan/ML-Project-Iris-Classifier-with-GitHub-Action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241577071,"owners_count":19984940,"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":["ci-cd","cicd","data-science","github-action","iris-classification","iris-dataset","mahcine-learning"],"created_at":"2024-11-13T20:39:25.481Z","updated_at":"2025-03-02T21:44:02.647Z","avatar_url":"https://github.com/Md-Emon-Hasan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌸 Iris Flower Classification with CI/CD Integration\n\nWelcome to the **Iris Flower Classification with CI/CD Integration** repository! This project leverages machine learning to classify Iris flowers into different species based on their features, with continuous integration and deployment (CI/CD) powered by GitHub Actions.\n\n![355822492-aa068ef3-dfd8-4406-a39a-7646c3aba7af](https://github.com/user-attachments/assets/e38e08c2-a415-4433-b297-12cf1208eae4)\n\n## 📋 Contents\n\n- [Introduction](#introduction)\n- [Topics Covered](#topics-covered)\n- [Getting Started](#getting-started)\n- [Live Demo](#live-demo)\n- [CI/CD with GitHub Actions](#cicd-with-github-actions)\n- [Best Practices](#best-practices)\n- [FAQ](#faq)\n- [Troubleshooting](#troubleshooting)\n- [Contributing](#contributing)\n- [Additional Resources](#additional-resources)\n- [Challenges Faced](#challenges-faced)\n- [Lessons Learned](#lessons-learned)\n- [Why I Created This Repository](#why-i-created-this-repository)\n- [License](#license)\n- [Contact](#contact)\n\n---\n\n## 📖 Introduction\n\nThis repository showcases a machine learning project aimed at classifying Iris flowers into different species. The project incorporates continuous integration and deployment (CI/CD) using GitHub Actions for automating tests and deployment.\n\n---\n\n## 🔍 Topics Covered\n\n- **Machine Learning Models:** Training models to classify Iris flower species.\n- **Data Preprocessing:** Techniques for cleaning and preparing the Iris dataset.\n- **Model Evaluation:** Assessing the performance of the classification model.\n- **CI/CD:** Automating tests and deployments with GitHub Actions.\n- **Deployment:** Implementing the model as a web service using Flask and deploying it on cloud platforms.\n\n---\n\n## 🚀 Getting Started\n\nTo get started with this project, follow these steps:\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/Md-Emon-Hasan/ML-Project-Iris-Classifier-with-GitHub-Action.git\n   ```\n\n2. **Navigate to the project directory:**\n\n   ```bash\n   cd ML-Project-Iris-Classifier-with-GitHub-Action\n   ```\n\n3. **Create a virtual environment and activate it:**\n\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows use `venv\\Scripts\\activate`\n   ```\n\n4. **Install the dependencies:**\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n5. **Run the application:**\n\n   ```bash\n   python app.py\n   ```\n\n6. **Open your browser and visit:**\n\n   ```\n   http://127.0.0.1:5000/\n   ```\n\n---\n\n## 🎉 Live Demo\n\nCheck out the live version of the Iris Flower Classification app [here](https://iris-classifier-flask.onrender.com).\n\n---\n\n## 🤖 CI/CD with GitHub Actions\n\nThis project uses GitHub Actions for continuous integration and deployment. Each commit triggers the following workflow:\n\n- **Linting and Testing:** Automatically runs linting and tests to ensure code quality.\n- **Build and Deploy:** Builds and deploys the application to a cloud platform.\n\nYou can find the CI/CD workflow file in `.github/workflows/ci-cd.yml`.\n\n---\n\n## 🌟 Best Practices\n\nRecommendations for maintaining and improving this project:\n\n- **Model Updating:** Continuously retrain the model with new data to improve accuracy.\n- **CI/CD Enhancement:** Monitor and improve the CI/CD pipeline for faster and more reliable deployments.\n- **Documentation:** Keep the documentation up-to-date with the latest changes and improvements.\n\n---\n\n## ❓ FAQ\n\n**Q: What is the purpose of this project?**\nA: This project classifies Iris flowers into different species using machine learning and demonstrates the use of CI/CD for deployment.\n\n**Q: How can I contribute to this repository?**\nA: Refer to the [Contributing](#contributing) section for details on how to contribute.\n\n---\n\n## 🛠️ Troubleshooting\n\nCommon issues and solutions:\n\n- **Issue: CI/CD Pipeline Failing**\n  *Solution:* Check the GitHub Actions logs for errors and ensure all tests pass locally before committing.\n\n- **Issue: Model Accuracy Low**\n  *Solution:* Verify that the training data is preprocessed correctly and consider tuning the hyperparameters of the model.\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Here's how you can contribute:\n\n1. **Fork the repository.**\n2. **Create a new branch:**\n\n   ```bash\n   git checkout -b feature/new-feature\n   ```\n\n3. **Make your changes:**\n\n   - Add features, fix bugs, or improve documentation.\n\n4. **Commit your changes:**\n\n   ```bash\n   git commit -am 'Add a new feature or update'\n   ```\n\n5. **Push to the branch:**\n\n   ```bash\n   git push origin feature/new-feature\n   ```\n\n6. **Submit a pull request.**\n\n---\n\n## 📚 Additional Resources\n\nExplore these resources for more insights into CI/CD and machine learning:\n\n- **GitHub Actions Documentation:** [docs.github.com](https://docs.github.com/en/actions)\n- **Machine Learning Tutorials:** [Kaggle](https://www.kaggle.com/learn/overview)\n\n---\n\n## 💪 Challenges Faced\n\nSome challenges during development:\n\n- Setting up the CI/CD pipeline for automated testing and deployment.\n- Ensuring the model performs well with a limited dataset.\n\n---\n\n## 📚 Lessons Learned\n\nKey takeaways from this project:\n\n- Hands-on experience with CI/CD pipelines for automating testing and deployment.\n- Importance of continuous model improvement and deployment best practices.\n\n---\n\n## 🌟 Why I Created This Repository\n\nThis repository was created to demonstrate the end-to-end process of developing, integrating CI/CD, and deploying a machine learning model for classifying Iris flowers.\n\n---\n\n## 📝 License\n\nThis repository is licensed under the [MIT License](https://opensource.org/licenses/MIT). See the [LICENSE](LICENSE) file for more details.\n\n---\n\n## 📬 Contact\n\n- **Email:** [iconicemon01@gmail.com](mailto:iconicemon01@gmail.com)\n- **WhatsApp:** [+8801834363533](https://wa.me/8801834363533)\n- **GitHub:** [Md-Emon-Hasan](https://github.com/Md-Emon-Hasan)\n- **LinkedIn:** [Md Emon Hasan](https://www.linkedin.com/in/md-emon-hasan)\n- **Facebook:** [Md Emon Hasan](https://www.facebook.com/mdemon.hasan2001/)\n\n---\n\nFeel free to adjust and expand this template based on the specifics of your project and requirements.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmd-emon-hasan%2Fml-project-iris-classifier-with-github-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmd-emon-hasan%2Fml-project-iris-classifier-with-github-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmd-emon-hasan%2Fml-project-iris-classifier-with-github-action/lists"}