WordMiner is an AI-powered CLI application that helps advanced English (also German in future) learners discover, learn, and retain C1-C2 vocabulary from authentic articles.
Instead of relying on predefined word lists, WordMiner automatically mines sophisticated vocabulary from high-quality publications using LLM, stores each word together with its context, and helps users remember it through a Spaced Repetition System.
-
📚 Automated Mining
- Fetches random long-form articles from high-quality sources such as BBC News, The Guardian, Aeon, and Nautilus.
-
🤖 AI-Powered Extraction
- Uses LLM to identify advanced vocabulary.
-
💬 Contextual Learning
- Stores every word together with:
- its original sentence,
- a concise definition,
- an easy synonym used as a learning hint.
- Stores every word together with:
-
🧠 Spaced Repetition
- Reviews vocabulary using a Spaced Repetition System.
git clone https://github.com/yourusername/wordminer.git
cd wordmineruv syncGOOGLE_API_KEY=your_api_key
Mine new vocabulary:
uv run main.pyPractice learned words:
uv run main.py --practice- German language support
- Word graph
- Support multiple LLM providers
- Learning statistics dashboard
- Additional article sources
This project is licensed under the MIT License.