File size: 1,595 Bytes
d16dd2f
369786e
 
d16dd2f
 
 
9c42d8d
d16dd2f
 
369786e
d16dd2f
 
369786e
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
---
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