fluent

🌍 Fluent

The AI Language Learning Kit for Claude Code and others

A comprehensive set of rules, guidance, and intelligent tracking systems that transform Claude Code into your personal language tutor. Master any language through adaptive practice powered by proven cognitive science—spaced repetition, active recall, and progress tracking that learns from you.

https://github.com/user-attachments/assets/66d68aad-210a-452d-b405-b58c13f42f53

---

🚀 Quick Start

1. Install

claude plugin marketplace add m98/fluent && claude plugin install fluent@m98

One line. Registers the marketplace, installs the plugin. Works globally from any directory after this.

2. Start learning

Restart Claude Code, then:

/fluent-setup     # onboard: name, target language, level, goals
/fluent-learn     # begin your first session

That's it.

---

Requirements

• Claude Code installed
• Python 3.8+ (most systems already have it — check with python3 --version). Install via python.org, brew install python3, or your distro's package manager. No pip packages needed — Fluent uses only the standard library.
• Bash for the PreCompact backup hook (built-in on macOS/Linux; on Windows use WSL or Git Bash).

Verify, update, uninstall

claude plugin list                    # expect: fluent@m98  enabled
claude plugin update fluent@m98       # pull latest version
claude plugin uninstall fluent@m98    # remove entirely

Alternative: git clone

Prefer to hack on the skills or keep per-project state?

git clone https://github.com/m98/fluent.git
cd fluent
claude          # launch from repo root
/fluent-setup

Learner data lives in ./data/ inside the cloned repo instead of ~/.claude/fluent-data/.

Where your data lives

Fluent resolves the data directory in this order — first match wins:

1. $FLUENT_DATA_DIR if set (override everything).
2. $CLAUDE_PROJECT_DIR/data/ if it has learner-profile.json (clone mode, running from outside the repo root).
3. ./data/ if it has learner-profile.json (clone mode, running inside the repo).
4. ~/.claude/fluent-data/ (plugin-install default).

Set FLUENT_DATA_DIR to run multiple learners on one machine:

export FLUENT_DATA_DIR=~/.fluent/dutch

Check where Fluent is currently looking:

python3 -c "import sys; sys.path.insert(0, '.claude/hooks'); from fluent_paths import data_dir; print(data_dir())"

---

💡 Why This Actually Works

Most language learning apps fail because they're built for engagement metrics, not actual learning. This system is different.

🎯 Three Reasons This Works Where Others Fail:

1. Zero Distractions, Pure Focus

• ❌ No ads interrupting your flow
• ❌ No gamification gimmicks designed to waste your time
• ❌ No unreliable fancy UI that breaks
• ✅ Just you, the language, and an AI that adapts to your needs

2. Infinitely Adaptable Intelligence

• 🧠 Want to practice job interview phrases? Just ask.
• 🧠 Need help with a specific grammar rule? It explains it.
• 🧠 Want to focus on restaurant vocabulary? It creates exercises instantly.
• 🧠 You're in control. The AI does exactly what you need, when you need it.

3. Your Private, Smart Tutor

• 📊 Tracks everything - Every answer, every mistake, every improvement
• 🔄 Learns about YOU - Knows your weak patterns and strengths
• 📈 Adapts to YOU - Adjusts difficulty based on your performance
• 🔒 Private - All data stays on your machine, no external tracking
• 🎯 Personal - Like having a tutor who knows your exact level and learning style

The Result? A learning system that feels like a conversation with an expert friend who remembers everything, tracks your progress scientifically, and makes learning actually enjoyable.

---

📖 What Is This?

This is a comprehensive, open-source language learning system that transforms Claude Code into your personal AI language tutor.

The system uses evidence-based learning methodologies including:

• Spaced Repetition (SM-2 algorithm) - Review at optimal intervals
• Active Recall - Test yourself before seeing answers
• Adaptive Difficulty - Always challenging, never frustrating
• Comprehensive Tracking - Every answer tracked and analyzed

✨ Key Features