alexvee commited on
Commit
ea016ec
Β·
verified Β·
1 Parent(s): a81f96f

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +51 -1
README.md CHANGED
@@ -10,4 +10,54 @@ pinned: false
10
  short_description: A dog loving space
11
  ---
12
 
13
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
10
  short_description: A dog loving space
11
  ---
12
 
13
+ # 🐢 Dog Breed Classifier (Gradio + Hugging Face)
14
+
15
+ This web app uses a powerful transformer-based model from Hugging Face to classify dog breeds from uploaded images.
16
+
17
+ ## πŸ” Model
18
+ - **Name:** prithivMLmods/Dog-Breed-120
19
+ - **Base architecture:** SigLIP (Vision Transformer)
20
+ - **Classes:** 120 dog breeds
21
+
22
+ ## πŸš€ Features
23
+ - Built with **Gradio** for easy web interaction
24
+ - Powered by **Transformers + PyTorch**
25
+ - Can run on **Hugging Face Spaces** with no backend setup
26
+
27
+ ## πŸ“ File Structure
28
+ ```
29
+ dog-breed-app/
30
+ β”œβ”€β”€ app.py # Main app file
31
+ β”œβ”€β”€ requirements.txt # Python dependencies
32
+ └── README.md # This file
33
+ ```
34
+
35
+ ## πŸ§ͺ Local Setup
36
+ ```bash
37
+ # Create and activate environment (optional)
38
+ conda create -n dog-breed python=3.10 -y
39
+ conda activate dog-breed
40
+
41
+ # Install dependencies
42
+ pip install -r requirements.txt
43
+
44
+ # Run the app
45
+ python app.py
46
+ ```
47
+
48
+ ## 🌐 Deploy to Hugging Face Spaces
49
+ 1. Go to [https://huggingface.co/spaces](https://huggingface.co/spaces)
50
+ 2. Create a new Space (select **Gradio** as SDK)
51
+ 3. Upload `app.py` and `requirements.txt`
52
+ 4. Your app will be live at: `https://huggingface.co/spaces/your-username/your-app`
53
+
54
+ ## ✨ Example Use
55
+ Upload a photo like this:
56
+ ![example](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/spaces/dog-example.jpg)
57
+
58
+ And get a result like:
59
+ ```
60
+ golden_retriever (98.4%)
61
+ ```
62
+
63
+ Enjoy building! 🐾