unnecessary dir

translator_app/manage.py

@@ -1,22 +0,0 @@
-#!/usr/bin/env python
-"""Django's command-line utility for administrative tasks."""
-import os
-import sys
-
-
-def main():
-    """Run administrative tasks."""
-    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'translator_project.settings')
-    try:
-        from django.core.management import execute_from_command_line
-    except ImportError as exc:
-        raise ImportError(
-            "Couldn't import Django. Are you sure it's installed and "
-            "available on your PYTHONPATH environment variable? Did you "
-            "forget to activate a virtual environment?"
-        ) from exc
-    execute_from_command_line(sys.argv)
-
-
-if __name__ == '__main__':
-    main()

translator_app/translator/admin.py

@@ -1,23 +0,0 @@
-from django.contrib import admin
-from .models import Language, TranslationCache, TranslationHistory
-
-
-@admin.register(Language)
-class LanguageAdmin(admin.ModelAdmin):
-    list_display = ('name', 'code', 'native_name', 'is_active')
-    list_filter = ('is_active',)
-    search_fields = ('name', 'native_name', 'code')
-
-
-@admin.register(TranslationHistory)
-class TranslationHistoryAdmin(admin.ModelAdmin):
-    list_display = ('source_text', 'source_language', 'target_language', 'translation_model', 'created_at')
-    list_filter = ('source_language', 'target_language', 'translation_model')
-    search_fields = ('source_text', 'translated_text')
-    readonly_fields = ('character_count', 'word_count', 'created_at')
-
-
-@admin.register(TranslationCache)
-class TranslationCacheAdmin(admin.ModelAdmin):
-    list_display = ('source_text', 'target_language_code', 'access_count', 'last_accessed')
-    search_fields = ('source_text', 'translated_text')

translator_app/translator/apps.py

@@ -1,5 +0,0 @@
-from django.apps import AppConfig
-
-
-class TranslatorConfig(AppConfig):
-    name = 'translator'

translator_app/translator/forms.py

@@ -1,83 +0,0 @@
-# translator/forms.py
-
-from django import forms
-from django.core.validators import MinLengthValidator, MaxLengthValidator
-from .models import Language
-
-class TranslationForm(forms.Form):
-    """Form for translation input"""
-    
-    source_text = forms.CharField(
-        widget=forms.Textarea(attrs={
-            'rows': 5,
-            'placeholder': 'Enter text to translate...',
-            'class': 'form-control',
-            'id': 'source-text'
-        }),
-        validators=[
-            MinLengthValidator(1, message='Text cannot be empty'),
-            MaxLengthValidator(5000, message='Text is too long (maximum 5000 characters)')
-        ],
-        label='Text to Translate'
-    )
-    
-    source_language = forms.ChoiceField(
-        choices=[],
-        required=False,
-        widget=forms.Select(attrs={
-            'class': 'form-select',
-            'id': 'source-language'
-        }),
-        label='Source Language (Optional)'
-    )
-    
-    target_language = forms.ChoiceField(
-        choices=[],
-        widget=forms.Select(attrs={
-            'class': 'form-select',
-            'id': 'target-language'
-        }),
-        label='Target Language'
-    )
-    
-    auto_detect = forms.BooleanField(
-        required=False,
-        initial=True,
-        widget=forms.CheckboxInput(attrs={
-            'class': 'form-check-input',
-            'id': 'auto-detect'
-        }),
-        label='Auto-detect source language'
-    )
-    
-    def __init__(self, *args, **kwargs):
-        super().__init__(*args, **kwargs)
-        
-        # Get languages from database or service
-        from .services.translation_service import TranslationService
-        service = TranslationService()
-        languages = service.get_supported_languages()
-        
-        # Build language choices
-        language_choices = [('', 'Auto-detect')]
-        language_choices += [(lang['code'], lang['name']) for lang in languages]
-        
-        self.fields['source_language'].choices = language_choices
-        self.fields['target_language'].choices = language_choices[1:]  # Exclude auto-detect for target
-        
-        # Set default target language
-        if not self.fields['target_language'].initial:
-            self.fields['target_language'].initial = 'en'
-    
-    def clean(self):
-        cleaned_data = super().clean()
-        source_text = cleaned_data.get('source_text')
-        target_language = cleaned_data.get('target_language')
-        
-        if not source_text:
-            raise forms.ValidationError('Please enter text to translate')
-        
-        if not target_language:
-            raise forms.ValidationError('Please select a target language')
-        
-        return cleaned_data

translator_app/translator/migrations/0001_initial.py

@@ -1,75 +0,0 @@
-# Generated by Django 6.0.7 on 2026-07-22 08:44
-
-import django.db.models.deletion
-import django.utils.timezone
-from django.conf import settings
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
-    initial = True
-
-    dependencies = [
-        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
-    ]
-
-    operations = [
-        migrations.CreateModel(
-            name='Language',
-            fields=[
-                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
-                ('code', models.CharField(max_length=10, unique=True)),
-                ('name', models.CharField(max_length=50)),
-                ('native_name', models.CharField(blank=True, max_length=50)),
-                ('is_active', models.BooleanField(default=True)),
-                ('created_at', models.DateTimeField(auto_now_add=True)),
-                ('updated_at', models.DateTimeField(auto_now=True)),
-            ],
-            options={
-                'verbose_name': 'Language',
-                'verbose_name_plural': 'Languages',
-                'ordering': ['name'],
-            },
-        ),
-        migrations.CreateModel(
-            name='TranslationCache',
-            fields=[
-                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
-                ('source_text_hash', models.CharField(max_length=64, unique=True)),
-                ('source_text', models.TextField()),
-                ('translated_text', models.TextField()),
-                ('source_language_code', models.CharField(max_length=10)),
-                ('target_language_code', models.CharField(max_length=10)),
-                ('created_at', models.DateTimeField(auto_now_add=True)),
-                ('last_accessed', models.DateTimeField(auto_now=True)),
-                ('access_count', models.IntegerField(default=0)),
-            ],
-            options={
-                'verbose_name': 'Translation Cache',
-                'verbose_name_plural': 'Translation Caches',
-                'indexes': [models.Index(fields=['source_text_hash', 'target_language_code'], name='translator__source__c37921_idx')],
-            },
-        ),
-        migrations.CreateModel(
-            name='TranslationHistory',
-            fields=[
-                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
-                ('source_text', models.TextField()),
-                ('translated_text', models.TextField()),
-                ('detected_source_language', models.CharField(blank=True, max_length=10)),
-                ('character_count', models.IntegerField(default=0)),
-                ('word_count', models.IntegerField(default=0)),
-                ('created_at', models.DateTimeField(default=django.utils.timezone.now)),
-                ('source_language', models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='source_translations', to='translator.language')),
-                ('target_language', models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='target_translations', to='translator.language')),
-                ('user', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='translations', to=settings.AUTH_USER_MODEL)),
-            ],
-            options={
-                'verbose_name': 'Translation History',
-                'verbose_name_plural': 'Translation Histories',
-                'ordering': ['-created_at'],
-                'indexes': [models.Index(fields=['user', '-created_at'], name='translator__user_id_18b742_idx')],
-            },
-        ),
-    ]

translator_app/translator/migrations/0002_translationhistory_translation_model.py

@@ -1,15 +0,0 @@
-# Generated by Django 6.0.7 on 2026-07-22
-
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-    dependencies = [('translator', '0001_initial')]
-
-    operations = [
-        migrations.AddField(
-            model_name='translationhistory',
-            name='translation_model',
-            field=models.CharField(blank=True, max_length=100),
-        ),
-    ]

translator_app/translator/migrations/__init__.py

@@ -1 +0,0 @@
- 

translator_app/translator/models.py

@@ -1,91 +0,0 @@
-# translator/models.py
-
-from django.db import models
-from django.contrib.auth.models import User
-from django.utils import timezone
-
-class Language(models.Model):
-    """Model to store supported languages"""
-    code = models.CharField(max_length=10, unique=True)
-    name = models.CharField(max_length=50)
-    native_name = models.CharField(max_length=50, blank=True)
-    is_active = models.BooleanField(default=True)
-    created_at = models.DateTimeField(auto_now_add=True)
-    updated_at = models.DateTimeField(auto_now=True)
-
-    class Meta:
-        ordering = ['name']
-        verbose_name = 'Language'
-        verbose_name_plural = 'Languages'
-
-    def __str__(self):
-        return f"{self.name} ({self.code})"
-
-class TranslationHistory(models.Model):
-    """Model to store translation history"""
-    user = models.ForeignKey(
-        User, 
-        on_delete=models.CASCADE, 
-        null=True, 
-        blank=True,
-        related_name='translations'
-    )
-    source_text = models.TextField()
-    translated_text = models.TextField()
-    source_language = models.ForeignKey(
-        Language,
-        on_delete=models.SET_NULL,
-        null=True,
-        related_name='source_translations'
-    )
-    target_language = models.ForeignKey(
-        Language,
-        on_delete=models.SET_NULL,
-        null=True,
-        related_name='target_translations'
-    )
-    detected_source_language = models.CharField(max_length=10, blank=True)
-    translation_model = models.CharField(max_length=100, blank=True)
-    character_count = models.IntegerField(default=0)
-    word_count = models.IntegerField(default=0)
-    created_at = models.DateTimeField(default=timezone.now)
-    
-    class Meta:
-        ordering = ['-created_at']
-        verbose_name = 'Translation History'
-        verbose_name_plural = 'Translation Histories'
-        indexes = [
-            models.Index(fields=['user', '-created_at']),
-        ]
-
-    def __str__(self):
-        user_str = self.user.username if self.user else 'Anonymous'
-        return f"{user_str} - {self.source_text[:50]}... -> {self.target_language}"
-
-    def save(self, *args, **kwargs):
-        """Calculate character and word counts before saving"""
-        if self.source_text:
-            self.character_count = len(self.source_text)
-            self.word_count = len(self.source_text.split())
-        super().save(*args, **kwargs)
-
-class TranslationCache(models.Model):
-    """Model to cache translations for performance"""
-    source_text_hash = models.CharField(max_length=64, unique=True)
-    source_text = models.TextField()
-    translated_text = models.TextField()
-    source_language_code = models.CharField(max_length=10)
-    target_language_code = models.CharField(max_length=10)
-    created_at = models.DateTimeField(auto_now_add=True)
-    last_accessed = models.DateTimeField(auto_now=True)
-    access_count = models.IntegerField(default=0)
-
-    class Meta:
-        verbose_name = 'Translation Cache'
-        verbose_name_plural = 'Translation Caches'
-        indexes = [
-            models.Index(fields=['source_text_hash', 'target_language_code']),
-        ]
-
-    def __str__(self):
-        return f"{self.source_text[:50]}... -> {self.target_language_code}"

translator_app/translator/services/language_support.py

@@ -1,104 +0,0 @@
-# translator/services/language_support.py
-"""
-Explicit per-model language support.
-
-This is deliberately separate from `TranslationService.NLLB_LANGUAGE_CODES`
-in translation_service.py. That dict answers "does the model API have a wire
-code for this language at all". This file answers a different question:
-"does this specific model actually produce usable output for this language",
-which is what was silently broken.
-
-TWO CONCRETE BUGS THIS FIXES
------------------------------
-1. "luo" has no valid FLORES-200 / SALT tag. ISO 639-2 "luo" is a
-   *macrolanguage* umbrella covering Dholuo, Lango, Alur, Adhola and Acholi
-   as distinct languages - it was never a real NLLB/MADLAD language code.
-   That's why translation requests tagged "luo" against nllb / nllb_1_3b /
-   madlad were failing outright: "luo_Latn" doesn't exist on the model's
-   side. If you meant Acholi, that's already covered correctly by "ach".
-   If you specifically need Dholuo/Lango/Alur, none of your current local
-   models support them - only the Google/DeepL fallback paths can.
-
-2. Your language roster (English, Swahili, Luganda, Runyankole, Acholi,
-   Ateso, Lugbara) lines up closely with the Sunbird SALT East African
-   language project rather than any generic multilingual checkpoint. If
-   your deployed HF Space is a SALT-style fine-tune of NLLB, MADLAD-400
-   (a separate, generically-trained Google model) very likely was never
-   fine-tuned on those five Ugandan low-resource languages at all, even
-   though the UI happily offered them for every model.
-
-HOW TO VERIFY / MAINTAIN THIS
-------------------------------
-This table is a best-effort starting point, not a guarantee - I can't see
-your actual deployed HF Space's training data. Two ways to firm it up:
-  a) If your Space exposes a /languages or /health endpoint listing what
-     it was actually fine-tuned/evaluated on, wire `_languages()` in
-     views.py to read it live instead of hardcoding this table.
-  b) Otherwise, test each (model, language) pair once against your Space
-     and adjust the sets below accordingly - a wrong entry here just means
-     a language gets offered when it shouldn't (or hidden when it's fine),
-     not a crash, since translate_api() falls back to Google either way.
-"""
-
-# None = unrestricted (accepts any language pair the frontend can offer).
-MODEL_LANGUAGE_SUPPORT = {
-    "nllb": {"en", "sw", "lg", "nyn", "ach", "teo", "lgg", "rw", "fr", "ar"},
-    "nllb_1_3b": {"en", "sw", "lg", "nyn", "ach", "teo", "lgg", "rw", "fr", "ar"},
-    # Not fine-tuned on the five Ugandan low-resource languages - confirm
-    # against your Space and trim further if it's even narrower than this.
-    "madlad": {"en", "sw", "rw", "fr", "ar"},
-    # DeepL has no coverage at all for sw/lg/nyn/ach/teo/lgg/rw.
-    "deepl_fallback": {"en", "fr", "ar"},
-    "google": None,
-}
-
-FALLBACK_MODEL = "google"
-
-# ElevenLabs eleven_multilingual_v2's real language list (per their docs as
-# of mid-2026). None of your East African languages are on it - only en/fr/ar
-# from your roster are. Requests for anything else should never hit the
-# ElevenLabs API; fall back to the browser's speechSynthesis instead.
-ELEVENLABS_MULTILINGUAL_V2_LANGUAGES = {
-    "en", "zh", "es", "hi", "pt", "fr", "de", "ja", "ar", "ko", "id", "it",
-    "nl", "tr", "pl", "sv", "fil", "ms", "ru", "ro", "uk", "el", "cs", "da",
-    "fi", "bg", "hr", "sk", "ta",
-}
-
-ELEVENLABS_V3_LANGUAGES = {
-    "af", "sq", "am", "ar", "hy", "as", "az", "ba", "eu", "be", 
-    "bn", "bos", "bg", "my", "ca", "ceb", "ny", "zh", "hr", "cs", 
-    "da", "nl", "en", "eo", "et", "fil", "fi", "fr", "gl", "ka", 
-    "de", "el", "gu", "ht", "ha", "haw", "he", "hi", "hmn", "hu", 
-    "is", "ig", "id", "ga", "it", "ja", "jv", "kn", "kk", "km", 
-    "rw", "ko", "ku", "ky", "lo", "la", "lv", "ln", "lt", "lb", 
-    "mk", "mg", "ms", "ml", "mt", "mi", "mr", "mn", "ne", "no", 
-    "or", "om", "ps", "fa", "pl", "pt", "pa", "ro", "ru", "sm", 
-    "gd", "sr", "st", "sn", "sd", "si", "sk", "sl", "so", "es", 
-    "su", "sw", "sv", "tg", "ta", "tt", "te", "th", "tr", "tk", 
-    "uk", "ur", "ug", "uz", "vi", "cy", "xh", "yi", "yo", "zu"
-}
-
-
-
-def supported_codes(model):
-    """Set of codes a model supports, or None if unrestricted."""
-    return MODEL_LANGUAGE_SUPPORT.get(model, set())
-
-
-def model_supports(model, *codes):
-    """True if `model` supports every non-empty code given."""
-    allowed = supported_codes(model)
-    if allowed is None:
-        return True
-    return all(code in allowed for code in codes if code)
-
-
-def resolve_model(requested_model, source_code, target_code):
-    """
-    Return (model_to_use, fell_back). If the requested model can't handle
-    this language pair, silently route to the Google fallback rather than
-    erroring, and tell the caller that happened.
-    """
-    if model_supports(requested_model, source_code, target_code):
-        return requested_model, False
-    return FALLBACK_MODEL, True

translator_app/translator/services/translation_service.py

@@ -1,270 +0,0 @@
-"""Translation providers behind one stable application-level contract."""
-
-import hashlib
-import logging
-
-import requests
-from django.conf import settings
-from django.utils import timezone
-
-from ..models import TranslationCache
-from langdetect import detect, DetectorFactory, LangDetectException
-
-logger = logging.getLogger(__name__)
-DetectorFactory.seed = 0
-
-
-class TranslationService:
-    """Run the selected ML model, with an optional DeepL-compatible fallback."""
-
-    # NLLB requires its FLORES language tags. MADLAD accepts ISO language codes.
-    NLLB_LANGUAGE_CODES = {
-        "en": "eng_Latn",
-        "sw": "swh_Latn",
-        "lg": "lug_Latn",
-        "luo": "luo_Latn",
-        "nyn": "nyn_Latn",
-        "ach": "ach_Latn",
-        "teo": "teo_Latn",
-        "lgg": "lgg_Latn",
-        "rw": "kin_Latn",
-        "fr": "fra_Latn",
-        "ar": "arb_Arab",
-    }
-
-    def __init__(self):
-        self.supported_languages = self._get_supported_languages()
-
-    def _get_supported_languages(self):
-        return {
-            "en": "English",
-            "sw": "Swahili (Kiswahili)",
-            "lg": "Luganda (Ganda)",
-            "luo": "Luo (Acholi / Lango)",
-            "nyn": "Runyankole / Rukiga",
-            "ach": "Acholi",
-            "teo": "Ateso (Teso)",
-            "lgg": "Lugbara",
-            "rw": "Kinyarwanda",
-            "fr": "French",
-            "ar": "Arabic",
-        }
-
-    def get_supported_languages(self):
-        return [
-            {"code": code, "name": name}
-            for code, name in self.supported_languages.items()
-        ]
-
-    def detect_language(self, text):
-        try:
-            code = detect(text)
-        except LangDetectException:
-            code = "en"
-        if code not in self.supported_languages:
-            code = "en"  # fall back if detected language isn't one you support
-        return {
-            "code": code,
-            "name": self.supported_languages.get(code, code.upper()),
-            "confidence": 0.8 if code in self.supported_languages else 0.3,
-        }
-
-    def translate(self, text, target_language, source_language=None, model=None):
-        if not text or not text.strip():
-            return {"error": "Text cannot be empty"}
-
-        model = model or settings.TRANSLATION_DEFAULT_MODEL
-        if model == "madlad":
-            source_language = None  # MADLAD auto-detects; any provided value is ignored
-        source_language = source_language or self.detect_language(text)["code"]
-        cache_key = self._generate_cache_key(
-            text, source_language, target_language, model
-        )
-        cached = self._get_from_cache(cache_key)
-        if cached:
-            cached["model"] = model
-            return cached
-
-        if model == "deepl_fallback":
-            outcome = self._translate_deepl(text, source_language, target_language)
-        elif model == "google":
-            # Explicit, user-selectable Google fallback. Reuses the exact
-            # same free-fallback call already used internally elsewhere in
-            # this class - no new translation logic introduced.
-            outcome = self._translate_free_fallback(
-                text, source_language, target_language
-            )
-        elif model in settings.TRANSLATION_MODEL_ENGINES:
-            outcome = self._translate_model_api(
-                text, source_language, target_language, model
-            )
-        else:
-            return {"error": "The selected translation model is unavailable."}
-
-        if outcome.get("error"):
-            return outcome
-
-        translated_text = outcome["translated_text"]
-        self._save_to_cache(
-            cache_key, text, translated_text, source_language, target_language
-        )
-        return {
-            "source_text": text,
-            "translated_text": translated_text,
-            "source_language": source_language,
-            "target_language": target_language,
-            "model": model,
-        }
-
-    def _translate_model_api(self, text, source_language, target_language, model):
-        if not settings.MODEL_API_URL:
-            logger.info("MODEL_API_URL not set; falling back to free translation engine.")
-            return self._translate_free_fallback(text, source_language, target_language)
-
-        if isinstance(settings.TRANSLATION_MODEL_ENGINES, dict):
-            engine_name = settings.TRANSLATION_MODEL_ENGINES.get(model, model)
-        else:
-            engine_name = model
-
-        # Every local engine (NLLB, MADLAD) speaks FLORES-200 codes on the wire.
-        try:
-            source = self.NLLB_LANGUAGE_CODES[source_language]
-            target = self.NLLB_LANGUAGE_CODES[target_language]
-        except KeyError:
-            return {
-                "error": "The model service does not support one of these languages."
-            }
-
-        payload = {
-            "text": text,
-            "source": source,
-            "target": target,
-            "engine": engine_name,
-        }
-
-        # DEBUGGING: Print exactly what is being sent to the console
-        print(
-            f"\n--- API PAYLOAD DEBUG ---\nURL: {settings.MODEL_API_URL}\nPayload: {payload}\n-------------------------\n"
-        )
-        logger.info(f"Sending translation payload: {payload}")
-
-        try:
-            response = requests.post(
-                settings.MODEL_API_URL,
-                json=payload,
-                timeout=3,
-            )
-
-            if response.status_code != 200:
-                logger.warning(
-                    "Model API translation failed: %s %s",
-                    response.status_code,
-                    response.text,
-                )
-                return self._translate_free_fallback(text, source_language, target_language)
-
-            translated_text = response.json().get("translation")
-            if not translated_text:
-                return self._translate_free_fallback(text, source_language, target_language)
-            return {"translated_text": translated_text}
-
-        except (requests.exceptions.Timeout, requests.exceptions.ConnectionError):
-            logger.warning("ML translation service unreachable; falling back to free translation engine.")
-            return self._translate_free_fallback(text, source_language, target_language)
-        except (ValueError, requests.RequestException) as error:
-            logger.exception("Model API translation failed: %s", error)
-            return self._translate_free_fallback(text, source_language, target_language)
-
-    def _translate_free_fallback(self, text, source_language, target_language):
-        """Free public fallback translation when the ML model API is unconfigured/unavailable."""
-        try:
-            url = "https://translate.googleapis.com/translate_a/single"
-            params = {
-                "client": "gtx",
-                "sl": source_language or "auto",
-                "tl": target_language,
-                "dt": "t",
-                "q": text,
-            }
-            res = requests.get(url, params=params, timeout=10)
-            if res.status_code == 200:
-                data = res.json()
-                translated_text = "".join([chunk[0] for chunk in data[0] if chunk[0]])
-                if translated_text:
-                    return {"translated_text": translated_text}
-        except Exception as err:
-            logger.warning("Free fallback translation failed: %s", err)
-
-        return {
-            "error": "Translation service is currently unavailable. Please check your network or backend settings."
-        }
-
-    def _translate_deepl(self, text, source_language, target_language):
-        if not settings.TRANSLATION_API_KEY:
-            return {"error": "Traditional fallback is not configured."}
-        try:
-            response = requests.post(
-                settings.TRANSLATION_API_URL,
-                headers={
-                    "Authorization": f"DeepL-Auth-Key {settings.TRANSLATION_API_KEY}"
-                },
-                json={
-                    "text": [text],
-                    "source_lang": source_language.upper(),
-                    "target_lang": target_language.upper(),
-                },
-                timeout=30,
-            )
-            if response.status_code != 200:
-                return {
-                    "error": "The fallback translation service could not complete this request."
-                }
-            translated_text = response.json()["translations"][0]["text"]
-            return {"translated_text": translated_text}
-        except (KeyError, IndexError, ValueError, requests.RequestException) as error:
-            logger.exception("Fallback translation failed: %s", error)
-            return {
-                "error": "The fallback translation service returned an invalid response."
-            }
-
-    @staticmethod
-    def _generate_cache_key(text, source_language, target_language, model):
-        content = f"{text}|{source_language}|{target_language}|{model}"
-        return hashlib.sha256(content.encode("utf-8")).hexdigest()
-
-    @staticmethod
-    def _get_from_cache(cache_key):
-        try:
-            entry = TranslationCache.objects.filter(source_text_hash=cache_key).first()
-            if not entry:
-                return None
-            entry.access_count += 1
-            entry.last_accessed = timezone.now()
-            entry.save(update_fields=["access_count", "last_accessed"])
-            return {
-                "source_text": entry.source_text,
-                "translated_text": entry.translated_text,
-                "source_language": entry.source_language_code,
-                "target_language": entry.target_language_code,
-                "from_cache": True,
-            }
-        except Exception:
-            logger.exception("Translation cache lookup failed")
-            return None
-
-    @staticmethod
-    def _save_to_cache(
-        cache_key, source_text, translated_text, source_language, target_language
-    ):
-        try:
-            TranslationCache.objects.update_or_create(
-                source_text_hash=cache_key,
-                defaults={
-                    "source_text": source_text,
-                    "translated_text": translated_text,
-                    "source_language_code": source_language,
-                    "target_language_code": target_language,
-                },
-            )
-        except Exception:
-            logger.exception("Translation cache save failed")

translator_app/translator/templates/translator/base.html

@@ -1,21 +0,0 @@
-{% load static %}
-<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>{% block title %}The Translator App{% endblock %}</title>
-  <script src="https://cdn.tailwindcss.com?plugins=forms"></script>
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:wght@500;600;700;800&family=Plus+Jakarta+Sans:wght@400;500;600;700&display=swap" rel="stylesheet">
-  <script>tailwind.config={theme:{extend:{colors:{primary:'#84532e',ink:'#22303a',cream:'#fffaf6',sand:'#ffbe91',mist:'#f3e9e1'},fontFamily:{display:['Bricolage Grotesque'],body:['Plus Jakarta Sans']}}}}</script>
-  <style>body{background:#fffaf6}.quiet-loading:after{content:'';position:absolute;bottom:0;left:0;width:100%;height:2px;background:linear-gradient(90deg,transparent,#84532e,transparent);animation:load 1.4s infinite}@keyframes load{from{transform:translateX(-100%)}to{transform:translateX(100%)}}</style>
-  {% block extra_head %}{% endblock %}
-</head>
-<body class="min-h-screen font-body text-ink flex flex-col">
-  <header class="w-full max-w-6xl mx-auto px-5 pt-9 pb-7 text-center">
-    <a href="{% url 'translator:translator' %}" class="font-display text-3xl md:text-5xl font-extrabold tracking-tight text-primary">The Translator App</a>
-  </header>
-  {% block content %}{% endblock %}
-  <footer class="py-10 text-center text-sm text-stone-500"><p>© {% now 'Y' %} The Translator App</p></footer>
-</body>
-</html>

translator_app/translator/templates/translator/history.html

@@ -1,9 +0,0 @@
-{% extends 'translator/base.html' %}
-{% block title %}History · The Translator App{% endblock %}
-{% block content %}
-<main class="flex-1 w-full max-w-3xl mx-auto px-5 pb-12">
-  <div class="mb-7 flex items-center justify-between"><h1 class="font-display text-3xl font-bold text-primary">History</h1>{% if translations %}<form method="post" action="{% url 'translator:clear_history' %}">{% csrf_token %}<button class="text-sm font-bold text-red-700 hover:underline">Clear all</button></form>{% endif %}</div>
-  <div class="space-y-4">{% for item in translations %}<article class="group rounded-xl border border-stone-100 bg-white p-5 shadow-sm"><div class="mb-3 flex justify-between gap-4 text-xs font-bold uppercase tracking-wider text-stone-400"><span>{{ item.source_language.name|default:item.detected_source_language|default:'Detected' }} → {{ item.target_language.name|default:'Unknown' }}</span><time>{{ item.created_at|timesince }} ago</time></div><p class="text-stone-700">{{ item.source_text }}</p><p class="mt-2 font-medium italic text-primary">{{ item.translated_text }}</p><div class="mt-3 flex items-center justify-between"><span class="text-xs text-stone-400">{{ item.model_label|default:'Translation' }}</span><form method="post" action="{% url 'translator:delete_history' item.pk %}">{% csrf_token %}<button class="text-xs font-bold text-stone-400 hover:text-red-700">Delete</button></form></div></article>{% empty %}<div class="rounded-xl border border-dashed border-stone-300 p-12 text-center text-stone-500">No translations yet. <a class="font-bold text-primary underline" href="{% url 'translator:translator' %}">Start translating</a>.</div>{% endfor %}</div>
-  <div class="mt-10 text-center"><a class="rounded-full bg-primary px-6 py-3 text-sm font-bold text-white" href="{% url 'translator:translator' %}">Back to translate</a></div>
-</main>
-{% endblock %}

translator_app/translator/templates/translator/translator.html

@@ -1,458 +0,0 @@
-{% extends 'translator/base.html' %}
-{% block content %}
-<main class="flex-1 w-full max-w-5xl mx-auto px-5 pb-12">
-  <form id="translation-form">
-    {% csrf_token %}
-    {{ model_language_support_json|json_script:"model-language-support" }}
-    {{ elevenlabs_languages_json|json_script:"elevenlabs-languages" }}
-    
-    <!-- Header Control Bar -->
-    <div class="flex flex-wrap justify-center items-center gap-3 mb-6">
-      <select id="source-language" aria-label="Source language"
-        class="rounded-full border-stone-200 bg-white px-5 py-2.5 text-sm font-semibold text-primary shadow-sm focus:border-primary focus:ring-primary transition hover:border-stone-300">
-        <option value="">Detect language</option>
-        {% for language in languages %}
-        <option value="{{ language.code }}" {% if language.code == 'en' %}selected{% endif %}>
-          {{ language.name }}
-        </option>
-        {% endfor %}
-      </select>
-      
-      <button id="swap-languages" type="button" title="Swap languages"
-        class="rounded-full bg-sand px-3 py-2.5 text-primary shadow-sm transition hover:rotate-180 hover:bg-stone-200">⇄</button>
-      
-      <select id="target-language" aria-label="Target language"
-        class="rounded-full border-stone-200 bg-white px-5 py-2.5 text-sm font-semibold text-primary shadow-sm focus:border-primary focus:ring-primary transition hover:border-stone-300">
-        {% for language in languages %}
-        <option value="{{ language.code }}" {% if language.code == 'sw' %} selected{% endif%}>
-          {{ language.name }}
-        </option>
-        {% endfor %}
-      </select>
-      
-      <label
-        class="flex items-center gap-2 rounded-full border border-stone-200 bg-white px-4 py-2 text-sm font-semibold text-stone-600 shadow-sm">
-        <span class="text-xs uppercase tracking-wider text-stone-400">Model</span>
-        <select id="translation-model" aria-label="Translation model"
-          class="border-0 bg-transparent py-0 pl-1 pr-7 text-primary font-bold focus:ring-0">
-          {% for value, label in models %}
-          <option value="{{ value }}" {% if value == default_model %} selected{% endif %}>
-            {{ label }}
-          </option>
-          {% endfor %}
-        </select>
-      </label>
-    </div>
-
-    <!-- Main Translation Panels -->
-    <div class="rounded-3xl border border-stone-200 bg-white p-5 md:p-8 shadow-2xl shadow-stone-200/50 md:flex md:gap-8 transition-all">
-      <!-- Source Panel -->
-      <section class="flex min-h-72 flex-1 flex-col">
-        <div class="mb-3 flex items-center justify-between">
-          <span class="text-xs font-bold uppercase tracking-widest text-stone-400">Source Text</span>
-          <button id="listen-source" type="button" title="Listen to source text"
-            class="hidden items-center gap-1 rounded-full bg-mist px-3 py-1 text-xs font-bold text-primary hover:bg-stone-200 transition">
-            🔊 Listen
-          </button>
-        </div>
-        <textarea id="source-text" maxlength="5000"
-          class="min-h-52 w-full flex-1 resize-none border-0 p-0 font-display text-2xl leading-relaxed text-primary placeholder:text-stone-300 focus:ring-0"
-          placeholder="Type or use the Voice Assistant below to dictate..."></textarea>
-        
-        <!-- Source Footer Bar with Text Translate Button -->
-        <div class="mt-4 flex items-center justify-between border-t border-stone-100 pt-3 text-xs text-stone-400">
-          <div class="flex items-center gap-3">
-            <button id="clear-source" type="button" class="font-semibold text-primary hover:underline">Clear text</button>
-            <span id="character-count">0 / 5000 characters</span>
-          </div>
-          <button id="translate-text-btn" type="submit"
-            class="translate-trigger flex items-center gap-1.5 rounded-full bg-primary px-5 py-2 text-xs font-bold uppercase tracking-wider text-white shadow-md shadow-primary/20 transition hover:scale-105 active:scale-95 disabled:cursor-wait disabled:opacity-70">
-            <span>✨</span> <span>Translate Text</span>
-          </button>
-        </div>
-      </section>
-
-      <div class="my-5 hidden w-px bg-stone-100 md:block"></div>
-
-      <!-- Translation Output Panel -->
-      <section class="relative flex min-h-72 flex-1 flex-col">
-        <div class="mb-3 flex items-center justify-between">
-          <span class="text-xs font-bold uppercase tracking-widest text-stone-400">Translation</span>
-          <div class="flex items-center gap-2">
-            <button id="listen-result" type="button" title="Listen to translation"
-              class="hidden items-center gap-1 rounded-full bg-mist px-3 py-1 text-xs font-bold text-primary hover:bg-stone-200 transition">
-              🔊 Listen
-            </button>
-            <button id="copy-result" type="button"
-              class="hidden rounded-full bg-mist px-3 py-1 text-xs font-bold text-primary hover:bg-stone-200 transition">
-              Copy
-            </button>
-          </div>
-        </div>
-        <p id="translated-text" aria-live="polite"
-          class="relative flex-1 whitespace-pre-wrap font-display text-2xl leading-relaxed text-primary"><span class="text-stone-300">Your translation will appear here.</span>
-        </p>
-        <p id="result-meta" class="mt-4 text-xs text-stone-400 border-t border-stone-100 pt-3"></p>
-      </section>
-    </div>
-
-    <!-- Modern Voice Assistant Chatbot Card -->
-    <div class="mt-6 rounded-3xl border border-stone-200/80 bg-gradient-to-br from-stone-50 via-white to-sand/40 p-5 md:p-6 shadow-xl shadow-stone-200/40">
-      <div class="flex flex-col md:flex-row items-center justify-between gap-5">
-        
-        <!-- Left Info & Waveform -->
-        <div class="flex items-center gap-4 text-center md:text-left">
-          <!-- Mic Floating Action Hub -->
-          <div class="relative">
-            <button id="voice-record" type="button" title="Toggle Voice Dictation"
-              class="relative z-10 flex h-12 w-12 items-center justify-center rounded-full bg-primary text-xl text-white shadow-md shadow-primary/30 transition-all hover:scale-105 active:scale-95 focus:outline-none">
-              <span id="mic-icon">🎙️</span>
-            </button>
-            <!-- Animated Pulsing Ring when Recording -->
-            <span id="pulse-ring" class="hidden absolute inset-0 -z-10 rounded-full bg-red-400/40 animate-ping"></span>
-          </div>
-
-          <div>
-            <div class="flex items-center gap-2 justify-center md:justify-start">
-              <h3 id="record-status-heading" class="font-display font-bold text-primary text-sm">Voice AI Assistant</h3>
-              <span id="recording-badge" class="hidden rounded-full bg-red-100 px-2 py-0.5 text-[10px] font-bold uppercase text-red-700 animate-pulse">
-                🔴 Live Dictating
-              </span>
-            </div>
-            <p id="record-subtext" class="text-xs text-stone-500 mt-0.5">Tap the mic to dictate live in any supported language.</p>
-          </div>
-        </div>
-
-        <!-- Center Sound Wave Visualization (Appears when active) -->
-        <div id="sound-wave" class="hidden flex items-center gap-1.5 h-6">
-          <span class="w-1 bg-primary rounded-full animate-[bounce_1s_infinite_100ms] h-3"></span>
-          <span class="w-1 bg-primary rounded-full animate-[bounce_1s_infinite_300ms] h-6"></span>
-          <span class="w-1 bg-primary rounded-full animate-[bounce_1s_infinite_200ms] h-4"></span>
-          <span class="w-1 bg-primary rounded-full animate-[bounce_1s_infinite_400ms] h-6"></span>
-          <span class="w-1 bg-primary rounded-full animate-[bounce_1s_infinite_150ms] h-3"></span>
-        </div>
-
-        <!-- Dedicated Voice Translate Action Button -->
-        <div class="flex items-center gap-2">
-          <button id="translate-voice-btn" type="submit"
-            class="translate-trigger flex items-center gap-1.5 rounded-full bg-primary px-5 py-2 text-xs font-bold uppercase tracking-wider text-white shadow-md shadow-primary/20 transition hover:scale-105 active:scale-95 disabled:cursor-wait disabled:opacity-70">
-            <span>⚡</span> <span>Translate Voice</span>
-          </button>
-        </div>
-      </div>
-    </div>
-
-    <!-- Alert / Message bar -->
-    <div class="mt-4 text-center">
-      <p id="form-message" role="alert" class="min-h-5 text-sm font-semibold text-red-600"></p>
-    </div>
-  </form>
-
-  <!-- History Footer Navigation -->
-  <div class="mt-10 text-center">
-    <a href="{% url 'translator:history' %}"
-      class="inline-flex items-center gap-2 rounded-full border border-stone-200 bg-white px-6 py-2.5 text-sm font-bold text-primary shadow-sm hover:bg-sand transition">
-      📜 View Translation History
-    </a>
-  </div>
-</main>
-
-<script>
-  const form = document.querySelector('#translation-form'), source = document.querySelector('#source-text'), result = document.querySelector('#translated-text'), message = document.querySelector('#form-message'), button = document.querySelector('#translate-button'), count = document.querySelector('#character-count');
-  const csrf = document.querySelector('[name=csrfmiddlewaretoken]').value;
-  const modelSelect = document.querySelector('#translation-model');
-  const sourceSelect = document.querySelector('#source-language');
-  const targetSelect = document.querySelector('#target-language');
-  const recordBtn = document.querySelector('#voice-record');
-  const micIcon = document.querySelector('#mic-icon');
-  const pulseRing = document.querySelector('#pulse-ring');
-  const recordBadge = document.querySelector('#recording-badge');
-  const recordSubtext = document.querySelector('#record-subtext');
-  const soundWave = document.querySelector('#sound-wave');
-  const listenSourceBtn = document.querySelector('#listen-source');
-  const listenResultBtn = document.querySelector('#listen-result');
-  const copyBtn = document.querySelector('#copy-result');
-
-  // --- Model-aware language filtering ------------------------------------
-  // modelLanguageSupport: { model_code: [lang codes] | null (unrestricted) }
-  const modelLanguageSupport = JSON.parse(document.querySelector('#model-language-support').textContent);
-  const elevenlabsLanguages = new Set(JSON.parse(document.querySelector('#elevenlabs-languages').textContent));
-
-  function supportedSet(model) {
-    const codes = modelLanguageSupport[model];
-    return codes === null || codes === undefined ? null : new Set(codes);
-  }
-
-  // Hide (not remove) options unsupported by the current model, so swapping
-  // models back later doesn't lose the full list. Always keeps "Detect
-  // language" (empty value) visible in the source select.
-  function filterSelectForModel(selectEl, allowed) {
-    let selectedStillValid = false;
-    Array.from(selectEl.options).forEach(opt => {
-      const ok = !opt.value || allowed === null || allowed.has(opt.value);
-      opt.hidden = !ok;
-      opt.disabled = !ok;
-      if (ok && opt.value === selectEl.value) selectedStillValid = true;
-    });
-    if (!selectedStillValid) {
-      const firstOk = Array.from(selectEl.options).find(o => !o.hidden && o.value);
-      if (firstOk) selectEl.value = firstOk.value;
-    }
-  }
-
-  function syncLanguagesForModel() {
-    const isMadlad = modelSelect.value === 'madlad';
-    sourceSelect.disabled = isMadlad;
-    if (isMadlad) sourceSelect.value = '';
-
-    const allowed = supportedSet(modelSelect.value);
-    filterSelectForModel(targetSelect, allowed);
-    if (!isMadlad) filterSelectForModel(sourceSelect, allowed);
-  }
-
-  // If the person picks a language the current model can't handle, hop the
-  // model dropdown to Google fallback automatically rather than letting the
-  // request fail server-side.
-  function ensureModelSupportsSelection() {
-    const allowed = supportedSet(modelSelect.value);
-    if (allowed === null) return;
-    const srcOk = modelSelect.value === 'madlad' || !sourceSelect.value || allowed.has(sourceSelect.value);
-    const tgtOk = !targetSelect.value || allowed.has(targetSelect.value);
-    if (!srcOk || !tgtOk) {
-      modelSelect.value = 'google';
-      syncLanguagesForModel();
-      message.textContent = 'Switched to Google Translate (fallback) - the previous model doesn\'t support this language.';
-    }
-  }
-
-  modelSelect.addEventListener('change', syncLanguagesForModel);
-  sourceSelect.addEventListener('change', ensureModelSupportsSelection);
-  targetSelect.addEventListener('change', ensureModelSupportsSelection);
-  syncLanguagesForModel();
-
-  function updateSourceControls() {
-    count.textContent = `${source.value.length} / 5000 characters`;
-    if (source.value.trim().length > 0) {
-      listenSourceBtn.classList.remove('hidden');
-      listenSourceBtn.classList.add('inline-flex');
-    } else {
-      listenSourceBtn.classList.add('hidden');
-      listenSourceBtn.classList.remove('inline-flex');
-    }
-  }
-  source.addEventListener('input', updateSourceControls);
-
-  document.querySelector('#clear-source').onclick = () => { 
-    source.value = ''; 
-    updateSourceControls(); 
-    source.focus(); 
-  };
-
-  document.querySelector('#swap-languages').onclick = () => { 
-    if (sourceSelect.value) { 
-      [sourceSelect.value, targetSelect.value] = [targetSelect.value, sourceSelect.value];
-    } 
-  };
-
-  // Text-to-Speech Audio Reader
-  // Tries ElevenLabs first (server-side call, key never touches the
-  // browser); falls back to the browser's built-in speechSynthesis when
-  // ElevenLabs has no voice for the language, or the request fails.
-  function speakWithBrowser(text, langCode) {
-    if (!('speechSynthesis' in window) || !text || !text.trim()) return;
-    window.speechSynthesis.cancel();
-    const utterance = new SpeechSynthesisUtterance(text);
-    if (langCode) utterance.lang = langCode;
-    window.speechSynthesis.speak(utterance);
-  }
-
-  let currentAudio = null;
-
-  async function speakText(text, langCode, triggerBtn) {
-    if (!text || !text.trim()) return;
-    const lang = (langCode || '').toLowerCase();
-
-    // Skip the network round trip entirely when we already know ElevenLabs
-    // has no voice for this language.
-    if (!lang || !elevenlabsLanguages.has(lang)) {
-      speakWithBrowser(text, lang || 'en');
-      return;
-    }
-
-    const originalLabel = triggerBtn ? triggerBtn.innerHTML : null;
-    if (triggerBtn) {
-      triggerBtn.disabled = true;
-      triggerBtn.innerHTML = '⏳ Loading...';
-    }
-
-    try {
-      const response = await fetch("{% url 'translator:tts_api' %}", {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json', 'X-CSRFToken': csrf },
-        body: JSON.stringify({ text, language: lang }),
-      });
-
-      if (!response.ok) {
-        // Unsupported language, unconfigured key, or API failure - fall
-        // back quietly rather than surfacing an error for a "Listen" click.
-        speakWithBrowser(text, lang);
-        return;
-      }
-
-      const blob = await response.blob();
-      if (currentAudio) currentAudio.pause();
-      currentAudio = new Audio(URL.createObjectURL(blob));
-      currentAudio.play();
-    } catch (err) {
-      speakWithBrowser(text, lang);
-    } finally {
-      if (triggerBtn) {
-        triggerBtn.disabled = false;
-        triggerBtn.innerHTML = originalLabel;
-      }
-    }
-  }
-
-  listenSourceBtn.onclick = () => speakText(source.value, sourceSelect.value || 'en', listenSourceBtn);
-  listenResultBtn.onclick = () => speakText(result.textContent, targetSelect.value || 'sw', listenResultBtn);
-
-  // Speech-to-Text Voice Dictation Assistant
-  const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
-  let recognition = null;
-  let isRecording = false;
-
-  function stopRecordingUI() {
-    isRecording = false;
-    pulseRing.classList.add('hidden');
-    recordBadge.classList.add('hidden');
-    soundWave.classList.add('hidden');
-    recordSubtext.textContent = 'Tap the mic to dictate your message live in any language.';
-    micIcon.textContent = '🎙️';
-    recordBtn.classList.remove('bg-red-600');
-    recordBtn.classList.add('bg-primary');
-  }
-
-  if (SpeechRecognition) {
-    recognition = new SpeechRecognition();
-    recognition.continuous = true;
-    recognition.interimResults = true;
-
-    recognition.onstart = () => {
-      isRecording = true;
-      pulseRing.classList.remove('hidden');
-      recordBadge.classList.remove('hidden');
-      soundWave.classList.remove('hidden');
-      soundWave.classList.add('flex');
-      recordSubtext.textContent = 'Speak clearly into your microphone...';
-      micIcon.textContent = '⏹️';
-      recordBtn.classList.remove('bg-primary');
-      recordBtn.classList.add('bg-red-600');
-    };
-
-    recognition.onresult = (event) => {
-      let transcript = '';
-      for (let i = event.resultIndex; i < event.results.length; i++) {
-        transcript += event.results[i][0].transcript;
-      }
-      source.value = transcript;
-      updateSourceControls();
-    };
-
-    recognition.onerror = (event) => {
-      console.error('Speech recognition error:', event.error);
-      stopRecordingUI();
-      if (event.error !== 'no-speech') {
-        message.textContent = `Voice dictation status: ${event.error}`;
-      }
-    };
-
-    recognition.onend = () => {
-      stopRecordingUI();
-    };
-
-    recordBtn.addEventListener('click', () => {
-      if (isRecording) {
-        recognition.stop();
-      } else {
-        message.textContent = '';
-        const langCode = sourceSelect.value || 'en';
-        recognition.lang = langCode;
-        try {
-          recognition.start();
-        } catch (e) {
-          console.error(e);
-        }
-      }
-    });
-  } else {
-    recordBtn.addEventListener('click', () => {
-      message.textContent = 'Voice dictation is supported in Google Chrome, Microsoft Edge, Safari, and Opera.';
-    });
-  }
-
-  copyBtn.onclick = async () => { 
-    await navigator.clipboard.writeText(result.textContent); 
-    copyBtn.textContent = 'Copied!'; 
-    setTimeout(() => copyBtn.textContent = '📋 Copy', 1200);
-  };
-
-  const triggerBtns = document.querySelectorAll('.translate-trigger');
-
-  form.addEventListener('submit', async e => {
-    e.preventDefault(); 
-    message.textContent = ''; 
-    
-    // Immediately stop recording & reset Voice UI to default when translating
-    if (recognition && isRecording) {
-      try { recognition.stop(); } catch (err) {}
-    }
-    stopRecordingUI();
-    
-    triggerBtns.forEach(btn => { 
-      btn.disabled = true; 
-      btn.classList.add('opacity-50'); 
-    });
-    
-    result.classList.add('quiet-loading');
-    
-    try { 
-      const response = await fetch("{% url 'translator:translate_api' %}", { 
-        method: 'POST', 
-        headers: { 'Content-Type': 'application/json', 'X-CSRFToken': csrf }, 
-        body: JSON.stringify({ 
-          text: source.value, 
-          source_language: sourceSelect.value, 
-          target_language: targetSelect.value, 
-          model: modelSelect.value 
-        }) 
-      }); 
-      
-      const data = await response.json(); 
-      if (!response.ok) throw Error(data.error || 'Translation could not be completed.'); 
-      
-      result.textContent = data.translated_text; 
-      if (data.model_used && data.model_used !== modelSelect.value) {
-        modelSelect.value = data.model_used;
-        syncLanguagesForModel();
-      }
-      const fallbackNote = data.fell_back_to_google ? ' (auto-switched: selected model doesn\'t support this language pair)' : '';
-      document.querySelector('#result-meta').textContent = `Engine: ${data.model_label || 'Translation'}${fallbackNote} · Saved to history`; 
-      copyBtn.classList.remove('hidden');
-      copyBtn.classList.add('inline-flex');
-      listenResultBtn.classList.remove('hidden');
-      listenResultBtn.classList.add('inline-flex');
-    } catch (error) { 
-      message.textContent = error.message; 
-      result.innerHTML = '<span class="text-stone-300">Your translation will appear here.</span>';
-      listenResultBtn.classList.add('hidden');
-      listenResultBtn.classList.remove('inline-flex');
-    } finally { 
-      triggerBtns.forEach(btn => { 
-        btn.disabled = false; 
-        btn.classList.remove('opacity-50'); 
-      });
-      result.classList.remove('quiet-loading');
-    }
-  });
-</script>
-{% endblock %}

translator_app/translator/tests.py

@@ -1,35 +0,0 @@
-from django.test import TestCase
-from unittest.mock import patch
-
-from django.urls import reverse
-
-from .models import TranslationHistory
-
-class TranslatorViewsTests(TestCase):
-    def test_translator_page_renders_model_picker(self):
-        response = self.client.get(reverse('translator:translator'))
-        self.assertContains(response, 'Translation model')
-        self.assertContains(response, 'NLLB-200 (600M')
-
-    @patch('translator.views.TranslationService.translate')
-    def test_translation_api_saves_history(self, translate):
-        translate.return_value = {
-            'source_text': 'Hello', 'translated_text': 'Jambo',
-            'source_language': 'en', 'target_language': 'sw', 'model': 'nllb',
-        }
-        response = self.client.post(
-            reverse('translator:translate_api'),
-            data='{"text":"Hello","source_language":"en","target_language":"sw","model":"nllb"}',
-            content_type='application/json',
-        )
-        self.assertEqual(response.status_code, 200)
-        self.assertEqual(response.json()['translated_text'], 'Jambo')
-        history = TranslationHistory.objects.get()
-        self.assertEqual(history.translation_model, 'nllb')
-        self.assertEqual(history.source_text, 'Hello')
-
-    def test_translation_api_rejects_missing_text(self):
-        response = self.client.post(
-            reverse('translator:translate_api'), data='{}', content_type='application/json'
-        )
-        self.assertEqual(response.status_code, 400)

translator_app/translator/urls.py

@@ -1,15 +0,0 @@
-from django.urls import path
-
-from . import views
-
-
-app_name = 'translator'
-
-urlpatterns = [
-    path('', views.translator, name='translator'),
-    path('history/', views.history, name='history'),
-    path('api/translate/', views.translate_api, name='translate_api'),
-    path('api/tts/', views.text_to_speech, name='tts_api'),
-    path('history/<int:pk>/delete/', views.delete_history, name='delete_history'),
-    path('history/clear/', views.clear_history, name='clear_history'),
-]

translator_app/translator/views.py

@@ -1,200 +0,0 @@
-import json
-
-import requests
-from django.conf import settings
-from django.http import HttpResponse, JsonResponse
-from django.shortcuts import get_object_or_404, redirect, render
-from django.views.decorators.http import require_POST
-
-from .models import Language, TranslationHistory
-from .services import language_support
-from .services.translation_service import TranslationService
-
-
-def _languages():
-    """Sync curated East African languages with TranslationService and return them."""
-    service_languages = TranslationService().get_supported_languages()
-    active_codes = {item['code'] for item in service_languages}
-    
-    # Mark old non-East African languages as inactive in DB
-    Language.objects.exclude(code__in=active_codes).update(is_active=False)
-    
-    for item in service_languages:
-        Language.objects.update_or_create(
-            code=item['code'],
-            defaults={'name': item['name'], 'is_active': True}
-        )
-    return list(Language.objects.filter(is_active=True).order_by('name').values('code', 'name'))
-
-
-def translator(request):
-    languages = _languages()
-    model_language_support = {
-        model: (sorted(codes) if codes is not None else None)
-        for model, codes in language_support.MODEL_LANGUAGE_SUPPORT.items()
-    }
-    return render(request, 'translator/translator.html', {
-        'languages': languages,
-        'models': settings.TRANSLATION_MODELS,
-        'default_model': settings.TRANSLATION_DEFAULT_MODEL,
-        'model_language_support_json': model_language_support,
-        'elevenlabs_languages_json': sorted(language_support.ELEVENLABS_V3_LANGUAGES),
-    })
-
-
-def history(request):
-    translations = TranslationHistory.objects.select_related(
-        'source_language', 'target_language'
-    )[:100]
-    model_labels = dict(settings.TRANSLATION_MODELS)
-    for item in translations:
-        item.model_label = model_labels.get(item.translation_model, item.translation_model)
-    return render(request, 'translator/history.html', {
-        'translations': translations,
-    })
-
-
-@require_POST
-def translate_api(request):
-    try:
-        payload = json.loads(request.body)
-    except (TypeError, json.JSONDecodeError):
-        return JsonResponse({'error': 'Send a valid JSON request.'}, status=400)
-
-    text = (payload.get('text') or '').strip()
-    source_code = (payload.get('source_language') or '').lower()
-    target_code = (payload.get('target_language') or '').lower()
-    model = payload.get('model') or settings.TRANSLATION_DEFAULT_MODEL
-    allowed_models = dict(settings.TRANSLATION_MODELS)
-
-    if not text:
-        return JsonResponse({'error': 'Enter text to translate.'}, status=400)
-    if len(text) > 5000:
-        return JsonResponse({'error': 'Text is limited to 5,000 characters.'}, status=400)
-    if not target_code:
-        return JsonResponse({'error': 'Choose a target language.'}, status=400)
-    if model not in allowed_models:
-        return JsonResponse({'error': 'Choose a valid translation model.'}, status=400)
-
-    # MADLAD auto-detects and ignores any provided source; skip the source
-    # side of this check for it so we don't fallback unnecessarily.
-    check_source = None if model == 'madlad' else (source_code or None)
-    model, fell_back = language_support.resolve_model(model, check_source, target_code)
-    if model not in allowed_models:
-        # Shouldn't happen (google_fallback is always registered), but stay safe.
-        return JsonResponse({'error': 'No translation model supports this language pair.'}, status=422)
-
-    service = TranslationService()
-    result = service.translate(text, target_code, source_code or None, model=model)
-    if result.get('error'):
-        return JsonResponse(result, status=502)
-
-    source_code = result.get('source_language', source_code)
-    known_languages = {item['code']: item['name'] for item in service.get_supported_languages()}
-
-    def language_for(code):
-        if not code or code == 'auto-detected':
-            return None
-        language, _ = Language.objects.get_or_create(
-            code=code,
-            defaults={'name': known_languages.get(code, code.upper())},
-        )
-        return language
-
-    source_language = language_for(source_code)
-    target_language = language_for(target_code)
-    TranslationHistory.objects.create(
-        user=request.user if request.user.is_authenticated else None,
-        source_text=text,
-        translated_text=result['translated_text'],
-        source_language=source_language,
-        target_language=target_language,
-        detected_source_language=source_code if source_code != 'auto-detected' else '',
-        translation_model=model,
-    )
-    result['model_label'] = allowed_models[model]
-    result['model_used'] = model
-    result['fell_back_to_google'] = fell_back
-    return JsonResponse(result)
-
-
-def get_elevenlabs_model(lang_code: str) -> str:
-    """
-    Returns the cheapest compatible ElevenLabs model ID for a given language code.
-    Falls back to v3 if v2 does not support it.
-    """
-    clean_code = lang_code.lower().strip()
-    
-    if clean_code in language_support.ELEVENLABS_MULTILINGUAL_V2_LANGUAGES:
-        return "eleven_multilingual_v2"
-    elif clean_code in language_support.ELEVENLABS_V3_LANGUAGES:
-        return "eleven_v3"
-    else:
-        raise ValueError(f"Language code '{lang_code}' is not supported by any ElevenLabs model.")
-    
-@require_POST
-def text_to_speech(request):
-    if not settings.ELEVENLABS_API_KEY:
-        return JsonResponse(
-            {'error': 'Text-to-speech is not configured on the server.'}, status=503
-        )
-
-    try:
-        payload = json.loads(request.body)
-    except (TypeError, json.JSONDecodeError):
-        return JsonResponse({'error': 'Send a valid JSON request.'}, status=400)
-
-    text = (payload.get('text') or '').strip()
-    lang = (payload.get('language') or '').lower()
-
-    if not text:
-        return JsonResponse({'error': 'No text to read aloud.'}, status=400)
-    text = text[:5000]
-
-    # Fail fast client-side instead of burning an API call: ElevenLabs'
-    # multilingual model has no voice for these languages yet.
-    if lang and lang not in language_support.ELEVENLABS_V3_LANGUAGES:
-        return JsonResponse(
-            {
-                'error': 'ElevenLabs does not have a voice for this language yet.',
-                'unsupported_language': True,
-            },
-            status=422,
-        )
-
-    try:
-        response = requests.post(
-            settings.ELEVENLABS_TTS_URL.format(voice_id=settings.ELEVENLABS_VOICE_ID),
-            headers={
-                'xi-api-key': settings.ELEVENLABS_API_KEY,
-                'Content-Type': 'application/json',
-                'Accept': 'audio/mpeg',
-            },
-            json={
-                'text': text,
-                'model_id': get_elevenlabs_model(lang),
-            },
-            timeout=20,
-        )
-    except requests.RequestException:
-        return JsonResponse({'error': 'Speech service is unreachable.'}, status=502)
-
-    if response.status_code != 200:
-        logger_message = response.text[:300] if response.text else ''
-        return JsonResponse(
-            {'error': 'Speech generation failed.', 'detail': logger_message}, status=502
-        )
-
-    return HttpResponse(response.content, content_type='audio/mpeg')
-
-
-@require_POST
-def delete_history(request, pk):
-    get_object_or_404(TranslationHistory, pk=pk).delete()
-    return redirect('translator:history')
-
-
-@require_POST
-def clear_history(request):
-    TranslationHistory.objects.all().delete()
-    return redirect('translator:history')

translator_app/translator_project/asgi.py

@@ -1,16 +0,0 @@
-"""
-ASGI config for translator_project project.
-
-It exposes the ASGI callable as a module-level variable named ``application``.
-
-For more information on this file, see
-https://docs.djangoproject.com/en/6.0/howto/deployment/asgi/
-"""
-
-import os
-
-from django.core.asgi import get_asgi_application
-
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'translator_project.settings')
-
-application = get_asgi_application()

translator_app/translator_project/settings.py

@@ -1,134 +0,0 @@
-# translator_project/settings.py
-
-import os
-from pathlib import Path
-from dotenv import load_dotenv
-
-load_dotenv()
-
-BASE_DIR = Path(__file__).resolve().parent.parent
-
-SECRET_KEY = os.getenv("DJANGO_SECRET_KEY", "your-secret-key-here")
-
-DEBUG = True
-
-ALLOWED_HOSTS = [
-    "localhost",
-    "127.0.0.1",
-]
-
-# Application definition
-INSTALLED_APPS = [
-    "django.contrib.admin",
-    "django.contrib.auth",
-    "django.contrib.contenttypes",
-    "django.contrib.sessions",
-    "django.contrib.messages",
-    "django.contrib.staticfiles",
-    "rest_framework",
-    "translator",  # Our app
-]
-
-MIDDLEWARE = [
-    "django.middleware.security.SecurityMiddleware",
-    "django.contrib.sessions.middleware.SessionMiddleware",
-    "django.middleware.common.CommonMiddleware",
-    "django.middleware.csrf.CsrfViewMiddleware",
-    "django.contrib.auth.middleware.AuthenticationMiddleware",
-    "django.contrib.messages.middleware.MessageMiddleware",
-    "django.middleware.clickjacking.XFrameOptionsMiddleware",
-]
-
-ROOT_URLCONF = "translator_project.urls"
-
-TEMPLATES = [
-    {
-        "BACKEND": "django.template.backends.django.DjangoTemplates",
-        "DIRS": [],
-        "APP_DIRS": True,
-        "OPTIONS": {
-            "context_processors": [
-                "django.template.context_processors.debug",
-                "django.template.context_processors.request",
-                "django.contrib.auth.context_processors.auth",
-                "django.contrib.messages.context_processors.messages",
-            ],
-        },
-    },
-]
-
-WSGI_APPLICATION = "translator_project.wsgi.application"
-
-# Database
-DATABASES = {
-    "default": {
-        "ENGINE": "django.db.backends.sqlite3",
-        "NAME": BASE_DIR / "db.sqlite3",
-    }
-}
-
-# Password validation
-AUTH_PASSWORD_VALIDATORS = [
-    {
-        "NAME": "django.contrib.auth.password_validation.UserAttributeSimilarityValidator",
-    },
-    {
-        "NAME": "django.contrib.auth.password_validation.MinimumLengthValidator",
-    },
-    {
-        "NAME": "django.contrib.auth.password_validation.CommonPasswordValidator",
-    },
-    {
-        "NAME": "django.contrib.auth.password_validation.NumericPasswordValidator",
-    },
-]
-
-# Internationalization
-LANGUAGE_CODE = "en-us"
-TIME_ZONE = "UTC"
-USE_I18N = True
-USE_TZ = True
-
-# Static files
-STATIC_URL = "static/"
-STATIC_ROOT = os.path.join(BASE_DIR, "staticfiles")
-
-# Media files
-MEDIA_URL = "/media/"
-MEDIA_ROOT = os.path.join(BASE_DIR, "media")
-
-# Default primary key field type
-DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
-
-# ML translation service
-MODEL_API_URL = os.getenv("MODEL_API_URL")
-TRANSLATION_DEFAULT_MODEL = os.getenv("TRANSLATION_DEFAULT_MODEL", "nllb")
-TRANSLATION_MODELS = (
-    ("nllb", "NLLB-200 (600M · Fast)"),
-    ("nllb_1_3b", "NLLB-200 (1.3B · Accurate)"),
-    ("madlad", "MADLAD-400 (3B · Large)"),
-    ("google", "Google Translate"),
-)
-TRANSLATION_MODEL_ENGINES = {
-    "nllb": "nllb",
-    "nllb_1_3b": "nllb_1_3b",
-    "madlad": "madlad",
-}
-
-# Optional traditional-provider fallback. Add this option to TRANSLATION_MODELS
-# only when a DeepL-compatible endpoint and key are configured.
-TRANSLATION_API_KEY = os.getenv("TRANSLATION_API_KEY")
-TRANSLATION_API_URL = os.getenv(
-    "TRANSLATION_API_URL", "https://api-free.deepl.com/v2/translate"
-)
-if TRANSLATION_API_KEY:
-    TRANSLATION_MODELS += (("deepl_fallback", "DeepL"),)
-# Or for Google Translate:
-# TRANSLATION_API_URL = 'https://translation.googleapis.com/language/translate/v2'
-
-# ElevenLabs text-to-speech. Key must only ever live server-side (env var) -
-# never send it to the browser. Get a key at https://elevenlabs.io/app/settings/api-keys
-# and a voice ID from https://elevenlabs.io/app/voice-library
-ELEVENLABS_API_KEY = os.getenv("ELEVENLABS_API_KEY")
-ELEVENLABS_VOICE_ID = os.getenv("ELEVENLABS_VOICE_ID", "hpp4J3VqNfWAUOO0d1Us")
-ELEVENLABS_TTS_URL = "https://api.elevenlabs.io/v1/text-to-speech/{voice_id}"

translator_app/translator_project/urls.py

@@ -1,23 +0,0 @@
-"""
-URL configuration for translator_project project.
-
-The `urlpatterns` list routes URLs to views. For more information please see:
-    https://docs.djangoproject.com/en/6.0/topics/http/urls/
-Examples:
-Function views
-    1. Add an import:  from my_app import views
-    2. Add a URL to urlpatterns:  path('', views.home, name='home')
-Class-based views
-    1. Add an import:  from other_app.views import Home
-    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
-Including another URLconf
-    1. Import the include() function: from django.urls import include, path
-    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
-"""
-from django.contrib import admin
-from django.urls import include, path
-
-urlpatterns = [
-    path('admin/', admin.site.urls),
-    path('', include('translator.urls')),
-]

translator_app/translator_project/wsgi.py

@@ -1,16 +0,0 @@
-"""
-WSGI config for translator_project project.
-
-It exposes the WSGI callable as a module-level variable named ``application``.
-
-For more information on this file, see
-https://docs.djangoproject.com/en/6.0/howto/deployment/wsgi/
-"""
-
-import os
-
-from django.core.wsgi import get_wsgi_application
-
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'translator_project.settings')
-
-application = get_wsgi_application()