Skip to content

Compatibility and releases

These guides describe this source checkout. Package versions, supported APIs, platform verification and public registry availability are separate facts. Use the linked release evidence before choosing a published dependency.

Interface Source version Environment Distribution evidence
Rust 0.1.0 Rust 1.92+ Release audit; use the source setup until publication is confirmed
Node / TypeScript 0.2.0 Node 22.13+; candidate macOS arm64/x64, Linux x64 GNU, Windows x64 Coverage records local verification and remaining release gates
Python 0.2.0 Ordinary CPython 3.11/3.12; macOS arm64/x64, Linux x64, Windows x64 Coverage records four-platform wheel and source-distribution verification; it is not a PyPI publication notice

Python’s metadata allows Python 3.11+, but the declared verified matrix covers 3.11 and 3.12. Other versions, free-threaded interpreters and subinterpreters are not claimed. Node’s candidate matrix does not cover browser execution, Electron, Bun, Alpine/musl or ARM64 Linux/Windows.

Start with Rust, Node, or Python. For an existing Python 0.1 integration, read the 0.2 migration guide before upgrading.

  • Rust’s public consumer API is pre-1.0. Import anki_forge::prelude::*; internal-tools is reserved for repository tooling.
  • Image Occlusion supports hide-all-guess-one. The shared core currently rejects hide-one-guess-one grouped cloze output.
  • Text and HTML differ between Project content setters and Deck conveniences. Choose escaping deliberately.
  • Templates are checked for supported Anki semantics. Validation does not prove browser HTML/CSS/JavaScript correctness or execute third-party add-on filters.
  • Update baselines provide identity and revision evidence. Import settings, newer local edits and review scheduling remain controlled by Anki.
  • Output publication is atomic per file, not a transaction spanning APKG, lockfile and report JSON.

The runnable guides check exported packages and reports. A package that passes those checks still needs client validation for the behavior you plan to promise: rendering, actual audio/video playback, upgrade imports and review state.

The repository keeps manual validation scenarios and recorded showcase verification. Each record’s Anki version, scenarios and scope apply to that record; they are not a blanket claim for all clients or future versions.