{"id":30026911,"url":"https://github.com/aronno1920/fashion-classifier-mnist","last_synced_at":"2026-04-18T02:33:27.121Z","repository":{"id":307087277,"uuid":"1028184782","full_name":"Aronno1920/Fashion-Classifier-MNIST","owner":"Aronno1920","description":"This project is a full-stack web application that allows users to upload an image of a fashion item (e.g., shirt, sneaker, bag) and classifies it using a Neural Network (NN) and Convolutional Neural Network (CNN)","archived":false,"fork":false,"pushed_at":"2025-07-31T07:00:47.000Z","size":11396,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-06T11:56:29.014Z","etag":null,"topics":["cnn","convolutional-neural-networks","deep-learning","fashion-classifier","flask","mnist","nn","nuralnetwork","python"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Aronno1920.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-07-29T06:43:49.000Z","updated_at":"2025-07-31T07:00:51.000Z","dependencies_parsed_at":"2025-07-29T11:53:44.234Z","dependency_job_id":"599b84a1-197b-447b-9f77-583d2b01cdc1","html_url":"https://github.com/Aronno1920/Fashion-Classifier-MNIST","commit_stats":null,"previous_names":["aronno1920/fashion-classifier-mnist"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Aronno1920/Fashion-Classifier-MNIST","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aronno1920%2FFashion-Classifier-MNIST","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aronno1920%2FFashion-Classifier-MNIST/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aronno1920%2FFashion-Classifier-MNIST/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aronno1920%2FFashion-Classifier-MNIST/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aronno1920","download_url":"https://codeload.github.com/Aronno1920/Fashion-Classifier-MNIST/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aronno1920%2FFashion-Classifier-MNIST/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31953787,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cnn","convolutional-neural-networks","deep-learning","fashion-classifier","flask","mnist","nn","nuralnetwork","python"],"created_at":"2025-08-06T11:55:15.776Z","updated_at":"2026-04-18T02:33:27.108Z","avatar_url":"https://github.com/Aronno1920.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧥 Fashion Classifier (MNIST) – TensorFlow, Flask, and FastAPI\n\nThis project is a full-stack web application that allows users to upload an image of a fashion item (e.g., shirt, sneaker, bag) and classifies it using a Neural Network (NN) and Convolutional Neural Network (CNN) trained on the [Fashion Classifier](https://github.com/Aronno1920/Fashion-Classifier-MNIST) dataset.\n\nThe app features:\n- 🔍 Real-time image classification\n- ⚙️ NN and CNN model build separately\n- 🧠 Robust preprocessing (resize, normalize, center the object)\n- 📸 Live preview of uploaded image\n- 💡 Displays top 3 predictions with confidence scores\n- 🎨 Beautiful and responsive HTML/CSS interface\n\n\n## 🚀 Live Demo\n\n\u003e _Want to see it in action?_  \n\u003e 👉 [Coming Soon: Deployed on Render or Hugging Face Spaces]\n\n\n## 🧠 Model Details\n\n- **Architecture**: 3-layer CNN with BatchNorm, Dropout, and MaxPooling\n- **Input shape**: 28×28 grayscale images\n- **Training Dataset**: Fashion MNIST (60,000 training + 10,000 test images)\n- **Accuracy**: ~91% on test data\n\n---\n\n## 🖼️ Supported Classes\n\n``` ['T-shirt/top', 'Trouser', 'Pullover', 'Dress', 'Coat','Sandal', 'Shirt', 'Sneaker', 'Bag', 'Ankle boot'] ```\n\n---\n\n## 🧪 Try It Locally\n\n### 1️⃣ Clone the repo\n```bash\ngit clone https://github.com/Aronno1920/Fashion-Classifier-MNIST.git\ncd fashion-classifier-mnist\n```\n2️⃣ Install requirements\n```bash\npip install -r requirements.txt\n```\n3️⃣ Run the app\n```bash\npython app.py\n```\nOpen your browser: http://127.0.0.1:5000\n\n\n📁 Project Structure\n\n```Image-Classification-AI/\n├── ImageSample/                        # Folder for example images or datasets\n├── __pycache__/                        # Python cache files (auto-generated)\n├── model/\n│   ├── best_nn_model.keras             # Saved trained NN model weights\n│   └── best_cnn_model.keras            # Saved trained CNN model weights\n├── notebooks/\n│   ├── fashion_mnist_selim_ahmed.py    # Saved colab file as python\n│   └── Fashion_MNIST_Selim_Ahmed.ipynb # Saved colab file \n├── static/                             # logo, style and other necessary\n│   ├── logo.png\n│   └── style.css\n├── templates/                          # Templates for web app or reports (if any)\n│   ├── index.html\n│   └── train.html\n├── templates/                 \n├── README.md                           # Project description and documentation\n├── app.py                              # Main application script (e.g., for running or serving the model)\n├── model_config.py                     \n├── train_model_cnn.py                  # CNN model training class\n└── train_model_nn.py                   # NN model training class\n```\n\n🛠 Tech Stack\n```bash\n    Python\n    TensorFlow / Keras\n    Flask\n    PIL (Pillow)\n    HTML5 + CSS\n    JavaScript (Image preview)\n    SciPy (for center-of-mass preprocessing)\n```\n\n📸 Screenshots\n\n![Screenshot](https://github.com/Aronno1920/Fashion-Classifier-MNIST/blob/main/screenshot/Screenshot_1.png)\n![Screenshot](https://github.com/Aronno1920/Fashion-Classifier-MNIST/blob/main/screenshot/Screenshot_2.png)\n![Screenshot](https://github.com/Aronno1920/Fashion-Classifier-MNIST/blob/main/screenshot/Screenshot_3.png)\n![Screenshot](https://github.com/Aronno1920/Fashion-Classifier-MNIST/blob/main/screenshot/Screenshot_4.png)\n![Screenshot](https://github.com/Aronno1920/Fashion-Classifier-MNIST/blob/main/screenshot/Screenshot_5.png)\n![Screenshot](https://github.com/Aronno1920/Fashion-Classifier-MNIST/blob/main/screenshot/Screenshot_6.png)\n\n✍️ Author\n\nSelim Ahmed \u003cbr/\u003e\n📫 [Connect on LinkedIn](https://www.linkedin.com/in/aronno1920/)\u003cbr/\u003e\n🌐 [GitHub Profile](https://github.com/aronno1920)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faronno1920%2Ffashion-classifier-mnist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faronno1920%2Ffashion-classifier-mnist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faronno1920%2Ffashion-classifier-mnist/lists"}