M0scode/book-translator-en-zu

A Streamlit app for translating English book excerpts into isiZulu using MarianMT # English to isiZulu Book Translator ## Overview The **English to isiZulu Book Translator** is a machine translation application that converts English text into isiZulu. It is specifically designed to assist in translating educational content and school curriculum materials, helping bridge the language gap for learners whose primary language is isiZulu. The application provides a simple web interface where users can upload English text, translate it paragraph by paragraph, and download the translated output. --- ## Features * Translate English text into isiZulu. * Powered by Facebook's pre-trained **NLLB-200** multilingual translation model. * Paragraph-to-paragraph translation that preserves document structure. * Upload text paragraphs for translation. * Download translated text for offline use. * Simple and user-friendly web interface built with Streamlit. --- ## Technologies Used * Python * Streamlit * Pandas * Hugging Face Transformers * Facebook NLLB-200 Pre-trained Model * AutoTokenizer * PyTorch --- ## Installation ### Prerequisites Before installing the project, ensure you have the following installed: * Python 3.10 or higher * Git ### Clone the Repository ```bash git clone github.com cd english-to-isizulu-book-translator ``` ### Create a Virtual Environment (Recommended) Windows ```bash python -m venv venv venv\Scripts\activate ``` Linux/macOS ```bash python3 -m venv venv source venv/bin/activate ``` ### Install Dependencies ```bash pip install -r requirements.txt ``` If a requirements file is not available, install the main packages manually. ```bash pip install streamlit pandas transformers torch sentencepiece ``` --- ## Running the Application Start the Streamlit application by running: ```bash streamlit run app.py ``` Replace `app.py` with the name of your main application file if different. The application will open automatically in your default web browser. …