Files

local 2e8c2c11d0 Add persian-tutor: Gradio-based GCSE Persian language learning app

Vocabulary study with FSRS spaced repetition, AI tutoring (Ollama/Claude),
essay marking, idioms browser, Anki export, and dashboard. 918 vocabulary
entries across 39 categories. 41 tests passing.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-08 01:57:44 +00:00

1.8 KiB

Raw Blame History

Persian Language Tutor

A Gradio-based Persian (Farsi) language learning app for English speakers, built around GCSE Persian vocabulary (Pearson specification).

Features

Vocabulary Study — Search, browse, and study 918 GCSE Persian words across 39 categories
Flashcards with FSRS — Spaced repetition scheduling (same algorithm as Anki)
Idioms & Expressions — 25 Persian social conventions with cultural context
AI Tutor — Conversational Persian lessons by GCSE theme (via Ollama)
Essay Marking — Write Persian essays, get AI feedback and grading (via Claude)
Dashboard — Track progress, streaks, and mastery
Anki Export — Generate .apkg decks for offline study
Voice Input — Speak Persian via microphone (Whisper STT) in the Tutor tab

Prerequisites

whisper-ollama conda environment with Python 3.10+
Ollama running locally with qwen2.5:7b (or another model)
Claude CLI installed (for essay marking / smart mode)

Setup

/home/ys/miniforge3/envs/whisper-ollama/bin/pip install gradio genanki fsrs

Running the app

cd /home/ys/family-repo/Code/python/persian-tutor
/home/ys/miniforge3/envs/whisper-ollama/bin/python app.py

Then open http://localhost:7860 in your browser.

Running tests

cd /home/ys/family-repo/Code/python/persian-tutor
/home/ys/miniforge3/envs/whisper-ollama/bin/python -m pytest tests/ -v

41 tests covering db, vocab, ai, and anki_export modules.

Expanding vocabulary

The vocabulary can be expanded by editing data/vocabulary.json directly or by updating scripts/build_vocab.py and re-running it:

/home/ys/miniforge3/envs/whisper-ollama/bin/python scripts/build_vocab.py

TODO

Voice-based vocabulary testing — answer flashcard prompts by speaking Persian
Improved UI theme and layout polish

1.8 KiB Raw Blame History