salihelfatih commited on
Commit
341d860
Β·
verified Β·
1 Parent(s): eacbcc2

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +18 -32
README.md CHANGED
@@ -1,3 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
1
  # 🌸 Fulla 🌸
2
 
3
  **Fulla (فلة)** is a deep learning project that classifies flowers from images using a ResNet-based neural network and transfer learning. Built with **PyTorch** and deployed with **Gradio**, this app blends the elegance of nature with the power of machine learning.
@@ -6,9 +17,9 @@
6
 
7
  ## πŸ–ΌοΈ Live Demo
8
 
9
- > [πŸ‘‰ Try it on Hugging Face Spaces](https://huggingface.co/spaces/salihelfatih/fulla)
10
 
11
- ## πŸ” Overview
12
 
13
  - 🌼 **102 Flower Classes**: Trained on the comprehensive [Flowers102 dataset](https://pytorch.org/vision/stable/generated/torchvision.datasets.Flowers102.html).
14
  - 🧠 **Transfer Learning**: Built on a pre-trained ResNet model for powerful feature extraction.
@@ -31,21 +42,18 @@ The confusion matrix below shows the model's high performance, with a strong dia
31
 
32
  ## πŸ› οΈ How to Run Locally
33
 
34
- 1. **Clone the repository:**
35
-
36
  ```bash
37
- git clone [https://github.com/salihelfatih/fulla]
38
  cd Fulla
39
  ```
40
 
41
- 2. **Install dependencies:**
42
-
43
  ```bash
44
  pip install -r requirements.txt
45
  ```
46
 
47
- 3. **Launch the app:**
48
-
49
  ```bash
50
  python -m app.interface
51
  ```
@@ -58,28 +66,6 @@ The confusion matrix below shows the model's high performance, with a strong dia
58
  - **Optimizer**: `Adam`
59
  - **Framework**: PyTorch
60
 
61
- ## πŸ“ Project Structure
62
-
63
- ```plaintext
64
- fulla/
65
- β”œβ”€β”€ fulla_core/
66
- β”‚ β”œβ”€β”€ model.py
67
- β”‚ β”œβ”€β”€ train.py
68
- β”‚ └── utils.py
69
- β”‚
70
- β”œβ”€β”€ app/
71
- β”‚ └── interface.py
72
- β”‚
73
- β”œβ”€β”€ main.ipynb
74
- β”œβ”€β”€ fulla_model.pth
75
- β”œβ”€β”€ README.md
76
- └── requirements.txt
77
- ```
78
-
79
- ## 🧾 License
80
-
81
- MIT License β€” free to use, remix, and bloom!
82
-
83
  ## πŸ™Œ Credits
84
 
85
- Developed by Salih Elfatih as a capstone project on deep learning and computer vision. Flowers bloom. So should code!
 
1
+ ---
2
+ license: mit
3
+ title: 🌸 Fulla 🌸
4
+ sdk: gradio
5
+ emoji: πŸ‘€
6
+ colorFrom: pink
7
+ colorTo: purple
8
+ pinned: true
9
+ short_description: A flower classifier built with PyTorch and Gradio.
10
+ ---
11
+
12
  # 🌸 Fulla 🌸
13
 
14
  **Fulla (فلة)** is a deep learning project that classifies flowers from images using a ResNet-based neural network and transfer learning. Built with **PyTorch** and deployed with **Gradio**, this app blends the elegance of nature with the power of machine learning.
 
17
 
18
  ## πŸ–ΌοΈ Live Demo
19
 
20
+ > You are looking at the live demo! For more details, check out the [GitHub repository](https://github.com/salihelfatih/fulla).
21
 
22
+ ## ✨ Features
23
 
24
  - 🌼 **102 Flower Classes**: Trained on the comprehensive [Flowers102 dataset](https://pytorch.org/vision/stable/generated/torchvision.datasets.Flowers102.html).
25
  - 🧠 **Transfer Learning**: Built on a pre-trained ResNet model for powerful feature extraction.
 
42
 
43
  ## πŸ› οΈ How to Run Locally
44
 
45
+ 1. **Clone the repository:**
 
46
  ```bash
47
+ git clone [https://github.com/salihelfatih/fulla](https://github.com/salihelfatih/fulla)
48
  cd Fulla
49
  ```
50
 
51
+ 2. **Install dependencies:**
 
52
  ```bash
53
  pip install -r requirements.txt
54
  ```
55
 
56
+ 3. **Launch the app:**
 
57
  ```bash
58
  python -m app.interface
59
  ```
 
66
  - **Optimizer**: `Adam`
67
  - **Framework**: PyTorch
68
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
69
  ## πŸ™Œ Credits
70
 
71
+ Developed by Salih Elfatih as a capstone project on deep learning and computer vision. Flowers bloom. So should code!