README.md

metadata

title: Mustalhim Text
emoji: 🏃
colorFrom: yellow
colorTo: gray
sdk: gradio
sdk_version: 5.18.0
app_file: app.py
pinned: false
license: apache-2.0

Mustalhim: Image to Story Generator

Mustalhim (مستلهم), meaning "inspired" in Arabic, is an AI-powered application that transforms images into captivating stories. It uses state-of-the-art models for image captioning and text generation to create an immersive storytelling experience.

Features

• Image Captioning: Generates a descriptive caption for an uploaded image using the Salesforce/blip-image-captioning-large model.
• Story Generation: Creates a long, engaging story inspired by the image caption using the ALLaM-7B-Instruct-preview model.
• Gradio Interface: Provides an easy-to-use web interface for uploading images and viewing the generated story.

How It Works

1. Image Captioning: The app uses a pre-trained image captioning model to generate a textual description of the uploaded image.
2. Story Generation: The caption is passed to a text-generation model, which creates a long, creative story inspired by the caption.
3. Output: The app returns the generated story, which is displayed in the interface.

Requirements

• Python 3.9+
• Libraries:
  • gradio
  • transformers
  • torch

---

Example Usage

1. Upload an image using the Gradio interface.
2. The app will generate a caption for the image.
3. A story will be created based on the caption and displayed in the interface.

Acknowledgments

• Hugging Face for providing the models and deployment platform.
• Gradio for the easy-to-use interface.
• Salesforce for the blip-image-captioning-large model.
• ALLaM-AI for the ALLaM-7B-Instruct-preview model.

---

About the Name

Mustalhim (مستلهم) is an Arabic word meaning "inspired." This project is inspired by the power of AI to transform images into creative and engaging stories.

---

Contact

For questions or feedback, feel free to reach out:

• Name: Mohammad Alkhatim
• GitHub: MoJaff
• LinkedIn: Mohammad Alkhatim
• Hugging Face: MoJaff

---

Experience the magic of Mustalhim and let your images inspire stories! 🚀

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference