Projectt123 commited on
Commit
fc958e1
·
verified ·
1 Parent(s): 0d95fbf

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +47 -6
README.md CHANGED
@@ -1,13 +1,54 @@
1
  ---
2
- title: Street Descriptions Using MuniVis Model
3
- emoji: 🐨
4
- colorFrom: purple
5
  colorTo: blue
6
  sdk: gradio
7
- sdk_version: 5.41.1
8
  app_file: app.py
9
  pinned: false
10
- license: mit
11
  ---
12
 
13
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: Street Descriptions using MuniVis
3
+ emoji: 🛣️
4
+ colorFrom: indigo
5
  colorTo: blue
6
  sdk: gradio
7
+ sdk_version: 5.26.0
8
  app_file: app.py
9
  pinned: false
 
10
  ---
11
 
12
+ # 🛣️ Street Descriptions using MuniVis Model
13
+
14
+ This Space provides a simple Gradio interface for generating image captions using a fine-tuned BLIP model hosted at [`saja003/MuniVis`](https://huggingface.co/saja003/MuniVis). It also includes the option to translate the generated English captions into Arabic using a MarianMT translation model.
15
+
16
+ ---
17
+
18
+ ## 🔍 Features
19
+
20
+ - 🧠 Image captioning with a fine-tuned BLIP model.
21
+ - 🌐 Language selection: English or Arabic.
22
+ - 📸 Upload any street or urban image to generate a descriptive caption.
23
+ - 🤖 Translation powered by [Helsinki-NLP/opus-mt-en-ar](https://huggingface.co/Helsinki-NLP/opus-mt-en-ar).
24
+
25
+ ---
26
+
27
+ ## 🚀 How it works
28
+
29
+ 1. Upload an image.
30
+ 2. Select a language (English or Arabic).
31
+ 3. Receive a descriptive caption of the scene.
32
+ - If Arabic is selected, the caption is translated automatically.
33
+
34
+ ---
35
+
36
+ ## 🧠 Models Used
37
+
38
+ - **BLIP (Bootstrapping Language Image Pretraining):**
39
+ - Fine-tuned on street and infrastructure images.
40
+ - Model repo: [`Projectt123/MuniVis`](https://huggingface.co/Projectt123/MuniVis)
41
+ - **MarianMT Translation Model:**
42
+ - [`Helsinki-NLP/opus-mt-en-ar`](https://huggingface.co/Helsinki-NLP/opus-mt-en-ar) for English to Arabic translation.
43
+
44
+ ---
45
+
46
+ ## 🛠️ Requirements
47
+
48
+ This Space uses the following libraries:
49
+
50
+ ```bash
51
+ transformers
52
+ torch
53
+ gradio
54
+ Pillow