EnYa32's picture
Update README.md
394fedc verified
|
Raw History Blame Contribute Delete
2.1 kB
---
title: SignLanguageClassification
emoji: 🀟
colorFrom: red
colorTo: red
sdk: streamlit
app_file: src/streamlit_app.py
pinned: false
short_description: Upload a hand sign image and the CNN predicts
license: mit
---
# 🀟 Sign Language Classification (CNN)
This project demonstrates a Convolutional Neural Network (CNN) for classifying sign language hand gestures from images.
A lightweight CNN was trained on grayscale images and deployed as a Streamlit web application.
---
## πŸš€ Demo
Upload an image of a hand sign (JPG/PNG), and the model predicts the corresponding class along with a confidence score and top predictions.
---
## πŸ“Š Dataset
- Grayscale images with a resolution of **28Γ—28 pixels**
- Images are provided in **CSV format** (pixel values + labels)
- Some dataset versions contain **non-continuous label indices**
- An additional **"Unknown"** class is used to ensure consistency between labels and model outputs
---
## 🧠 Model
- Framework: **TensorFlow / Keras**
- Architecture: **Sequential CNN**
- Convolution + Batch Normalization + MaxPooling layers
- Fully connected layers with Dropout
- Loss: `sparse_categorical_crossentropy`
- Optimizer: Adam
- Training without GPU acceleration
---
## πŸ“ˆ Results
- Test Accuracy: **~94%**
- Strong performance across most classes
- Confusion matrix shows only minor misclassifications between visually similar hand gestures
---
## ⚠️ Limitations
Predictions may vary for real-world images due to background noise, lighting conditions, and differences from the training data, which mainly contains centered and cropped hand images.
---
## πŸ–₯️ Streamlit App
The Streamlit app allows users to:
- Upload an image (JPG/PNG)
- View the input image
- See the predicted class and confidence score
- Inspect the top prediction probabilities
---
## πŸ“ Project Files
The following files are required in the repository root:
app.py
signlanguage_cnn.keras
label_map.json
requirements.txt
README.md
yaml
Code kopieren
---
## ▢️ Run Locally
```bash
pip install -r requirements.txt
streamlit run app.py