README.md

metadata

title: Spelling Practice
emoji: 📝
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 4.40.0
app_file: app.py
pinned: false
license: mit

Spelling Practice 📝

An interactive English spelling trainer powered by gTTS (audio) and optionally Gemma (AI tips).

How to use

1. Click New Sentence — a sentence is read aloud.
2. Type exactly what you heard in the text box.
3. Click Submit (or press Enter).
4. Errors are shown with strikethrough (wrong) and the correct word in bold.
5. Get 3 correct answers in a row to level up.

Difficulty levels

Level	Label
1	🟢 Beginner
2	🔵 Intermediate
3	🟠 Advanced
4	🔴 Expert

Multi-user support

Every browser session gets its own isolated state via gr.State.
Concurrent users don't share or interfere with each other.

Optional: AI Tips with Gemma

To enable in-app spelling tips from a local LLM:

1. Upload a .gguf model file to your Space repository (e.g. gemma-4-E2B-it-Q4_0.gguf).
2. Uncomment llama-cpp-python in requirements.txt.
3. If your Space has a GPU, replace the pip line with the CUDA wheel:

   llama-cpp-python --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu121
   

4. Set the N_GPU_LAYERS Space secret to -1 (full GPU offload) or 0 (CPU only).

Without a model file the app runs fine — the tip section is simply hidden.

Local development

pip install gradio gTTS
python app.py