Pant0x commited on
Commit
b346d74
·
verified ·
1 Parent(s): 87ba8b8

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +39 -0
README.md CHANGED
@@ -0,0 +1,39 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: CIFAR-10 Image Classifier
3
+ emoji: "🖼️"
4
+ colorFrom: "blue"
5
+ colorTo: "green"
6
+ sdk: "streamlit"
7
+ sdk_version: "1.26.0"
8
+ app_file: "app.py"
9
+ pinned: false
10
+ ---
11
+
12
+ # 🚀 CIFAR-10 Image Classifier
13
+
14
+ This is a **Streamlit** app running a **TensorFlow/Keras CNN** trained on the CIFAR-10 dataset.
15
+ Upload an image, and the model will predict one of 10 classes:
16
+
17
+ **airplane, automobile, bird, cat, deer, dog, frog, horse, ship, truck**
18
+
19
+ ---
20
+
21
+ ## 🧩 Features
22
+ - Upload images (PNG/JPG)
23
+ - Auto-resize and preprocess
24
+ - Predict top-3 classes with confidence
25
+ - Visualize all class probabilities in a bar chart
26
+ - Works directly on Hugging Face Spaces
27
+
28
+ ---
29
+
30
+ ## 📁 Files
31
+ - `app.py` — The Streamlit app
32
+ - `models/cifar10_cnn.keras` — Trained model
33
+ - `models/labels_map.json` — Class labels
34
+ - `requirements.txt` — Dependencies
35
+
36
+ ---
37
+
38
+ ## ⚡ How to run
39
+ This app is fully deployed on **Hugging Face Spaces**. Just push your repo with this structure, and it will build automatically.