saja003 commited on
Commit
54f807f
·
verified ·
1 Parent(s): 41b9a92

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +35 -14
README.md CHANGED
@@ -1,14 +1,35 @@
1
- ---
2
- title: Street Descriptions Using MuniVis Model
3
- emoji: 📚
4
- colorFrom: purple
5
- colorTo: blue
6
- sdk: gradio
7
- sdk_version: 5.25.2
8
- app_file: app.py
9
- pinned: false
10
- license: mit
11
- short_description: This project using the MuniVis model to describe streets.
12
- ---
13
-
14
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # 🖼️ MuniVis - Multilingual Image Captioning
2
+
3
+ **MuniVis** is a powerful image captioning application built using the BLIP (Bootstrapped Language-Image Pretraining) model fine-tuned on custom data. It provides image descriptions in both **English** and **Arabic**, making it suitable for multilingual applications, accessibility tools, and urban scene understanding.
4
+
5
+ ## 🔍 What It Does
6
+
7
+ - Generates English image captions using a fine-tuned BLIP model.
8
+ - Automatically translates captions into Arabic using MarianMT (English → Arabic).
9
+ - Provides a simple web interface powered by [Gradio](https://gradio.app/).
10
+
11
+ ## 🚀 Demo
12
+
13
+ Try it on [Hugging Face Spaces](https://huggingface.co/spaces/saja003/MuniVis)!
14
+
15
+ ## 📷 How to Use
16
+
17
+ 1. Upload an image.
18
+ 2. Choose your preferred language (English or Arabic).
19
+ 3. The model will analyze the image and generate a meaningful description.
20
+
21
+ ## 🧠 Model Information
22
+
23
+ - **Image Captioning Backbone**: `BLIP (Salesforce/blip-image-captioning-base)`
24
+ - **Translation Model**: `Helsinki-NLP/opus-mt-en-ar`
25
+ - **Custom Fine-Tuned Model**: [`saja003/MuniVis`](https://huggingface.co/saja003/MuniVis)
26
+
27
+ ## 📦 Requirements
28
+
29
+ This app runs on the following Python packages:
30
+
31
+ ```txt
32
+ torch
33
+ transformers
34
+ gradio
35
+ Pillow