Skip to main content

GTK4 spelling quiz app with text-to-speech and AI generated example sentences.

Project description

Spelling Bee icon

Spelling Bee TTS

Spelling Bee TTS is a spelling testing app I wrote for my kids. It uses natural text-to-speech for the prompt and a local large language model to generate definitions and example sentences. It has a built in corpus of ~31,000 words.

The app tracks the user's progress and automatically adjusts the word difficulty level based on how well they're doing.

Screenshot

Install

System dependencies (Ubuntu):

sudo apt install python3-gi gir1.2-gtk-4.0 mpv

System dependencies (macOS with Homebrew):

brew install python gtk4 pygobject3 gobject-introspection mpv

Install with pip:

pip install spelling-bee-tts

Run

On Linux pip creates a application shortcut. Hit your launcher and search for 'spell'. Or to run from the command line:

python3 -m spellingbee

Notes

  • edge-tts requires network access.
  • You can override the voice with EDGE_TTS_VOICE (default: en-US-AriaNeural).
  • Offline sentence generation uses llama-cpp-python with a local GGUF model.
    • By default, the app prompts to download Qwen3-4B-Instruct-2507 Q8_0 into the Hugging Face cache on first use.
    • Override with LLM_REPO_ID or LLM_MODEL_PATH.
    • Optional tuning: LLM_N_CTX, LLM_THREADS, LLM_N_BATCH, LLM_TEMPERATURE, LLM_TOP_P.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spelling_bee_tts-0.4.2.tar.gz (992.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

spelling_bee_tts-0.4.2-py3-none-any.whl (989.0 kB view details)

Uploaded Python 3

File details

Details for the file spelling_bee_tts-0.4.2.tar.gz.

File metadata

  • Download URL: spelling_bee_tts-0.4.2.tar.gz
  • Upload date:
  • Size: 992.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for spelling_bee_tts-0.4.2.tar.gz
Algorithm Hash digest
SHA256 20fc87e610bbf34e2c0efe651fb4354fe05d5985f8e05a4ceceb606b2058c023
MD5 550968a5b51514d7a73b82aa9b204d31
BLAKE2b-256 ec604513779429544c39a3a3961192f73888efb1b156d04ab253e3b0ea54ad61

See more details on using hashes here.

File details

Details for the file spelling_bee_tts-0.4.2-py3-none-any.whl.

File metadata

File hashes

Hashes for spelling_bee_tts-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 48d423a50f0688080328b2a2bfd9f7b01e7979e6411f125ae844f3b64d1f9a94
MD5 34717036457f45164de78b16b5c5d765
BLAKE2b-256 fa16d8170a21d2a65d03d09f2be93a0051c330abc11271d70c010f09934e194e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page