Python で Anki カードを生成する

仮想環境を作成して有効にし、PyPI の公開パッケージをインストールします。

python -m venv .venv
. .venv/bin/activate
python -m pip install ankiforge==0.3.1

Windows では .venv\Scripts\Activate.ps1 で有効にします。通常の CPython 3.11 以降と、プラットフォームに一致する wheel を使用してください。記録済みのリリース検証では CPython 3.11〜3.14 を確認しています。検証済みの環境を参照してください。

デッキをエクスポートする

次を main.py に保存します。

from ankiforge import Project, Note, BuildOptions

project = Project('spanish', default_deck='Spanish')
project.add('es:hola', Note.basic('hola', 'hello'))
output = project.build(BuildOptions.to('spanish.apkg'))
print(output.artifact.path)

python main.py

永続ファイル spanish.apkg を Anki で開きます。Spanish デッキに hola → hello が含まれています。後で編集する際も、名前空間 spanish とノートキー es:hola を維持してください。エクスポートに Anki のインストールは必要ありません。

次のステップ

語彙の表を使う場合は CSV から Anki を生成するを参照してください。学習メモからカードの下書きを作る場合は、AI を使ったカード作成から始められます。

メディアと更新を含む一連の作業は、JSON から Anki を生成するで確認できます。

• 画像と音声と Python のメディア API
• 独自のノートタイプとテンプレートバンドル
• 画像穴埋め
• 比較と更新
• Python API と診断
• genanki からの移行

ネイティブ拡張をソースからビルドするには、ソースからのビルドを参照してください。