---
title: Aramaic Targum Diacritization
emoji: 📚
colorFrom: purple
colorTo: blue
sdk: streamlit
sdk_version: 1.28.0
app_file: app.py
pinned: false
license: mit
---

# Aramaic Targum Diacritization (Vocalization)

A modern, interactive web application for adding nikkud (vowel points) to consonantal Aramaic Targum text using the Hugging Face model `johnlockejrr/opus-arc-targum-vocalization`.

## 🌟 Features

- **Consonantal to Vocalized Aramaic**: Specialized diacritization for Targumic/Biblical Aramaic texts
- **Modern UI**: Clean, responsive design with gradient styling
- **Real-time Diacritization**: Instant vocalization with progress indicators
- **Batch Processing**: Upload text files for bulk diacritization
- **Copy to Clipboard**: Easy copying of vocalized results
- **Customizable Settings**: Adjustable output length

## 🚀 Try it out!

1. **Enter your consonantal Aramaic text** in the input area
2. **Click "✨ Diacritize Text"** to get instant vocalized results
3. **Copy or download** your diacritized text

## 📁 Batch Diacritization

Upload a text file with multiple consonantal Aramaic lines to vocalize them all at once. Results can be downloaded as a CSV file.

## 🔧 Model Information

- **Model**: `johnlockejrr/opus-arc-targum-vocalization`
- **Base Model**: Helsinki-NLP/opus-mt-afa-afa
- **Type**: Sequence-to-Sequence Diacritization Model
- **Framework**: Hugging Face Transformers + PyTorch
- **Task**: Consonantal → Vocalized Aramaic (Hebrew script)

## 🛠️ Technical Details

- **Backend**: Streamlit + PyTorch + Transformers
- **Caching**: Model is cached for faster subsequent loads
- **Device**: Automatically uses GPU if available, falls back to CPU
- **Styling**: Custom CSS with gradient backgrounds and modern design

## 📖 Usage Examples

### Consonantal to Vocalized Aramaic
Input: `בקדמין ברא יי ית שמיא וית ארעא`

Output: `בְּקַדמִין בְּרָא יְיָ יָת שְׁמַיָא וְיָת אַרעָא`

## 🔗 Related Links

- [Model on Hugging Face](https://huggingface.co/johnlockejrr/opus-arc-targum-vocalization)
- [Source Code](https://github.com/johnlockejrr/aramaic-diacritization)

## 📄 License

This application uses the `johnlockejrr/opus-arc-targum-vocalization` model from Hugging Face under the MIT license.

## Citation

If you use this model, please cite:

```bibtex
@misc{opus-arc-targum-vocalization,
  author = {John Locke Jr.},
  title = {Aramaic Targum Diacritization (Vocalization) MarianMT Model},
  year = {2025},
  publisher = {Hugging Face},
  journal = {Hugging Face model repository},
  howpublished = {\url{https://huggingface.co/johnlockejrr/opus-arc-targum-vocalization}},
}