---
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

```bash
pip install gradio gTTS
python app.py
```