saharkh12/darija-translator

# 🌍 Darija Translator A full-stack LLM-powered RESTful Web Service that translates text to Moroccan Arabic Dialect (Darija). ## 📋 Project Overview This project implements a translation service using the Groq LLM API (Llama 3.3) and exposes it as a Jakarta EE RESTful Web Service deployed on WildFly. ## 🏗️ Architecture - **Backend**: Java REST Service (Jakarta EE / JAX-RS) deployed on WildFly - **LLM**: Groq API with Llama 3.3-70b model - **Authentication**: Basic Authentication (Jakarta Security) - **Clients**: Chrome Extension, PHP Client, Python Client, React Native Mobile App ## 📁 Project Structure darija-translator/ ├── src/ # Java REST Service (Maven) ├── ChromeExtension/ # Chrome Extension (Manifest V3) ├── PHPClient/ # PHP Client ├── PythonClient/ # Python Client └── ReactNativeApp/ # React Native Mobile App ## 🚀 Getting Started ### Prerequisites - JDK 21 - WildFly 39 - Maven - Node.js (for React Native) - PHP/XAMPP (for PHP client) - Python 3 (for Python client) ### Running the REST Service 1. Clone the repository 2. Open in IntelliJ IDEA 3. Configure WildFly server 4. Run the project ### API Endpoint POST localhost Content-Type: text/plain Authorization: Basic (username: translator, password: Translator123!) Body: Text to translate ## 👩‍💻 Author Sahar Kharmaz - Al Akhawayn University