Benard-hub440/kikuyu-english

A simple Rep that can help in a startup for Kenyan upcoming devs in contributing to translation of Kenyan indigineous languages using a JSON Dictionary as the database. It also incorporates use of GEMINI as the chatbot and also manual translation. # Lightweight Kikuyu-English Translator Application A lightweight, web-based translation utility designed to facilitate linguistic accessibility for the Kikuyu language. This project leverages Python and the Flask framework to provide a clean, user-centric translation interface. Features * **Web-Based Interface:** Built with Flask and Jinja2 for a responsive and clean user experience. * **Modular Architecture:** Designed for easy expansion of language datasets. * **CLI-First Development:** Built and managed entirely within a Linux environment, ensuring optimal performance and compatibility. ## Tech Stack * **Backend:** Python, FastAPI * **Frontend:** HTML, CSS * **Environment:** Linux (Kali/Debian), Git, Virtual Environments (`venv`) ## Installation & Setup 1. **Clone the repository:** git clone github.com cd kikuyu-english-translator ``` 2.* **Set up a virtual environment:** ```bash python3 -m venv venv source venv/bin/activate ``` 3. **Install dependencies:** pip install -r requirements.txt ``` 4. **Start Ollama and download the local Qwen model (one time):** ```bash ollama serve ollama pull qwen2.5:1.5b ``` 5. **Run the application:** ```bash .venv/bin/python app.py ``` *The application will be accessible at `127.0.0.1`.* The chat assistant uses your local Ollama service with `qwen2.5:1.5b` by default. You can override this in `.env`: ```bash OLLAMA_MODEL=qwen2.5-coder:7b OLLAMA_HOST=127.0.0.1 ``` ## Project Structure **Plaintext** ``` /kikuyu-english-translator ├── app.py # Main Flask application logic chat_bot.helper ├── requirements.txt # Project dependencies ├── /static # CSS and frontend assets ├── /templates # HTML structure files └── README.md # Project documentation ``` ``` ```