File size: 2,215 Bytes
99b5d17
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
---
title: PlateVision  YOLO-based License Plate Detection
emoji: 🚗
colorFrom: yellow
colorTo: blue
sdk: streamlit
sdk_version: "1.40.0"   # latest stable streamlit
app_file: app.py
pinned: false
license: mit
---

*A deep learning tool to classify tea leaves as healthy or unhealthy from images.*

![MIT License](https://img.shields.io/badge/license-MIT-green)

---

## Table of Contents

- [Demo](#demo)
- [Features](#features)
- [Installation / Setup](#installation--setup)
- [Usage](#usage)
- [Configuration / Options](#configuration--options)
- [Contributing](#contributing)
- [License](#license)
- [Acknowledgements / Credits](#acknowledgements--credits)

---

## Demo

![Demo Screenshot](./demo/demo.png)
*Main interface for uploading and classifying tea leaf images.*

![Demo Video](./demo/demo.mp4)
*Video walkthrough of the classification workflow.*

---

## Features

- Classifies tea leaf images as healthy or unhealthy using deep learning.
- Simple, interactive web-based UI for image upload and prediction.
- Modular codebase for easy extension and retraining.
- Fast inference for both single and batch image processing.

---

## Installation / Setup

```bash
# Create a virtual environment
python -m venv .venv

# Activate it
# On Linux/Mac:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt
```

---

## Usage

Run the application:

```bash
python app.py
```

This will launch the web interface in your browser.  
Upload an image of a tea leaf to get a health classification.

---

## Configuration / Options

- UI and model configuration can be adjusted in the source files.
- For advanced settings (e.g., model path, thresholds), edit the relevant Python files.

---

## Contributing

Contributions are welcome!
- Open issues for bugs or feature requests.
- Submit pull requests for improvements.
- Please follow standard Python code style and include tests where possible.

---

## License

This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.

---

## Acknowledgements / Credits

- Developed by Eslam Tarek.
- Thanks to the open-source community for libraries and inspiration.