Arabic Auto Tashkeel

Arabic Auto Tashkeel

Adds tashkeel, the Arabic vowel marks, to plain Arabic text through a Gradio app. It suits teachers, learners and speech developers who need marked text.

Made by MohamedRashad 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: Arabic Auto Tashkeel is a small web app that fills in tashkeel, the short vowel marks, on Arabic text. Arabic is normally written without them, so readers and speech tools often have to guess how a word sounds. The repository holds a tokenizer, a transformer file and a models folder behind a Gradio screen.

Who it suits: Anyone who works with Arabic text and wants the vowel marks added without typing them by hand.

Industry | Who uses it | How they use it | Example
Education | Arabic teachers | Add marks to reading passages for learners | A short story for a beginner class
Publishing | Editors | Check how a sentence reads once it is marked | A line from a children's book
Speech technology | Text to speech developers | Prepare text so a voice reads it correctly | A sentence sent to a voice engine
Language learning | Students | Look up how a sentence is pronounced | A news sentence pasted in

People who already read unmarked Arabic with ease and never prepare text for others can skip it.

Where to use it:

• A web browser, on the Space's page at Hugging Face
• Windows, macOS or Linux with Python, from a downloaded copy

Use case | Who | What they get back
Marking a passage | Teachers | The same text with vowel marks added
Preparing speech input | Developers | Text with marks that guide the pronunciation
Reading practice | Learners | A marked version to read along with

How to set it up:

• Python installed on your computer
• Python packages from requirements.txt, with Gradio 4.27.0
• No account or key is named

1. Install the Hugging Face hub package.
2. Download the Space with the hf command.
3. Move into the downloaded folder.
4. Install Gradio 4.27.0, then the requirements.
5. Start app.py.

pip install -U huggingface_hub
hf download MohamedRashad/arabic-auto-tashkeel --repo-type space --local-dir arabic-auto-tashkeel
cd arabic-auto-tashkeel
pip install gradio==4.27.0
pip install -r requirements.txt
python app.py

How to use it: Online, open the Space page and use the screen there. On your own computer, start the app with the command below and use the screen it opens.

python app.py

Example: You paste a short Arabic sentence that has no vowel marks and run it. The app gives the same sentence back with tashkeel added above and below the letters.

For newcomers and experts: Start online. Open the Space page on Hugging Face, paste one short Arabic sentence and run it. Nothing needs installing for that. Tashkeel are the small marks that show which vowel follows each letter.

The file names suggest a transformer model with its own tokenizer, plus a models folder. The Space runs on cpu-basic hardware at Hugging Face, so no GPU is needed there.

Arabic text goes in
app.py receives it
Tokenizer and transformer add the marks
Marked text is shown

Good to know:

• Hardware: runs on cpu-basic at Hugging Face, built with Gradio 4.27.0
• License: apache-2
• Cost to run: none named
• Data it reaches: none named beyond the text you enter
• Not for: the source names no limits

On Hugging Face, 13 November 2026

• Likes: 29
• Built with: gradio
• License: apache-2.0

Links

• Space: https://huggingface.co/spaces/MohamedRashad/arabic-auto-tashkeel
• Files: https://huggingface.co/spaces/MohamedRashad/arabic-auto-tashkeel/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.