Najjar07/ai_hausa_english_translator

AI Hausa-English Translator, translate hausa to english and vice versa, created in order to bridge language barrier. # 🌍 AI Hausa ↔ English Translator An AI-powered web application that translates text between **Hausa and English** using modern Natural Language Processing (NLP). This project is built with **Python, Streamlit, and the OpenAI API**, and is designed to support communication and language accessibility in **Northern Nigeria and other Hausa-speaking communities**. --- ## 🚀 Features * 🔤 **Hausa → English translation** * 🔤 **English → Hausa translation** * 🧠 **Few-shot prompting** to improve Hausa translation quality * 📥 **Download translation results** * 🔒 **Secure API key management using `.env`** * ⚡ **Fast web interface built with Streamlit** * 🆓 **Free usage limit (20 translations per session)** --- ## 🛠️ Tech Stack * **Python** * **Streamlit** * **OpenAI API** * **python-dotenv** --- ## 📂 Project Structure ``` ai_hausa_english_translator │ ├── fai_hausa_english_app.py # Main Streamlit application ├── requirements.txt # Project dependencies ├── .gitignore # Files ignored by Git └── README.md # Project documentation ``` --- ## ⚙️ Installation ### 1. Clone the Repository ```bash git clone github.com user name/ai_hausa_english_translator.git cd ai_hausa_english_translator ``` --- ### 2. Install Dependencies ```bash pip install -r requirements.txt ``` --- ### 3. Add Your OpenAI API Key Create a `.env` file in the project root: ``` OPENAI_API_KEY=your_openai_api_key_here ``` --- ### 4. Run the Application ```bash streamlit run app.py ``` The app will open in your browser. --- ## 🌐 Deployment This app can be deployed easily using **Streamlit Community Cloud**. Steps: 1. Push the project to **GitHub** 2. Go to **Streamlit Cloud** 3. Create a new app and connect your repository 4. Add your OpenAI API key in **Secrets** ``` OPENAI_API_KEY="your_api_key" ``` --- ## 💡 Use Cases This translator can be useful for: * 🌍 **Cross-language communication** * …