Persian Image Captioning

Persian Image Captioning

Writes a caption in Persian for a picture, using a vision model and a Persian language model in a Gradio page, with three example images included. For students and developers working with Persian text.

Made by MahsaShahidi on Hugging Face. These notes are Mindket's, written from its Space page and README; the app's own files and license are on Hugging Face.

About

What it is: This Gradio app from MahsaShahidi writes Persian captions for pictures. It names three models: a ViT image model from Google, a Persian BERT model from HooshvareLab and the author's own Persian-Image-Captioning model. The repository includes three example images. You use it in a browser, or you run a copy on your own computer.

Who it suits: It suits students and developers who work with Persian text and want to see an image captioning model in action.

Industry | Who uses it | How they use it | Example
Education | Language and vision students | See how a model describes a picture in Persian | Open the Space and pick an example image
Research | Persian language researchers | Check caption quality on their own pictures | Upload a picture and read the caption
Software | Python developers | Read how three models are combined in one page | Download the Space and open app.py

Skip it if you need captions in other languages, because the models it names are for Persian.

Where to use it:

• A web browser: go to the Space on Hugging Face and try it with no install
• Windows, macOS or Linux: run a copy with Python

Use case | Who | What they get back
Caption a picture | Students | A Persian sentence about the picture
Test the model | Researchers | A quick look at how it handles different images
Study the code | Developers | An app.py that loads the three named models

How to set it up: You need a few things in place first.

• Python with pip, on Windows, macOS or Linux
• An internet connection to fetch the files from Hugging Face
• Spare disk space, since the app names three models and the first run may need extra downloads

1. Install the Hugging Face hub package.
2. Download the Space into a local folder.
3. Move into that folder.
4. Install Gradio and the packages listed in requirements.txt.
5. Start the app.

pip install -U huggingface_hub
hf download MahsaShahidi/Persian-Image-Captioning --repo-type space --local-dir Persian-Image-Captioning
cd Persian-Image-Captioning
pip install gradio
pip install -r requirements.txt
python app.py

How to use it: Online, use the Gradio interface the Space page shows. On your own computer, run the main file from the project folder and open the page it serves in your browser.

python app.py

Example: You run python app.py inside the project folder, open the page and give it a picture such as image-1.jpg from the repository. The page returns a Persian caption for it.

For newcomers and experts: If this is new to you, start online. Go to the Space and try one of the example images before you install anything. Captioning means the model writes a short sentence about what is in a picture.

If you know the field, note that the names suggest a ViT image encoder paired with a Persian text model. The source gives no scores, training data or limits, so judge the captions on your own images.

Open the Space or run app.py
The Gradio page loads
You give it a picture
The models produce a caption
The Persian caption appears

Good to know: The source gives no quality figures, and a caption can miss or misname things in a picture, so check it against the image.

• License: mit
• Cost to run: none named, no API key, account or paid service
• Data it reaches: the pictures you give it and the three models it names, with nothing else listed

On Hugging Face, 13 November 2026

• Likes: 0
• Built with: gradio
• License: mit

Links

• Space: https://huggingface.co/spaces/MahsaShahidi/Persian-Image-Captioning
• Files: https://huggingface.co/spaces/MahsaShahidi/Persian-Image-Captioning/tree/main

Try it

Open the Space in your browser, or copy it to your own Hugging Face account from its page. Nothing in this kit runs by itself.