Create app.py

app.py

@@ -0,0 +1,859 @@
+import os
+import spaces
+import io
+import base64
+import json
+import re
+import random  # Added for introducing randomness to the vocabulary generator
+import numpy as np
+import soundfile as sf
+import torch
+from PIL import Image
+
+# 1. Apply transformers monkey patch to fix AutoAWQ compatibility
+import transformers.activations
+if not hasattr(transformers.activations, "PytorchGELUTanh"):
+    if hasattr(transformers.activations, "GELUTanh"):
+        transformers.activations.PytorchGELUTanh = transformers.activations.GELUTanh
+    else:
+        import torch.nn as nn
+        class PytorchGELUTanh(nn.Module):
+            def forward(self, x):
+                return nn.functional.gelu(x, approximate="tanh")
+        transformers.activations.PytorchGELUTanh = PytorchGELUTanh
+
+from transformers import AutoModelForCausalLM, AutoTokenizer
+from diffusers import SanaSprintPipeline
+from qwen_tts import Qwen3TTSModel
+from gradio import Server
+from fastapi.responses import HTMLResponse
+from fastapi.staticfiles import StaticFiles
+
+# Initialize Server
+app = Server()
+
+# Create 'games' directory if it doesn't exist
+os.makedirs("games", exist_ok=True)
+
+# Mount the static 'games' directory so index.html can load JS files securely
+app.mount("/games", StaticFiles(directory="games"), name="games")
+
+# Model Initialization with try-except block
+try:
+    # GGUF Configuration (using Qwen2.5-7B-Instruct GGUF as a stable reference)
+    # Ensure 'pip install gguf' is run in your environment.
+    llm_repo = "bartowski/Qwen2.5-7B-Instruct-GGUF"
+    gguf_filename = "Qwen2.5-7B-Instruct-Q4_0.gguf"
+
+    print(f"Loading GGUF LLM model {llm_repo} ({gguf_filename}) on GPU via transformers...")
+    tokenizer = AutoTokenizer.from_pretrained(llm_repo, gguf_file=gguf_filename)
+    llm_model = AutoModelForCausalLM.from_pretrained(
+        llm_repo,
+        gguf_file=gguf_filename,
+        torch_dtype=torch.bfloat16,
+        device_map="auto"
+    )
+
+    print("Loading Image model Sana Sprint 1.6B on GPU...")
+    sana_pipe = SanaSprintPipeline.from_pretrained(
+        "Efficient-Large-Model/Sana_Sprint_1.6B_1024px_diffusers",
+        torch_dtype=torch.bfloat16
+    )
+    sana_pipe.to("cuda:0")
+
+    print("Loading TTS model Qwen3-TTS 1.7B on GPU...")
+    # Apply flash-attention-3 optimization similar to Qwen3-TTS Hugging Face Space app.py
+    # Fall back safely to standard 'sdpa' or 'flash_attention_2' if kernels/drivers lack support
+    try:
+        tts_model = Qwen3TTSModel.from_pretrained(
+            "Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice",
+            device_map="cuda:0",
+            dtype=torch.bfloat16,
+            attn_implementation="kernels-community/flash-attn3",
+        )
+        print("Qwen3-TTS 1.7B loaded successfully with Flash Attention 3.")
+    except Exception as e_fa3:
+        print(f"Could not initialize Flash Attention 3 ({e_fa3}). Attempting SDPA fallback...")
+        try:
+            tts_model = Qwen3TTSModel.from_pretrained(
+                "Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice",
+                device_map="cuda:0",
+                dtype=torch.bfloat16,
+                attn_implementation="sdpa",
+            )
+            print("Qwen3-TTS 1.7B loaded successfully with SDPA fallback.")
+        except Exception as e_all:
+            # Absolute fallback in case of initialization exceptions
+            tts_model = Qwen3TTSModel.from_pretrained(
+                "Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice",
+                device_map="cuda:0",
+                dtype=torch.bfloat16,
+            )
+            print("Qwen3-TTS 1.7B loaded successfully with default attention.")
+            
+except Exception as e:
+    print(f"Error loading models on GPU during startup: {e}")
+
+# Localization Database containing GUI texts, layout labels, and game translations
+LOCALIZATION_DATABASE = {
+    "English": {
+        "title": "✨ WordConjure: Play & Learn!",
+        "subtitle": "Embark on an audio-visual word adventure with games and custom illustrations! 🌟",
+        "settings": "🛠️ Wizard's Settings Panel",
+        "word_count_label": "🔮 How many words to summon?",
+        "expl_lang_label": "🗣️ Explanation Language",
+        "app_lang_label": "📱 App Language",
+        "source_lang": "🌍 My Native Tongue",
+        "target_lang": "🎯 Language to Practice",
+        "btn_get_words": "🪄 Summon Words!",
+        "tab_vocab": "📖 My Word Book",
+        "tab_games": "🎮 Play Arena",
+        "original_header": "Original Word",
+        "translation_header": "Magic Translation",
+        "explanation_header": "What does it mean?",
+        "visual_header": "Art Card",
+        "audio_header": "Hear It",
+        "game_selection_title": "Select Your Word Challenge",
+        "game_memory_title": "Flashcard Memory Match",
+        "game_memory_desc": "Flip face-down cards to match original terms with their translations and visual cards.",
+        "game_monster_title": "Feed the Hungry Word Monster",
+        "game_monster_desc": "The monster is starving! Feed it the correct translation card matching its request.",
+        "game_quiz_title": "Audio-Visual Quiz",
+        "game_quiz_desc": "Listen to the pronunciation or inspect the visual card, and choose the correct original term.",
+        "game_scramble_title": "Scrambled Word Builder",
+        "game_scramble_desc": "Arrange the scrambled letters in the correct order to spell the translation of the given word.",
+        "game_linker_title": "Visual Word Linker",
+        "game_linker_desc": "Match visual cards on the left with their corresponding practice words on the right, side by side.",
+        "game_monster_feed_me": "FEED ME THE CARD FOR:",
+        "game_monster_correct": "Yum! Correct! 🎉",
+        "game_monster_incorrect": "Ouch! Wrong card! 😢",
+        "game_monster_no_words": "No words summoned yet!",
+        "game_monster_no_words_desc": "Please return to 'My Word Book', select a language to practice, and click 'Summon Words' first.",
+        "game_quiz_hint_btn": "Hint 💡",
+        "game_quiz_replay_audio": "Play Audio 🔊",
+        "game_quiz_correct": "Correct! 🎉",
+        "game_quiz_incorrect": "Incorrect! Try again! 😢",
+        "game_quiz_question": "Identify this word:",
+        "game_quiz_need_four": "Please summon at least 4 words to play the Audio-Visual Quiz.",
+        "game_scramble_clue_label": "Translate this word:",
+        "game_scramble_explanation_label": "Clue:",
+        "game_scramble_reset_btn": "Reset 🔄",
+        "game_scramble_play_audio": "Pronounce 🔊",
+        "game_scramble_correct": "Perfect Spelling! 🎉",
+        "game_scramble_incorrect": "Oops! Try again.",
+        "game_memory_moves": "Moves:",
+        "game_memory_congrats": "Board Cleared! Perfect Match! 🎉",
+        "game_memory_need_words": "Please summon at least 4 words to play Flashcard Memory Match.",
+        "game_linker_instruction": "Click a visual card, then click its matching practice word!",
+        "game_linker_hint_btn": "Hint 💡",
+        "game_linker_correct": "Perfect Association! 🎉",
+        "game_linker_incorrect": "Mismatch! Try again. 😢",
+        "game_linker_select_clue": "Select a card on the left first to get a hint!",
+        "game_linker_need_words": "Please summon at least 4 words to play Visual Word Linker."
+    },
+    "Spanish": {
+        "title": "✨ ¡WordConjure: Juega y Aprende!",
+        "subtitle": "¡Embarca en una aventura de palabras audiovisual con minijuegos e ilustraciones mágicas! 🌟",
+        "settings": "🛠️ Panel del Mago (Ajustes)",
+        "word_count_label": "🔮 ¿Cuántas palabras quieres convocar?",
+        "expl_lang_label": "🗣️ Idioma de la explicación",
+        "app_lang_label": "📱 Idioma de la aplicación",
+        "source_lang": "🌍 Mi lengua materna",
+        "target_lang": "🎯 Idioma a practicar",
+        "btn_get_words": "🪄 ¡Invocar Palabras!",
+        "tab_vocab": "📖 Mi Libro de Palabras",
+        "tab_games": "🎮 Arena de Juegos",
+        "original_header": "Palabra Original",
+        "translation_header": "Traducción Mágica",
+        "explanation_header": "¿Qué significa?",
+        "visual_header": "Tarjeta de Arte",
+        "audio_header": "Escúchalo",
+        "game_selection_title": "Elige tu desafío de palabras",
+        "game_memory_title": "Memoria de Tarjetas",
+        "game_memory_desc": "Voltea cartas boca abajo para emparejar términos originales con sus traducciones e imágenes.",
+        "game_monster_title": "Alimenta al Monstruo de Palabras",
+        "game_monster_desc": "¡El monstruo se muere de hambre! Aliméntalo con la traducción correcta correspondiente a su petición.",
+        "game_quiz_title": "Quiz Audio-Visual",
+        "game_quiz_desc": "Escucha la pronunciación o inspecciona la tarjeta visual, luego asóciala con su traducción original.",
+        "game_scramble_title": "Palabras Mezcladas",
+        "game_scramble_desc": "Ordena las letras mezcladas para deletrear la traducción de la palabra dada.",
+        "game_linker_title": "Asociador de Palabras",
+        "game_linker_desc": "Une las tarjetas visuales de la izquierda con sus palabras correspondientes de la derecha, lado a lado.",
+        "game_monster_feed_me": "¡ALIMÉNTAME CON LA TARJETA DE:",
+        "game_monster_correct": "¡Rico! ¡Correcto! 🎉",
+        "game_monster_incorrect": "¡Ay! ¡Tarjeta incorrecta! 😢",
+        "game_monster_no_words": "¡Aún no has convocado palabras!",
+        "game_monster_no_words_desc": "Por favor, regresa a la pestaña 'Mi Libro de Palabras', selecciona un idioma para practicar y haz clic en 'Invocar Palabras' primero.",
+        "game_quiz_hint_btn": "Pista 💡",
+        "game_quiz_replay_audio": "Reproducir Audio 🔊",
+        "game_quiz_correct": "¡Correcto! 🎉",
+        "game_quiz_incorrect": "¡Incorrecto! Inténtalo de nuevo! 😢",
+        "game_quiz_question": "Identifica esta palabra:",
+        "game_quiz_need_four": "Por favor, convoca al menos 4 palabras para jugar el Quiz Audio-Visual.",
+        "game_scramble_clue_label": "Traduce esta palabra:",
+        "game_scramble_explanation_label": "Pista:",
+        "game_scramble_reset_btn": "Restablecer 🔄",
+        "game_scramble_play_audio": "Pronunciar 🔊",
+        "game_scramble_correct": "¡Deletreo perfecto! 🎉",
+        "game_scramble_incorrect": "¡Ups! Inténtalo de nuevo.",
+        "game_memory_moves": "Movimientos:",
+        "game_memory_congrats": "¡Tablero despejado! ¡Combinación perfecta! 🎉",
+        "game_memory_need_words": "Por favor, convoca al menos 4 palabras para jugar a Memoria de Tarjetas.",
+        "game_linker_instruction": "¡Haz clic en una tarjeta visual y luego en su palabra correspondiente!",
+        "game_linker_hint_btn": "Pista 💡",
+        "game_linker_correct": "¡Asociación perfecta! 🎉",
+        "game_linker_incorrect": "¡No coinciden! Inténtalo de nuevo. 😢",
+        "game_linker_select_clue": "¡Selecciona una tarjeta a la izquierda primero para obtener una pista!",
+        "game_linker_need_words": "Por favor, convoca al menos 4 palabras para jugar al Asociador de Palabras."
+    },
+    "French": {
+        "title": "✨ WordConjure : Jouez & Apprenez !",
+        "subtitle": "Embarquez pour une aventure de mots audiovisuelle avec des jeux et des illustrations magiques ! 🌟",
+        "settings": "🛠️ Paramètres du Magicien",
+        "word_count_label": "🔮 Combien de mots invoquer ?",
+        "expl_lang_label": "🗣️ Langue d'explication",
+        "app_lang_label": "📱 Langue de l'application",
+        "source_lang": "🌍 Ma langue maternelle",
+        "target_lang": "🎯 Langue à pratiquer",
+        "btn_get_words": "🪄 Invoquer des Mots !",
+        "tab_vocab": "📖 Mon Grimoire de Mots",
+        "tab_games": "🎮 Arène de Jeux",
+        "original_header": "Mot Original",
+        "translation_header": "Traduction Magique",
+        "explanation_header": "Qu'est-ce que ça veut dire ?",
+        "visual_header": "Carte d'Art",
+        "audio_header": "Écouter",
+        "game_selection_title": "Choisissez votre défi de mots",
+        "game_memory_title": "Mémoire de Cartes",
+        "game_memory_desc": "Retournez les cartes face cachée pour faire correspondre les termes originaux avec leurs traductions et visuels.",
+        "game_monster_title": "Nourrir le monstre de mots affamé",
+        "game_monster_desc": "Le monstre est affamé ! Nourrissez-le avec la bonne carte de traduction correspondant à sa demande.",
+        "game_quiz_title": "Quiz Audio-Visual",
+        "game_quiz_desc": "Écoutez la prononciation ou inspectez la carte visuelle, puis associez-la à sa traduction originale.",
+        "game_scramble_title": "Mots Mélangés",
+        "game_scramble_desc": "Arrangez les lettres mélangées dans le bon ordre pour épeler la traduction du mot donné.",
+        "game_linker_title": "Association Visuelle",
+        "game_linker_desc": "Associez les cartes visuelles à gauche avec leurs mots d'entraînement correspondants à droite, côte à côte.",
+        "game_monster_feed_me": "NOURRIS-MOI AVEC LA CARTE POUR :",
+        "game_monster_correct": "Miam ! Correct ! 🎉",
+        "game_monster_incorrect": "Aïe ! Mauvaise carte ! 😢",
+        "game_monster_no_words": "Aucun mot invoqué !",
+        "game_monster_no_words_desc": "Veuillez d'abord retourner à l'onglet 'Mon Grimoire de Mots', choisir une langue à pratiquer et cliquer sur 'Invoquer des Mots'.",
+        "game_quiz_hint_btn": "Indice 💡",
+        "game_quiz_replay_audio": "Jouer l'audio 🔊",
+        "game_quiz_correct": "Correct ! 🎉",
+        "game_quiz_incorrect": "Incorrect ! Réessayez ! 😢",
+        "game_quiz_question": "Identifiez ce mot :",
+        "game_quiz_need_four": "Veuillez invoquer au moins 4 mots pour jouer au Quiz Audio-Visual.",
+        "game_scramble_clue_label": "Traduisez ce mot :",
+        "game_scramble_explanation_label": "Indice :",
+        "game_scramble_reset_btn": "Réinitialiser 🔄",
+        "game_scramble_play_audio": "Prononcer 🔊",
+        "game_scramble_correct": "Orthographe parfaite ! 🎉",
+        "game_scramble_incorrect": "Oups ! Réessayez.",
+        "game_memory_moves": "Mouvements :",
+        "game_memory_congrats": "Tableau vidé ! Combinaison parfaite ! 🎉",
+        "game_memory_need_words": "Veuillez invoquer au moins 4 mots pour jouer à Mémoire de Cartes.",
+        "game_linker_instruction": "Cliquez sur une carte visuelle, puis sur son mot correspondant !",
+        "game_linker_hint_btn": "Indice 💡",
+        "game_linker_correct": "Association parfaite ! 🎉",
+        "game_linker_incorrect": "Désaccord ! Réessayez. 😢",
+        "game_linker_select_clue": "Sélectionnez d'abord une carte à gauche pour obtenir un indice !",
+        "game_linker_need_words": "Veuillez invoquer au moins 4 mots pour jouer à l'Association Visuelle."
+    },
+    "German": {
+        "title": "✨ WordConjure: Spiele & Lerne!",
+        "subtitle": "Begib dich auf ein audiovisuelles Wortabenteuer mit Spielen und magischen Illustrationen! 🌟",
+        "settings": "🛠️ Einstellungen des Zauberers",
+        "word_count_label": "🔮 Wie viele Wörter beschwören?",
+        "expl_lang_label": "🗣️ Erklärungssprache",
+        "app_lang_label": "📱 App-Sprache",
+        "source_lang": "🌍 Meine Muttersprache",
+        "target_lang": "🎯 Zielsprache zum Üben",
+        "btn_get_words": "🪄 Wörter beschwören!",
+        "tab_vocab": "📖 Mein Wörterbuch",
+        "tab_games": "🎮 Spielarena",
+        "original_header": "Ursprüngliches Wort",
+        "translation_header": "Magische Übersetzung",
+        "explanation_header": "Bedeutung",
+        "visual_header": "Kunstkarte",
+        "audio_header": "Anhören",
+        "game_selection_title": "Wähle deine Wortherausforderung",
+        "game_memory_title": "Karteikarten-Memory",
+        "game_memory_desc": "Decke verdeckte Karten auf, um Originalbegriffe mit ihren Übersetzungen und Bildern abzugleichen.",
+        "game_monster_title": "Füttere das Wortmonster",
+        "game_monster_desc": "Das Monster verhungert! Füttere es mit der richtigen Übersetzungskarte passend zu seiner Bitte.",
+        "game_quiz_title": "Audio-Visuelles Quiz",
+        "game_quiz_desc": "Höre dir die Aussprache an oder betrachte die Bildkarte und wähle den richtigen Originalbegriff.",
+        "game_scramble_title": "Buchstabensalat",
+        "game_scramble_desc": "Bringe die durcheinandergewürfelten Buchstaben in die richtige Reihenfolge, um die Übersetzung zu schreiben.",
+        "game_linker_title": "Visueller Wort-Verlinker",
+        "game_linker_desc": "Verbinde die Bildkarten auf der linken Seite mit den entsprechenden Übungswörtern auf der rechten Seite.",
+        "game_monster_feed_me": "FÜTTERE MICH MIT DER KARTE FÜR:",
+        "game_monster_correct": "Nom! Richtig! 🎉",
+        "game_monster_incorrect": "Aua! Falsche Karte! 😢",
+        "game_monster_no_words": "Noch keine Wörter beschworen!",
+        "game_monster_no_words_desc": "Bitte kehre zuerst zum Reiter 'Mein Wörterbuch' zurück, wähle eine Zielsprache aus und klicke auf 'Wörter beschwören'.",
+        "game_quiz_hint_btn": "Hinweis 💡",
+        "game_quiz_replay_audio": "Audio abspielen 🔊",
+        "game_quiz_correct": "Richtig! 🎉",
+        "game_quiz_incorrect": "Falsch! Versuche es noch einmal! 😢",
+        "game_quiz_question": "Erkenne dieses Wort:",
+        "game_quiz_need_four": "Bitte beschwöre mindestens 4 Wörter, um das Audio-Visuelle Quiz zu spielen.",
+        "game_scramble_clue_label": "Übersetze dieses Wort:",
+        "game_scramble_explanation_label": "Hinweis:",
+        "game_scramble_reset_btn": "Zurücksetzen 🔄",
+        "game_scramble_play_audio": "Anhören 🔊",
+        "game_scramble_correct": "Perfekte Rechtschreibung! 🎉",
+        "game_scramble_incorrect": "Ups! Versuche es noch einmal.",
+        "game_memory_moves": "Züge:",
+        "game_memory_congrats": "Spielfeld geräumt! Perfekt gelöst! 🎉",
+        "game_memory_need_words": "Bitte beschwöre mindestens 4 Wörter, um das Karteikarten-Memory zu spielen.",
+        "game_linker_instruction": "Klicke auf eine Bildkarte und dann auf das passende Übungswort!",
+        "game_linker_hint_btn": "Hinweis 💡",
+        "game_linker_correct": "Perfekte Zuordnung! 🎉",
+        "game_linker_incorrect": "Fehlpaarung! Versuche es noch einmal. 😢",
+        "game_linker_select_clue": "Wähle zuerst eine Karte auf der linken Seite aus, um einen Hinweis zu erhalten!",
+        "game_linker_need_words": "Bitte beschwöre mindestens 4 Wörter, um den Visuellen Wort-Verlinker zu spielen."
+    },
+    "Chinese": {
+        "title": "✨ WordConjure: 语言奇幻冒险！",
+        "subtitle": "开启视听单词大冒险！玩趣味小游戏，收集魔法卡片！🌟",
+        "settings": "🛠️ 魔法师设置面板",
+        "word_count_label": "🔮 召唤多少个单词？",
+        "expl_lang_label": "🗣️ 释义语言选项",
+        "app_lang_label": "📱 应用显示语言",
+        "source_lang": "🌍 我的母语",
+        "target_lang": "🎯 要练习的语言",
+        "btn_get_words": "🪄 召唤魔法单词！",
+        "tab_vocab": "📖 我的魔法词典",
+        "tab_games": "🎮 游戏大竞技场",
+        "original_header": "魔法原文",
+        "translation_header": "神奇译文",
+        "explanation_header": "单词释义",
+        "visual_header": "艺术插画卡",
+        "audio_header": "听听声音",
+        "game_selection_title": "选择你的单词挑战",
+        "game_memory_title": "卡片记忆匹配",
+        "game_memory_desc": "翻转背面朝上的卡片，将原始词汇与其翻译和视觉卡片匹配。",
+        "game_monster_title": "喂食饥饿的单词怪兽",
+        "game_monster_desc": "怪兽快饿扁了！喂它符合要求的正确翻译卡片。",
+        "game_quiz_title": "视听小测验",
+        "game_quiz_desc": "听发音或观察视觉卡片，并选择正确的原始词汇。",
+        "game_scramble_title": "字母拼词挑战",
+        "game_scramble_desc": "将打乱的字母重新排列成正确的顺序，拼写出给定单词的翻译。",
+        "game_linker_title": "视觉词汇连连看",
+        "game_linker_desc": "将左侧的视觉卡片与右侧相应的练习单词并排进行匹配。",
+        "game_monster_feed_me": "喂我这张卡片：",
+        "game_monster_correct": "好香！回答正确！🎉",
+        "game_monster_incorrect": "哎哟！卡片喂错了！😢",
+        "game_monster_no_words": "尚未召唤魔法单词！",
+        "game_monster_no_words_desc": "请先返回“我的魔法词典”标签页，选择要练习的语言，然后点击“召唤魔法单词”。",
+        "game_quiz_hint_btn": "提示 💡",
+        "game_quiz_replay_audio": "播放音频 🔊",
+        "game_quiz_correct": "正确！🎉",
+        "game_quiz_incorrect": "不正确！再试一次！😢",
+        "game_quiz_question": "辨识此单词：",
+        "game_quiz_need_four": "请召唤至少4个单词以进行视听小测验。",
+        "game_scramble_clue_label": "翻译这个单词：",
+        "game_scramble_explanation_label": "线索：",
+        "game_scramble_reset_btn": "重置 🔄",
+        "game_scramble_play_audio": "发音 🔊",
+        "game_scramble_correct": "拼写完全正确！🎉",
+        "game_scramble_incorrect": "糟糕！再试一次。",
+        "game_memory_moves": "步数：",
+        "game_memory_congrats": "翻牌完成！完美匹配！🎉",
+        "game_memory_need_words": "请召唤至少4个单词以进行卡片记忆匹配。",
+        "game_linker_instruction": "先点击一张视觉卡片，再点击与其匹配的练习单词！",
+        "game_linker_hint_btn": "提示 💡",
+        "game_linker_correct": "完美关联！🎉",
+        "game_linker_incorrect": "匹配错误！再试一次。😢",
+        "game_linker_select_clue": "请先点击左侧的卡片以获取提示！",
+        "game_linker_need_words": "请召唤至少4个单词以进行视觉词汇连连看。"
+    },
+    "Japanese": {
+        "title": "✨ WordConjure：楽しく学べる冒険！",
+        "subtitle": "音とイラストの世界へ！ミニゲームと魔法のカードで言葉の冒険に出発しよう！🌟",
+        "settings": "🛠️ 魔法使いの設定パネル",
+        "word_count_label": "🔮 何語の言葉を召喚する？",
+        "expl_lang_label": "🗣️ 解説の言葉",
+        "app_lang_label": "📱 アプリの言語",
+        "source_lang": "🌍 私の母国語",
+        "target_lang": "🎯 練習する言語",
+        "btn_get_words": "🪄 言葉を召喚する！",
+        "tab_vocab": "📖 魔法の単語帳",
+        "tab_games": "🎮 ゲームアリーナ",
+        "original_header": "元の言葉",
+        "translation_header": "魔法の翻訳",
+        "explanation_header": "どんな意味？",
+        "visual_header": "アートカード",
+        "audio_header": "聴いてみる",
+        "game_selection_title": "挑戦するミニゲームを選ぼう",
+        "game_memory_title": "フラッシュカード神経衰弱",
+        "game_memory_desc": "裏返しのカードをめくって、元の言葉とその翻訳、およびビジュアルカードを一致させます。",
+        "game_monster_title": "お腹ペコペコ単語モンスター",
+        "game_monster_desc": "モンスターはお腹が空いています！リクエストに合う正しい翻訳カードをあげましょう。",
+        "game_quiz_title": "視聴覚クイズ",
+        "game_quiz_desc": "発音を聞くかビジュアルカードを確認して、正しい元の言葉を選択してください。",
+        "game_scramble_title": "文字並べ替えクイズ",
+        "game_scramble_desc": "バラバラになったアルファベットを正しい順に並べ替えて、与えられた単語の翻訳をスペルします。",
+        "game_linker_title": "ビジュアル単語リンカー",
+        "game_linker_desc": "左側のビジュアルカードと右側の対応する練習用単語を並べてマッチングさせます。",
+        "game_monster_feed_me": "このカードをちょうだい：",
+        "game_monster_correct": "モグモグ！大正解！🎉",
+        "game_monster_incorrect": "いたっ！違うカードだよ！😢",
+        "game_monster_no_words": "単語がまだ召喚されていません！",
+        "game_monster_no_words_desc": "まず「魔法の単語帳」タブに戻り、練習する言語を選択して「言葉を召喚する」をクリックしてください。",
+        "game_quiz_hint_btn": "ヒント 💡",
+        "game_quiz_replay_audio": "音声を再生 🔊",
+        "game_quiz_correct": "正解！🎉",
+        "game_quiz_incorrect": "不正解！もう一度挑戦してください！😢",
+        "game_quiz_question": "この単語を特定してください：",
+        "game_quiz_need_four": "視聴覚クイズをプレイするには、少なくとも4つの単語を召喚してください。",
+        "game_scramble_clue_label": "この単語を翻訳してください：",
+        "game_scramble_explanation_label": "ヒント：",
+        "game_scramble_reset_btn": "リセット 🔄",
+        "game_scramble_play_audio": "発音する 🔊",
+        "game_scramble_correct": "完璧なスペルです！🎉",
+        "game_scramble_incorrect": "おっと！もう一度試してください。",
+        "game_memory_moves": "手数量：",
+        "game_memory_congrats": "クリア！パーフェクトマッチ！🎉",
+        "game_memory_need_words": "フラッシュカード神経衰弱をプレイするには、少なくとも4つの単語を召喚してください。",
+        "game_linker_instruction": "左側のビジュアルカードをクリックしてから、一致する練習用の単語をクリックしてください！",
+        "game_linker_hint_btn": "ヒント 💡",
+        "game_linker_correct": "完璧な関連付けです！🎉",
+        "game_linker_incorrect": "不一致！もう一度試してください。😢",
+        "game_linker_select_clue": "ヒントを得るには、まず左側のカードを選択してください！",
+        "game_linker_need_words": "ビジュアル単語リンカーをプレイするには、少なくとも4つの単語を召喚してください。"
+    },
+    "Korean": {
+        "title": "✨ WordConjure: 즐거운 언어 모험!",
+        "subtitle": "대화형 게임과 커스텀 그림 카드로 함께 떠나는 마법의 시청각 단어 여행! 🌟",
+        "settings": "🛠️ 마법사의 설정 패널",
+        "word_count_label": "🔮 소환할 단어의 개수는?",
+        "expl_lang_label": "🗣️ 설명 언어",
+        "app_lang_label": "📱 앱 표시 언어",
+        "source_lang": "🌍 나의 모국어",
+        "target_lang": "🎯 연습할 언어",
+        "btn_get_words": "🪄 단어 소환하기!",
+        "tab_vocab": "📖 나만의 단어 마법책",
+        "tab_games": "🎮 게임 아레나",
+        "original_header": "마법 원어",
+        "translation_header": "마법 번역",
+        "explanation_header": "어떤 뜻일까?",
+        "visual_header": "아트 일러스트",
+        "audio_header": "소리 듣기",
+        "game_selection_title": "단어 도전 과제 선택",
+        "game_memory_title": "플래시카드 메모리 매치",
+        "game_memory_desc": "뒤집힌 카드를 넘겨 원본 단어와 번역 및 이미지 카드를 맞추세요.",
+        "game_monster_title": "배고픈 단어 몬스터 밥 주기",
+        "game_monster_desc": "몬스터가 굶주리고 있습니다! 요청에 맞는 올바른 번역 카드를 먹여주세요.",
+        "game_quiz_title": "시청각 퀴즈",
+        "game_quiz_desc": "발음을 듣거나 이미지 카드를 관찰한 후 올바른 원본 단어를 선택하세요.",
+        "game_scramble_title": "글자 배열 단어 맞추기",
+        "game_scramble_desc": "뒤섞인 철자를 올바른 순서로 배열하여 주어진 단어의 번역을 완성하세요.",
+        "game_linker_title": "이미지 단어 연결기",
+        "game_linker_desc": "왼쪽의 이미지 카드와 오른쪽의 일치하는 연습 단어를 나란히 연결하세요.",
+        "game_monster_feed_me": "다음 카드를 주세요:",
+        "game_monster_correct": "냠냠! 정답입니다! 🎉",
+        "game_monster_incorrect": "아야! 틀린 카드입니다! 😢",
+        "game_monster_no_words": "단어가 아직 소환되지 않았습니다!",
+        "game_monster_no_words_desc": "먼저 '나만의 단어 마법책' 탭으로 돌아가 학습할 언어를 선택한 후 '단어 소환하기'를 클릭해 주세요.",
+        "game_quiz_hint_btn": "힌트 💡",
+        "game_quiz_replay_audio": "오디오 재생 🔊",
+        "game_quiz_correct": "정답입니다! 🎉",
+        "game_quiz_incorrect": "오답입니다! 다시 시도하세요! 😢",
+        "game_quiz_question": "이 단어를 맞추세요:",
+        "game_quiz_need_four": "시청각 퀴즈를 플레이하려면 최소 4개의 단어를 소환해 주셔야 합니다.",
+        "game_scramble_clue_label": "이 단어를 번역하세요:",
+        "game_scramble_explanation_label": "단서:",
+        "game_scramble_reset_btn": "초기화 🔄",
+        "game_scramble_play_audio": "발음 듣기 🔊",
+        "game_scramble_correct": "완벽한 스펠링입니다! 🎉",
+        "game_scramble_incorrect": "앗! 다시 시도해 보세요.",
+        "game_memory_moves": "이동 횟수:",
+        "game_memory_congrats": "보드 클리어! 완벽한 매치! 🎉",
+        "game_memory_need_words": "플래시카드 메모리 매치를 플레이하려면 최소 4개의 단어를 소환해야 합니다.",
+        "game_linker_instruction": "왼쪽의 이미지 카드를 먼저 클릭한 후, 일치하는 연습 단어를 클릭하세요!",
+        "game_linker_hint_btn": "힌트 💡",
+        "game_linker_correct": "완벽한 매칭입니다! 🎉",
+        "game_linker_incorrect": "불일치! 다시 시도하세요. 😢",
+        "game_linker_select_clue": "힌트를 얻으려면 먼저 왼쪽의 카드를 선택하세요!",
+        "game_linker_need_words": "이미지 단어 연결기를 플레이하려면 최소 4개의 단어를 소환해야 합니다."
+    },
+    "Russian": {
+        "title": "✨ WordConjure: Играй и Учи!",
+        "subtitle": "Отправься в аудиовизуальное путешествие с играми и волшебными иллюстрациями! 🌟",
+        "settings": "🛠️ Панель Настроек Волшебника",
+        "word_count_label": "🔮 Сколько слов призвать?",
+        "expl_lang_label": "🗣️ Язык объяснений",
+        "app_lang_label": "📱 Язык интерфейса",
+        "source_lang": "🌍 Мой родной язык",
+        "target_lang": "🎯 Язык для практики",
+        "btn_get_words": "🪄 Призвать Слова!",
+        "tab_vocab": "📖 Моя Книга Слов",
+        "tab_games": "🎮 Игровая Арена",
+        "original_header": "Оригинальное слово",
+        "translation_header": "Магический перевод",
+        "explanation_header": "Что это значит?",
+        "visual_header": "Карточка-Иллюстрация",
+        "audio_header": "Послушать",
+        "game_selection_title": "Выберите игровое испытание",
+        "game_memory_title": "Найди пару",
+        "game_memory_desc": "Переворачивайте карточки, чтобы сопоставить оригинальные слова с их переводами и картинками.",
+        "game_monster_title": "Накорми слово-монстра",
+        "game_monster_desc": "Монстр проголодался! Дайте ему правильную карточку перевода в соответствии с его запросом.",
+        "game_quiz_title": "Аудиовизуальная викторина",
+        "game_quiz_desc": "Прослушайте произношение или посмотрите на карточку и выберите правильное оригинальное слово.",
+        "game_scramble_title": "Собери слово",
+        "game_scramble_desc": "Расположите перемешанные буквы в правильном порядке, чтобы написать перевод данного слова.",
+        "game_linker_title": "Визуальный соединитель слов",
+        "game_linker_desc": "Сопоставьте карточки слева с соответствующими словами для практики справа.",
+        "game_monster_feed_me": "ДАЙ МНЕ КАРТОЧКУ ДЛЯ:",
+        "game_monster_correct": "Ням! Верно! 🎉",
+        "game_monster_incorrect": "Ой! Не та карточка! 😢",
+        "game_monster_no_words": "Слова еще не призваны!",
+        "game_monster_no_words_desc": "Пожалуйста, вернитесь во вкладку 'Моя Книга Слов', выберите язык для практики и нажмите кнопку 'Призвать Слова'.",
+        "game_quiz_hint_btn": "Подсказка 💡",
+        "game_quiz_replay_audio": "Прослушать 🔊",
+        "game_quiz_correct": "Правильно! 🎉",
+        "game_quiz_incorrect": "Неверно! Попробуйте еще раз! 😢",
+        "game_quiz_question": "Определите это слово:",
+        "game_quiz_need_four": "Пожалуйста, призовите не менее 4 слов, чтобы сыграть в Аудиовизуальную викторину.",
+        "game_scramble_clue_label": "Переведите это слово:",
+        "game_scramble_explanation_label": "Подсказка:",
+        "game_scramble_reset_btn": "Сброс 🔄",
+        "game_scramble_play_audio": "Произнести 🔊",
+        "game_scramble_correct": "Отличное правописание! 🎉",
+        "game_scramble_incorrect": "Упс! Попробуйте еще раз.",
+        "game_memory_moves": "Ходы:",
+        "game_memory_congrats": "Поле очищено! Отличное совпадение! 🎉",
+        "game_memory_need_words": "Пожалуйста, призовите не менее 4 слов, чтобы сыграть в игру 'Найди пару'.",
+        "game_linker_instruction": "Нажмите на картинку слева, затем на соответствующее слово справа!",
+        "game_linker_hint_btn": "Подсказка ���",
+        "game_linker_correct": "Отличная ассоциация! 🎉",
+        "game_linker_incorrect": "Несовпадение! Попробуйте еще раз. 😢",
+        "game_linker_select_clue": "Сначала выберите карточку слева, чтобы получить подсказку!",
+        "game_linker_need_words": "Пожалуйста, призовите не менее 4 слов, чтобы сыграть в Визуальный соединитель слов."
+    },
+    "Portuguese": {
+        "title": "✨ WordConjure: Jogue e Aprenda!",
+        "subtitle": "Embarque em uma aventura de palavras com mini-jogos e ilustrações mágicas! 🌟",
+        "settings": "🛠️ Painel do Feiticeiro (Ajustes)",
+        "word_count_label": "🔮 Quantas palavras invocar?",
+        "expl_lang_label": "🗣️ Idioma das Explicações",
+        "app_lang_label": "📱 Idioma do Aplicativo",
+        "source_lang": "🌍 Minha língua nativa",
+        "target_lang": "🎯 Idioma para Praticar",
+        "btn_get_words": "🪄 Invocar Palavras!",
+        "tab_vocab": "📖 Meu Livro de Palavras",
+        "tab_games": "🎮 Arena de Jogos",
+        "original_header": "Palavra Original",
+        "translation_header": "Tradução Mágica",
+        "explanation_header": "O que significa?",
+        "visual_header": "Cartão de Arte",
+        "audio_header": "Ouvir som",
+        "game_selection_title": "Escolha o seu Desafio",
+        "game_memory_title": "Jogo da Memória",
+        "game_memory_desc": "Vire as cartas viradas para baixo para combinar os termos originais com suas traduções e cartões visuais.",
+        "game_monster_title": "Alimente o Monstro",
+        "game_monster_desc": "O monstro está faminto! Alimente-o com a carta de tradução correta que corresponde ao seu pedido.",
+        "game_quiz_title": "Quiz Audiovisual",
+        "game_quiz_desc": "Ouça a pronúncia ou inspecione o cartão visual e escolha o termo original correto.",
+        "game_scramble_title": "Palavras Embaralhadas",
+        "game_scramble_desc": "Organize as letras embaralhadas na ordem correta para soletrar a tradução da palavra fornecida.",
+        "game_linker_title": "Associador Visual de Palavras",
+        "game_linker_desc": "Combine os cartões visuais à esquerda com as palavras de treino correspondentes à direita.",
+        "game_monster_feed_me": "ALIMENTE-ME COM A CARTA PARA:",
+        "game_monster_correct": "Nham! Correto! 🎉",
+        "game_monster_incorrect": "Ui! Carta errada! 😢",
+        "game_monster_no_words": "Nenhuma palavra invocada ainda!",
+        "game_monster_no_words_desc": "Por favor, volte para 'Meu Livro de Palavras', selecione um idioma para praticar e clique em 'Invocar Palavras' primeiro.",
+        "game_quiz_hint_btn": "Dica 💡",
+        "game_quiz_replay_audio": "Tocar Áudio 🔊",
+        "game_quiz_correct": "Correto! 🎉",
+        "game_quiz_incorrect": "Incorreto! Tente novamente! 😢",
+        "game_quiz_question": "Identifique esta palavra:",
+        "game_quiz_need_four": "Por favor, invoque pelo menos 4 palavras para jogar o Quiz Audiovisual.",
+        "game_scramble_clue_label": "Traduza esta palavra:",
+        "game_scramble_explanation_label": "Dica:",
+        "game_scramble_reset_btn": "Redefinir 🔄",
+        "game_scramble_play_audio": "Pronunciar 🔊",
+        "game_scramble_correct": "Ortografia Perfeita! 🎉",
+        "game_scramble_incorrect": "Ops! Tente novamente.",
+        "game_memory_moves": "Jogadas:",
+        "game_memory_congrats": "Tabuleiro limpo! Combinação perfeita! 🎉",
+        "game_memory_need_words": "Por favor, invoque pelo menos 4 palavras para jogar o Jogo da Memória.",
+        "game_linker_instruction": "Clique em um cartão visual e, em seguida, clique na palavra de treino correspondente!",
+        "game_linker_hint_btn": "Dica 💡",
+        "game_linker_correct": "Associação Perfeita! 🎉",
+        "game_linker_incorrect": "Incompatível! Tente novamente. 😢",
+        "game_linker_select_clue": "Selecione primeiro uma carta à esquerda para obter uma dica!",
+        "game_linker_need_words": "Por favor, invoque pelo menos 4 palavras para jogar o Associador Visual de Palavras."
+    },
+    "Italian": {
+        "title": "✨ WordConjure: Gioca e Impara!",
+        "subtitle": "Parti per un'avventura di parole audiovisiva con minigiochi e illustrazioni magiche! 🌟",
+        "settings": "🛠️ Pannello delle Impostazioni Magiche",
+        "word_count_label": "🔮 Quante parole evocare?",
+        "expl_lang_label": "🗣️ Lingua delle spiegazioni",
+        "app_lang_label": "📱 Lingua dell'applicazione",
+        "source_lang": "🌍 Mia lingua madre",
+        "target_lang": "🎯 Lingua da praticare",
+        "btn_get_words": "🪄 Evoca Parole!",
+        "tab_vocab": "📖 Il Mio Grimoire delle Parole",
+        "tab_games": "🎮 Arena dei Giochi",
+        "original_header": "Parola Originale",
+        "translation_header": "Traduzione Magica",
+        "explanation_header": "Cosa significa?",
+        "visual_header": "Carta d'Arte",
+        "audio_header": "Ascolta",
+        "game_selection_title": "Scegli la tua Sfida",
+        "game_memory_title": "Memory di Flashcard",
+        "game_memory_desc": "Gira le carte coperte per abbinare i termini originali con le loro traduzioni e carte visive.",
+        "game_monster_title": "Nutri il Mostro",
+        "game_monster_desc": "Il mostro sta morendo di fame! Nutrilo con la carta di traduzione correta in base alla sua richiesta.",
+        "game_quiz_title": "Quiz Audio-Visivo",
+        "game_quiz_desc": "Ascolta la pronuncia o esamina la carta visiva, quindi scegli il termine originale corretto.",
+        "game_scramble_title": "Parole Disordinate",
+        "game_scramble_desc": "Disponi le lettere disordinate nell'ordine corretto per comporre la traduzione della parola data.",
+        "game_linker_title": "Collegamento Visivo",
+        "game_linker_desc": "Abbina le carte visive a sinistra con le corrispondenti parole da esercitare a destra.",
+        "game_monster_feed_me": "NUTRIMI CON LA CARTA PER:",
+        "game_monster_correct": "Gnam! Corretto! 🎉",
+        "game_monster_incorrect": "Ahia! Carta sbagliata! 😢",
+        "game_monster_no_words": "Nessuna palavra ancora evocata!",
+        "game_monster_no_words_desc": "Torna alla scheda 'Il Mio Grimoire delle Parole', seleziona una lingua e fai clic su 'Evoca Parole' per iniziare.",
+        "game_quiz_hint_btn": "Suggerimento 💡",
+        "game_quiz_replay_audio": "Riproduci Audio 🔊",
+        "game_quiz_correct": "Corretto! 🎉",
+        "game_quiz_incorrect": "Sbagliato! Riprova! 😢",
+        "game_quiz_question": "Identifica questa parola:",
+        "game_quiz_need_four": "Evoca almeno 4 parole per giocare al Quiz Audio-Visivo.",
+        "game_scramble_clue_label": "Traduci questa parola:",
+        "game_scramble_explanation_label": "Suggerimento:",
+        "game_scramble_reset_btn": "Ripristina 🔄",
+        "game_scramble_play_audio": "Pronuncia 🔊",
+        "game_scramble_correct": "Ortografia perfetta! 🎉",
+        "game_scramble_incorrect": "Ops! Riprova.",
+        "game_memory_moves": "Mosse:",
+        "game_memory_congrats": "Tabellone svuotato! Abbinamento perfetto! 🎉",
+        "game_memory_need_words": "Evoca almeno 4 parole per giocare al Memory delle Flashcard.",
+        "game_linker_instruction": "Fai clic su una carta visiva, poi sulla parola da esercitare corrispondente!",
+        "game_linker_hint_btn": "Suggerimento 💡",
+        "game_linker_correct": "Abbinamento perfetto! 🎉",
+        "game_linker_incorrect": "Mancata corrispondenza! Riprova. 😢",
+        "game_linker_select_clue": "Seleziona prima una carta a sinistra per ottenere un suggerimento!",
+        "game_linker_need_words": "Evoca almeno 4 parole per giocare al Collegamento Visivo."
+    }
+}
+
+TTS_SPEAKER_MAPPING = {
+    "English": "Aiden",
+    "Spanish": "Ryan",
+    "French": "Serena",
+    "German": "Aiden",
+    "Chinese": "Serena",
+    "Japanese": "Ono_Anna",
+    "Korean": "Sohee",
+    "Russian": "Aiden",
+    "Portuguese": "Ryan",
+    "Italian": "Ryan"
+}
+
+# Pool of topics and categories to maximize list variety across generations
+VOCAB_THEMES = [
+    "nature and environment", "travel and sightseeing", "cooking and ingredients", 
+    "occupations and careers", "hobbies and creative pursuits", "emotions and personalities", 
+    "household items and architecture", "animals and biology", "urban life and transportation", 
+    "weather, seasons and environment", "shopping and daily routines", "sports, health and human body",
+    "science, space and technology", "art, music and performances", "academic studies and school items"
+]
+
+VOCAB_TYPES = [
+    "a mix of parts of speech", "action verbs", "descriptive adjectives", "useful nouns"
+]
+
+# API: Fetch localization texts
+@app.api(name="get_localization")
+def get_localization(user_native_lang: str) -> dict:
+    return LOCALIZATION_DATABASE.get(user_native_lang, LOCALIZATION_DATABASE["English"])
+
+# Helper: Query causal LM
+def query_llm(prompt: str, max_new_tokens: int = 512) -> str:
+    messages = [
+        {"role": "user", "content": prompt}
+    ]
+    text = tokenizer.apply_chat_template(
+        messages, tokenize=False, add_generation_prompt=True
+    )
+    model_inputs = tokenizer([text], return_tensors="pt").to("cuda:0")
+    generated_ids = llm_model.generate(
+        **model_inputs,
+        max_new_tokens=max_new_tokens,
+        temperature=0.8,  # Slightly raised temperature for more creative/diverse vocabulary choice
+        top_p=0.9
+    )
+    input_len = model_inputs.input_ids.shape[1]
+    response_tokens = generated_ids[0][input_len:]
+    return tokenizer.decode(response_tokens, skip_special_tokens=True).strip()
+
+# Helper: Extract valid JSON array from LLM response
+def extract_json_array(text: str) -> list:
+    cleaned = text.strip()
+    if cleaned.startswith("```json"):
+        cleaned = cleaned[7:]
+    if cleaned.endswith("```"):
+        cleaned = cleaned[:-3]
+    cleaned = cleaned.strip()
+
+    match = re.search(r'\[\s*\[.*\]\s*\]', cleaned, re.DOTALL)
+    if match:
+        try:
+            return json.loads(match.group(0))
+        except Exception:
+            pass
+    try:
+        return json.loads(cleaned)
+    except Exception as e:
+        print(f"Failed to parse JSON array: {e}")
+        return []
+
+# Helper: Generate custom visual card using Sana Sprint 1.6B with English prompt
+def generate_visual_base64(image_prompt: str) -> str:
+    # We prefix standard style guidelines onto the LLM's custom English description
+    prompt = f"A simple, clean, minimalist flat icon style illustration of {image_prompt}, high quality educational flashcard illustration, isolated on white background"
+    
+    # Inference optimizations: Wrapped inside torch.inference_mode()
+    with torch.inference_mode():
+        image = sana_pipe(
+            prompt=prompt,
+            height=768,
+            width=768,
+            num_inference_steps=2,
+            guidance_scale=4.5
+        ).images[0]
+        
+    buffered = io.BytesIO()
+    image.save(buffered, format="PNG")
+    return base64.b64encode(buffered.getvalue()).decode("utf-8")
+
+# Helper: Generate TTS audio bytes via Qwen3-TTS
+def generate_audio_base64(word: str, language: str) -> str:
+    speaker = TTS_SPEAKER_MAPPING.get(language, "Aiden")
+    
+    # Inference optimizations: Wrapped inside torch.inference_mode()
+    with torch.inference_mode():
+        wavs, sr = tts_model.generate_custom_voice(
+            text=word,
+            language=language,
+            speaker=speaker,
+            instruct="Pronounce the text directly, clearly, and neutrally",
+            non_streaming_mode=True,
+            max_new_tokens=100,
+        )
+        
+    audio_data = wavs[0]
+    buffered = io.BytesIO()
+    sf.write(buffered, audio_data, sr, format="WAV")
+    return base64.b64encode(buffered.getvalue()).decode("utf-8")
+
+# API: Processes translation data sequentially
+@app.api(name="get_translations")
+@spaces.GPU(duration=30)
+def get_translations(source_lang: str, target_lang: str, word_count: int, explanation_lang: str) -> list[list[str]]:
+    explanation_lang_target = source_lang if explanation_lang == "source" else target_lang
+
+    # Randomizing parameters to force variety in vocab selection
+    selected_category = random.choice(VOCAB_THEMES)
+    selected_type = random.choice(VOCAB_TYPES)
+    random_seed = random.randint(100000, 999999)
+
+    prompt = f"""You are a professional multilingual translator.
+Generate a vocabulary list of exactly {word_count} words or phrases for language learning.
+Source Language: {source_lang}
+Practice/Target Language: {target_lang}
+
+To ensure high variety and prevent repeating standard words across sessions, apply the following randomized criteria to select your words:
+- Focus Topic/Theme: {selected_category}
+- Grammar/Category: {selected_type}
+- Generation Session Key: {random_seed}
+
+Ensure you select unique and engaging vocabulary. Avoid simple introductory words like "dog", "hello", "goodbye", or "cat" unless they directly fit the requested focus topic.
+
+For each item, generate:
+1. The source word or phrase.
+2. The target translation.
+3. A short, simple, clear, and friendly explanation (maximum 2 sentences) written in the {explanation_lang_target} language.
+4. An explicit, highly-descriptive illustration prompt in English, designed specifically for a text-to-image generator (e.g., instead of just "car", write "a modern red electric sedan parked quietly").
+
+You must return ONLY a raw JSON list of lists of strings, where each sublist contains exactly:
+[source_word, target_translation, explanation, english_image_prompt]
+
+Example format:
+[
+  ["Apple", "Manzana", "Una fruta redonda y de sabor dulce.", "a single crisp red apple with a small green leaf on top"],
+  ["Bicycle", "Bicicleta", "Un vehículo de dos ruedas que requiere pedalear.", "a classic blue commuter bicycle with a small front basket"]
+]
+
+Do not include any chat commentary, introduction, or explanations outside the JSON array."""
+
+    response = query_llm(prompt, 1024)
+    raw_pairs = extract_json_array(response)
+    
+    validated_pairs = []
+    for item in raw_pairs:
+        # Support fallback states in case the model returns fewer than 4 components
+        if isinstance(item, list) and len(item) >= 4:
+            validated_pairs.append([str(item[0]), str(item[1]), str(item[2]), str(item[3])])
+        elif isinstance(item, list) and len(item) == 3:
+            validated_pairs.append([str(item[0]), str(item[1]), str(item[2]), f"a minimalist illustration representing {item[1]}"])
+        elif isinstance(item, list) and len(item) == 2:
+            validated_pairs.append([str(item[0]), str(item[1]), "", f"a minimalist illustration representing {item[1]}"])
+            
+    selected_words = validated_pairs[:word_count]
+    
+    # Step 2: Generate corresponding images sequentially using the English prompt
+    visuals = []
+    for item in selected_words:
+        image_prompt = item[3]  # Extracting English visual prompt
+        try:
+            visual_b64 = generate_visual_base64(image_prompt)
+        except Exception as e:
+            print(f"Error generating visual card with prompt '{image_prompt}': {e}")
+            visual_b64 = ""
+        visuals.append(visual_b64)
+        
+    # Step 3: Generate all corresponding audio files sequentially
+    audios = []
+    for item in selected_words:
+        target_word = item[1]
+        try:
+            audio_b64 = generate_audio_base64(target_word, target_lang)
+        except Exception as e:
+            print(f"Error generating audio track for '{target_word}': {e}")
+            audio_b64 = ""
+        audios.append(audio_b64)
+        
+    # Step 4: Assemble into final frontend format: [original, translated, explanation, visual_b64, audio_b64]
+    results = []
+    for idx, (original, translated, explanation, _) in enumerate(selected_words):
+        results.append([
+            original,
+            translated,
+            explanation,
+            visuals[idx],
+            audios[idx]
+        ])
+        
+    return results
+
+# Route: Serve HTML page
+@app.get("/", response_class=HTMLResponse)
+def homepage():
+    html_path = "index.html"
+    with open(html_path, "r", encoding="utf-8") as f:
+        return f.read()
+
+if __name__ == "__main__":
+    app.launch(debug=True, show_error=True)