TlhohonolofatsoSemelane/sesotho-medical-mt

# Sesotho Medical MT Medical text translation between English and Sesotho, built for healthcare workers and patients in Lesotho. > **Medical Disclaimer:** This is a research prototype. Do not use for clinical diagnosis, treatment decisions, or emergency care. All outputs must be reviewed by qualified bilingual or medical personnel before real-world use. --- ## Links | | | |---|---| | **Live App** | sesotho-medical-mt.vercel.a… | | **Backend API** | limpho-sesotho-medical-back… | | **Model on Hugging Face** | Limpho/nllb-finetuned-sesot… | | **Video Demo** | youtu.be | --- ## App Interfaces ### Translator — User View Translate medical text between English and Sesotho. Medical disclaimer shown on load. Users can view translation history, submit feedback, and complete usability testing. --- ### Admin Dashboard — Evaluation Metrics Live BLEU, chrF++, and TER scores computed from the held-out medical test set. Accessible to admin accounts only. --- ## Designs ### Figma Mockups View Figma Mockups ### UI Screenshots | Screen | File | |---|---| | Translator — User View | `docs/screenshots/01_translator.png` | | Evaluation Dashboard — Admin | `docs/screenshots/02_evaluation.png` | --- ## Environment Setup ### Prerequisites | Tool | Version | |---|---| | Python | 3.9 or higher | | Node.js | 18 or higher | | pip | Latest | | Git | Latest | --- ### 1. Clone the Repository ```bash git clone github.com cd sesotho-medical-mt ``` --- ### 2. Backend Setup ```bash # Create and activate virtual environment python -m venv venv # Windows PowerShell venv\Scripts\activate # macOS / Linux source venv/bin/activate # Install dependencies pip install -r backend/requirements.txt # Start the backend cd backend python app.py ``` Backend runs at `localhost` Expected startup output: ``` FAISS index built — 5,000 rows Translation pipel …