README.md

---
title: English to Venda Translator
emoji: 🌍
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.35.0
app_file: app.py
pinned: false
license: apache-2.0
---

# English to Venda Translator 🌍

A Gradio-based web application for translating English text to Venda (Tshivenda) using a fine-tuned NLLB model.

## Features

- **Single Translation**: Translate individual sentences or paragraphs
- **Batch Translation**: Translate multiple sentences at once
- **Adjustable Parameters**: Control translation quality and speed
- **Example Sentences**: Try pre-loaded examples
- **User-friendly Interface**: Clean, intuitive design

## Model

This app uses the `UnarineLeo/nllb_eng_ven_terms` model, which is based on the NLLB (No Language Left Behind) architecture and fine-tuned specifically for English to Venda translation.

## About Venda (Tshivenda)

Venda is a Bantu language spoken by approximately 1.2 million people, primarily in South Africa and Zimbabwe. It is one of the 11 official languages of South Africa.

## Usage

1. **Single Translation**: Enter English text in the input box and click "Translate"
2. **Batch Translation**: Enter multiple sentences (one per line) for bulk translation
3. **Parameters**: Adjust max length and beam search parameters for quality vs speed trade-offs

## Technical Details

- **Model**: UnarineLeo/nllb_eng_ven_terms
- **Framework**: Transformers, PyTorch
- **Interface**: Gradio
- **Language Codes**: eng_Latn → ven_Latn

## Installation

To run locally:

```bash
pip install -r requirements.txt
python app.py
```

## License

Apache 2.0