README.md

---
title: Dispatch AI — Arabic Proverb Generator
emoji: 📜
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: "4.44.1"
app_file: app.py
pinned: true
license: mit
tags:
  - arabic
  - proverbs
  - qwen
  - llm
  - culture
  - dispatch-ai
---

# Dispatch AI — Arabic Proverb Generator 📜

Generate traditional Arabic proverbs on any topic, with English translation, transliteration, and explanation. Powered by **Qwen2.5-7B-Instruct** via the HuggingFace Inference API.

Built by **Dispatch AI (FZE)** — UAE · License 10818.

## Features

- 📜 **Arabic proverb generation** — traditional wisdom on any topic
- 🌐 **English translation** — every proverb comes with a translation
- 🔤 **Transliteration** — Arabic in Latin script for non-Arabic readers
- 💡 **Meaning explanation** — brief explanation of the proverb's wisdom
- 🎭 **5 styles**: Classical, Poetic (saja'), Simple, Bedouin, Royal
- 📚 **Batch generation** — generate up to 5 proverbs at once
- 🏷️ **15 preset topics**: patience, knowledge, friendship, honesty, courage, etc.
- 🌙 **Dark theme** (#0A0F1A bg, #1FE0E6 cyan accent)

## Model

`Qwen/Qwen2.5-7B-Instruct` — a powerful multilingual LLM with strong Arabic support.

## Setup

1. Set your HuggingFace token as a Space secret named `HF_TOKEN`.

## License

MIT — Dispatch AI (FZE).