IELTSagent

Local-first IELTS writing coach + image-based word cards

Open-source on GitHub

A local-run English learning project with two parallel modules: (1) IELTS Writing assistant (Task 1 / Task 2) with scoring, error analysis, improvement suggestions and revised essays; (2) Image word-card learning: segment targets from images, auto-name in English, translate to Chinese, and archive cards.

IELTSagent cover

Features

Local Run (Quick Start)

Install dependencies:

pip install -r requirements.txt

Copy .env.template to .env and fill your keys (e.g. Qwen API Key, HF Token). Then initialize data/indexes:

python scripts/setup_data_and_indexes.py

Start the server:

python app.py

Open: http://127.0.0.1:5000/ (home) and http://127.0.0.1:5000/word-learning (word learning).