Perguntas antes de instalar

Para quem quer aprender um idioma com seu próprio material e está disposto a retomá-lo ao longo de meses ou anos. Você escolhe palavras de livros, legendas, aulas ou conversas, e o kamishibai cria cartões com elas. O programa não substitui um curso: não escolhe por você os temas nem a ordem de estudo.

O Anki cuida das revisões. O planejamento se baseia na repetição espaçada: os cartões que você lembra voltam em intervalos cada vez maiores, e os esquecidos voltam antes. O número de cartões novos e os limites diários são configurados no Anki.

Acredito que, graças à nova geração de agentes de IA, podemos criar software autoral com a mesma facilidade com que antes escrevíamos blogs: compartilhar nossa experiência por meio de abordagens que outras pessoas possam aplicar com facilidade. O Kamishibai é minha forma de colocar essa ideia à prova. Antes de tudo, é uma ferramenta que eu mesmo uso todos os dias e desenvolvo a partir dessa prática.

Um mangaká reúne pessoalmente história, desenho e personalidade dos personagens em uma obra coerente. Gosto dessa abordagem autoral. Daí vem a linguagem visual do kamishibai: gosto quando um projeto tem uma visão própria, que aparece tanto no conceito quanto no visual.

No modo principal, uma lista de palavras ou expressões que você quer aprender. Não é preciso colocá-las na forma de dicionário: o kamishibai tenta reconhecer o texto inserido e apresenta significados para você escolher. Cada significado selecionado gera um cartão separado com uma frase.

Se a frase não servir, você pode descrever o que precisa mudar e gerar outra versão. Se já tiver os textos dos cartões prontos, pode fornecê-los no formato cards JSON. Há uma resposta específica sobre isso mais abaixo.

O Kamishibai prepara o material: cria frases, explicações, áudio e ilustrações, depois reúne tudo em um arquivo .apkg, um baralho que pode ser aberto no Anki.

O Anki organiza as revisões: mostra os cartões, salva suas avaliações e define a data da próxima revisão.

O Kamishibai também cria um PDF para cartões de papel. Você pode imprimir e recortar os cartões se quiser estudar sem tela.

Não. Depois da instalação, você abre o kamishibai no terminal, uma janela com interface de texto. A partir daí, o programa guia cada etapa: adicionar palavras, escolher significados, conferir os cartões e obter o baralho. Não é preciso escrever código.

Para automação, há comandos próprios que retornam respostas em JSON. Scripts e agentes de IA podem usá-los, mas eles não são necessários no uso normal.

Você escolhe as palavras e os significados, e os modelos de IA criam o material seguindo as regras do kamishibai. Elas definem a estrutura do cartão e os requisitos para a frase, a explicação, o áudio e a ilustração.

Antes de gerar os cartões, você pode escolher a dificuldade e o tipo de frase: afirmações, perguntas, diálogos ou uma mistura. Depois pode conferir o resultado e pedir uma nova versão indicando o que deseja mudar.

São 22 idiomas: inglês, chinês, espanhol, japonês, francês, alemão, coreano, russo, italiano, português, hindi, árabe, turco, polonês, ucraniano, indonésio, vietnamita, tailandês, grego, hebraico, neerlandês e tcheco.

Cada baralho usa um par: o idioma que você está aprendendo e o das traduções e explicações. É possível combinar quaisquer dois idiomas da lista. A qualidade do material depende de como os modelos trabalham com o par escolhido.

Se precisar de outro idioma, abra um pedido no GitHub e veremos o que dá para fazer.

Para criar cartões, você precisa de:

• Um computador com macOS, Linux ou Windows.
• Conexão com a internet: texto, áudio e ilustrações são criados pela API do Gemini.
• Sua própria chave de API do Gemini. Criar uma chave no Google AI Studio →

Para revisar, instale o Anki →

Se o idioma escolhido exigir uma verificação local de texto nas imagens, o programa também baixará modelos de reconhecimento de texto (OCR) ao criar ilustrações pela primeira vez.

Há versões prontas para instalar no macOS, Linux e Windows.

• macOS e Linux: instalação pelo Homebrew ou pelo script de instalação.
• Windows: o script de instalação é executado no Git Bash, MSYS ou Cygwin.

Os comandos e o link para o script estão na seção de instalação.

O Kamishibai é gratuito e seu código-fonte é aberto. As solicitações ao Gemini feitas com sua chave de API são cobradas à parte.

Como referência, considere cerca de US$ 15 por 100 cartões com texto, áudio e ilustrações. É uma estimativa: o total depende da quantidade de material, das novas tentativas de geração e das tarifas dos modelos. Os modelos já estão escolhidos no programa, então você não precisa configurá-los para começar.

Com quatro cartões novos por dia, um baralho de cem cartões rende 25 dias. As frases aprendidas precisam continuar sendo revisadas depois disso. Por isso escolho palavras que realmente quero usar e priorizo a qualidade dos cartões em vez do menor custo possível de geração.

Seu trabalho fica salvo no computador: configurações, sessões, cache e arquivos prontos. O Kamishibai não tem um servidor próprio para criar cartões.

Para gerar e verificar o material, o programa envia ao Gemini palavras, frases e as ilustrações que precisam ser avaliadas, usando sua chave de API. Se você sincronizar pelo Anki, o baralho pronto e os arquivos de mídia também serão enviados ao AnkiWeb.

A chave salva fica em um arquivo local de configurações, não no gerenciador de senhas do sistema. Não compartilhe esse arquivo com outras pessoas nem o adicione a um repositório público.

Sim, erros acontecem. Mas, pela minha experiência, a geração atual de modelos já produz resultados bastante consistentes, e dedico muito trabalho à qualidade dos cartões prontos.

O áudio é hoje a parte mais confiável e se aproxima da fala natural. Os modelos são menos precisos na dificuldade das frases: seguem o nível escolhido como referência, mas às vezes geram uma frase mais fácil ou mais difícil.

A maior parte dos erros aparece nas ilustrações: a IA ainda pode desenhar uma pessoa com um terceiro braço. Por isso o aplicativo usa outros modelos de IA para avaliar as imagens prontas. Se uma imagem não passar na verificação, o programa a gera novamente.

A verificação automática não garante que todo o material esteja correto. Se uma frase gerar dúvida, é melhor conferir com um dicionário ou professor e criar o cartão de novo, se necessário.

Um agente de IA, como o Claude Code, pode usar o kamishibai. Você descreve a tarefa, e o agente a executa pelos comandos do programa. Por exemplo, pode pedir que ele:

• Selecione palavras sobre um tema ou a partir do seu texto.
• Escolha os significados necessários e crie os cartões.
• Confira o resultado e refaça os cartões que não ficaram bons antes de importar no Anki.

Para isso existe a JSON CLI, uma interface de comandos que retorna dados em JSON e não exige responder a perguntas no terminal. O agente pode iniciar a geração em segundo plano e trabalhar com várias sessões ao mesmo tempo.

Passe ao agente o link para llms.txt. O arquivo explica como instalar ou atualizar o kamishibai e acessar as instruções integradas da versão instalada. O uso do próprio agente e as gerações adicionais de cartões podem aumentar os gastos.

Quando você quer manter uma redação já pronta, como frases de uma aula ou diálogos curtos. Em vez de uma lista de palavras, você fornece o conteúdo dos cartões em um arquivo cards JSON, um arquivo de texto com uma estrutura definida.

O arquivo precisa conter todos os campos obrigatórios do cartão, não apenas a frase. Você pode prepará-lo por conta própria ou pedir a um agente de IA. A redação do arquivo é preservada, sem reescrita. O Kamishibai acrescenta áudio e ilustrações, depois monta um baralho Anki em formato APKG e um PDF para impressão.

Estrutura, campos obrigatórios e exemplos em cards-json.md →

Sim. O Kamishibai cria os cartões no computador, e você pode revisá-los no aplicativo móvel do Anki.

• Abra o arquivo .apkg no Anki do computador. Se o clique duplo não iniciar a importação, escolha Arquivo → Importar.
• Sincronize a coleção pelo AnkiWeb.
• Entre na mesma conta no aplicativo móvel e inicie a sincronização para baixar cartões, imagens e áudio.

Para estudar sem tela, você pode imprimir o PDF, recortar e dobrar os cartões. No papel, não há áudio nem agendamento automático das revisões.

O texto, o áudio e as ilustrações são gerados por modelos da família Gemini. O Kamishibai fornece as instruções, verifica parte do resultado e reúne o material nos cartões.

O áudio é sintetizado por um modelo, não gravado por um locutor. Confira o áudio e o restante do conteúdo antes de começar a estudar.

Se você não lembrar o sentido da frase ou a palavra-chave, toque em “De novo”. O Anki vai trazer o cartão de volta mais cedo. Isso vale tanto para um cartão novo quanto para um que você sabia há meses.

O rigor da avaliação depende do que você está praticando. No começo, aceito um pequeno erro de artigo ou preposição se lembro o sentido e as palavras-chave. Quando as frases ficam familiares, começo a exigir de mim mesmo precisão também nesses detalhes.

Se um cartão sempre causa dificuldade, confira a própria frase: a situação está clara? Há elementos desconhecidos demais? Às vezes é mais útil simplificar ou trocar o exemplo do que tentar memorizá-lo novamente do mesmo jeito.

Não há um prazo exato. O resultado depende do nível inicial, das frases escolhidas, da regularidade das revisões e do uso do idioma fora do Anki.

As primeiras 50 frases bem aprendidas podem servir como momento de avaliação: ficou mais fácil lembrar as expressões conhecidas? Você as reconhece em textos novos? Consegue usá-las em uma conversa? Não é um número a partir do qual surge necessariamente uma “intuição para o idioma”. Observe o que passou a conseguir fazer, não apenas o contador de cartões.