langlearn-anki

Anki deck generation for language learning (media in, decks out).

Status (2026-02-21)

• build consumes cards.json and media.json and exports a basic Front/Back deck.
• Media is required and never generated inside this package.
• Template library exists (German, Korean, Russian) and is wired into deck generation via the template repository.

Roadmap

See ROADMAP.md.

Install

uv tool install punt-langlearn-anki

CLI

langlearn-anki --help
langlearn-anki --json version
langlearn-anki doctor
langlearn-anki build --help
langlearn-anki install
langlearn-anki serve

Example:

langlearn-anki build --language de --deck "Demo" --data-dir ./data

Data format

cards.json example:

[
  {"front": "Hallo", "back": "Hello", "audio_id": "a1", "image_id": "i1", "tags": ["demo"]}
]

media.json example:

{
  "audio": {"a1": "audio/hallo.mp3"},
  "images": {"i1": "images/hallo.png"}
}

MCP

langlearn-anki install
langlearn-anki serve

Development

uv sync --all-extras
uv run ruff check .
uv run ruff format --check .
uv run mypy src/ tests/
uv run pyright src/ tests/
uv run pytest