faruqeey/sazu-translator

SAZU Language Translator – English, Yoruba, Igbo, Hausa # SAZU Language Translator **SAZU Language Translator** is a web application built with Flask that allows users to translate text between **English, Yoruba, Igbo, and Hausa**. It uses the deep-translator library (Google Translate API) and provides a modern, responsive interface. ## Features - Translate text between English, Yoruba, Igbo, and Hausa. - Automatic source language detection. - Clean, responsive design with a glass‑morphism UI. - Custom error pages for 404 and 500 errors. - Ready for deployment (Render, PythonAnywhere, Heroku). ## Project Structure ``` sazu-translator/ ├── app/ │ ├── api.py # Main Flask application and routes │ ├── form.py # WTForms for translation │ ├── static/ │ │ ├── style.css # Modern CSS styling │ │ └── image/ # (optional) Logo files │ └── templates/ │ ├── base.html # Base template │ ├── index.html # Home page │ ├── trans_page.html # Translation page │ ├── 404.html # 404 error page │ └── 500.html # 500 error page ├── venv/ # Virtual environment (ignored by Git) ├── requirements.txt # Python dependencies ├── Procfile # For deployment (Gunicorn) ├── .gitignore └── README.md ``` ## Installation 1. **Clone the repository:** ```sh git clone github.com cd sazu-translator ``` 2. **Create a virtual environment:** ```sh python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate ``` 3. **Install dependencies:** ```sh pip install -r requirements.txt ``` ## Usage (Local Development) 1. **Run the application:** ```sh python app/api.py ``` 2. **Open your browser and go to:** ``` 127.0.0.1 ``` 3. **Translate text:** - Click **Start Translating →** on the home page. - Select the source and target languages (or leave source as *Detect Language*). - Enter the text you wish to translate. - Click **Translate** to see …