Genera un APKG de Anki con Python

Crea y activa un entorno virtual e instala el paquete publicado en PyPI:

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

En Windows, actívalo con .venv\Scripts\Activate.ps1. Usa CPython estándar 3.11 o posterior y un wheel que corresponda a tu plataforma; las comprobaciones de publicación registradas cubren CPython 3.11–3.14. Consulta los entornos verificados.

Exporta un mazo

Guarda lo siguiente como 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

Abre el archivo persistente spanish.apkg en Anki. Contiene hola → hello en el mazo Spanish. Conserva el espacio de nombres spanish y la clave de nota es:hola cuando edites el contenido. No necesitas instalar Anki para exportarlo.

Continúa

Si partes de una hoja de vocabulario, sigue CSV a Anki. Para preparar borradores de tarjetas a partir de tus apuntes, empieza con la creación de tarjetas con ayuda de IA.

Para completar una tarea con recursos multimedia y actualizaciones, sigue JSON a Anki.

• Imágenes y audio y API multimedia de Python.
• Tipos de nota personalizados y paquetes de plantillas.
• Oclusión de imágenes.
• Comparación y actualización.
• API de Python y diagnósticos.
• Migración desde genanki.

Para compilaciones nativas desde el repositorio, consulta la guía de compilación desde el código fuente.