Gere cartões do Anki
a partir dos seus dados.

O Anki Forge é uma biblioteca de código aberto para gerar APKGs do Anki, com núcleo em Rust e interfaces Rust, Python e Node.js. Inclua mídia, use templates personalizados e revise atualizações antes de distribuí-las.

Quatro tipos de cartão. Um baralho do Anki.

Escolha sua linguagem de programação.

Exporte spanish.apkg com o pacote público 0.3.1. A exportação normal não exige instalar o Anki.

Rust

Rust 1.92+
cargo add ankiforge@0.3.1
Crie com Rust

Python

CPython 3.11+
python -m pip install ankiforge==0.3.1
Crie com Python

Use o Anki Forge com IA.

Escolha uma linguagem de programação, descreva sua tarefa e cole as instruções no seu assistente de programação com IA.

Rust

Instruções para a IA · Anki Forge 0.3.1
Ajude-me a usar Anki Forge 0.3.1 em uma aplicação Rust.
Requisito de execução: Rust 1.92+

Use o pacote publicado `ankiforge` e somente a API pública documentada para
esta versão. Não use dependências git/path, ferramentas internas, APIs
exclusivas do código-fonte, métodos não publicados ou métodos inventados.

Minha tarefa:
<descreva sua tarefa>

Por favor:
1. Examine o projeto existente antes de alterar arquivos.
2. Informe a configuração necessária e o comando exato de instalação: cargo add ankiforge@0.3.1
3. Crie o menor programa completo e executável e indique cada arquivo a criar ou editar.
4. Gere um arquivo `.apkg` persistente e use namespace e chaves de nota estáveis.
5. Inclua o comando de execução, a saída esperada e uma etapa de verificação.
6. Se a tarefa precisar de mídia, templates personalizados, oclusão de imagem ou
   atualizações, siga o fluxo documentado em vez de presumir a API. Para atualizar,
   guarde o APKG original distribuído da versão anterior como base; não use
   uma reexportação do Anki.
7. Faça somente as perguntas necessárias para esclarecer a linguagem, o formato
   da entrada, o caminho de saída ou a regra de identidade.

Referência de início rápido: https://ankiforge.dev/pt-br/docs/quickstart/
Rust 1.92+
cargo add ankiforge@0.3.1

Node / TypeScript

Instruções para a IA · Anki Forge 0.3.1
Ajude-me a usar Anki Forge 0.3.1 em uma aplicação Node / TypeScript.
Requisito de execução: Node.js 22.13+

Use o pacote publicado `ankiforge` e somente a API pública documentada para
esta versão. Não use dependências git/path, ferramentas internas, APIs
exclusivas do código-fonte, métodos não publicados ou métodos inventados.

Minha tarefa:
<descreva sua tarefa>

Por favor:
1. Examine o projeto existente antes de alterar arquivos.
2. Informe a configuração necessária e o comando exato de instalação: npm install --include=optional ankiforge@0.3.1
3. Crie o menor programa completo e executável e indique cada arquivo a criar ou editar.
4. Gere um arquivo `.apkg` persistente e use namespace e chaves de nota estáveis.
5. Inclua o comando de execução, a saída esperada e uma etapa de verificação.
6. Se a tarefa precisar de mídia, templates personalizados, oclusão de imagem ou
   atualizações, siga o fluxo documentado em vez de presumir a API. Para atualizar,
   guarde o APKG original distribuído da versão anterior como base; não use
   uma reexportação do Anki.
7. Faça somente as perguntas necessárias para esclarecer a linguagem, o formato
   da entrada, o caminho de saída ou a regra de identidade.

Referência de início rápido: https://ankiforge.dev/pt-br/docs/node-quickstart/
Node.js 22.13+
npm install --include=optional ankiforge@0.3.1

Python

Instruções para a IA · Anki Forge 0.3.1
Ajude-me a usar Anki Forge 0.3.1 em uma aplicação Python.
Requisito de execução: CPython 3.11+

Use o pacote publicado `ankiforge` e somente a API pública documentada para
esta versão. Não use dependências git/path, ferramentas internas, APIs
exclusivas do código-fonte, métodos não publicados ou métodos inventados.

Minha tarefa:
<descreva sua tarefa>

Por favor:
1. Examine o projeto existente antes de alterar arquivos.
2. Informe a configuração necessária e o comando exato de instalação: python -m pip install ankiforge==0.3.1
3. Crie o menor programa completo e executável e indique cada arquivo a criar ou editar.
4. Gere um arquivo `.apkg` persistente e use namespace e chaves de nota estáveis.
5. Inclua o comando de execução, a saída esperada e uma etapa de verificação.
6. Se a tarefa precisar de mídia, templates personalizados, oclusão de imagem ou
   atualizações, siga o fluxo documentado em vez de presumir a API. Para atualizar,
   guarde o APKG original distribuído da versão anterior como base; não use
   uma reexportação do Anki.
7. Faça somente as perguntas necessárias para esclarecer a linguagem, o formato
   da entrada, o caminho de saída ou a regra de identidade.

Referência de início rápido: https://ankiforge.dev/pt-br/docs/python-quickstart/
CPython 3.11+
python -m pip install ankiforge==0.3.1

Tempo de exportação

Rust Project API / genanki 0.13.1 · 1.000 notas Basic por carga de trabalho

52,7 msExporte 1.000 notas somente com texto
45,7–53,9%Menor tempo de exportação nas cinco cargas de trabalho medidas

Rust Project API · Apple M1 Pro · Medianas de 10 execuções

Texto, imagens e áudio.
Mais rápido nos cinco testes.

Cada teste usa 1.000 notas Basic. Os cinco testes abrangem notas só com texto, arquivos de mídia diferentes e mídia compartilhada entre notas. Nesses testes, a API Rust do Anki Forge levou de 45,7% a 53,9% menos tempo para exportar do que o genanki.

Anki Forge Rustgenanki
Somente texto49,8% menos tempo

52,7 ms / 105,0 ms

Uma imagem diferente por nota52,9% menos tempo

150,7 ms / 320,2 ms

Um áudio diferente por nota53,3% menos tempo

128,7 ms / 275,4 ms

Imagens e áudio sem compartilhamento53,9% menos tempo

110,5 ms / 239,5 ms

Imagens e áudio compartilhados45,7% menos tempo

61,4 ms / 112,9 ms

Os resultados medem a geração de baralhos, não a velocidade de importação ou revisão no Anki; outros equipamentos e cargas de trabalho podem apresentar resultados diferentes. Método e medições originais

Veja o código. Experimente o cartão.

Alterne entre exemplos executáveis em Rust, vire os cartões e baixe os baralhos gerados.

Código Rust → prévia no navegador
let (front, back) = ("hola", "hello");
let mut project = Project::new("spanish")?.default_deck("Spanish");
project.add("es:hola", Note::basic(front, back))?;
let built = project.build(BuildOptions::to(output.join("spanish.apkg")))?;

Spanish
Espanhol → inglês

hola

O que isso significa?

Pergunta exibida.

Prévias do conteúdo exportado no navegador; importe o APKG para conferir no Anki.

Aprimore suas notas.
Mantenha os mesmos IDs.

Corrija uma definição ou acrescente um exemplo. Mantenha os IDs das notas e use o APKG original da versão anterior para que o Anki Forge reconheça as notas existentes na próxima exportação.

Entenda as atualizações de baralhos
ID estável da notaes:hola
Frente

hola

Verso

hello

Experimente alterar o conteúdo.

Comparação real: RISK.NOTE_CHANGED (low). Política de publicação: permite esta alteração.

Baixar v1Baixar v2Relatório de comparação

Guarde o APKG original distribuído. As opções de importação e as edições locais mais recentes afetam as atualizações. Guia de atualização

Encontre problemas antes de exportar.

Consulte diagnósticos de campos obrigatórios não preenchidos e problemas de mídia ou templates. Inclua a validação no seu processo de geração.

Conheça a validação

Seus cartões. Seus templates.

Comece com Basic e Cloze ou defina seus próprios tipos de nota. Reúna HTML, CSS e mídia em pacotes de templates reutilizáveis.

Explore os templates

Do primeiro baralho à próxima atualização

Comece com uma planilha CSV, dados JSON ou rascunhos criados com um assistente de IA. Siga um tutorial completo de exportação e depois adicione mídia e revise atualizações.