Vragen vóór de installatie

Voor wie een taal wil leren met zelfgekozen materiaal en daar maanden of jaren mee wil blijven oefenen. Je kiest woorden uit boeken, ondertitels, lessen of gesprekken, en kamishibai maakt er kaarten mee. Het programma vervangt geen taalcursus: het kiest niet voor jou welke onderwerpen je bestudeert en in welke volgorde.

Anki regelt de herhalingen. Het schema is gebaseerd op gespreide herhaling: kaarten die je kent, komen met steeds langere tussenpozen terug, en vergeten kaarten eerder. Het aantal nieuwe kaarten en de dagelijkse limieten stel je in Anki in.

Ik geloof dat we dankzij de nieuwe generatie AI-agenten software met een eigen karakter kunnen maken met hetzelfde gemak waarmee we vroeger blogs schreven: onze ervaring delen via benaderingen die anderen gemakkelijk kunnen toepassen. Met Kamishibai wil ik dat idee uitproberen. Het is in de eerste plaats een hulpmiddel dat ik zelf elke dag gebruik en verder ontwikkel op basis van die praktijk.

Een mangaka verbindt zelf het verhaal, de tekeningen en de persoonlijkheid van de personages tot één samenhangend werk. Die persoonlijke manier van maken spreekt me aan. Daar komt ook de beeldtaal van kamishibai vandaan: ik hou ervan als een project een eigen visie heeft, die zowel in het concept als in de vormgeving zichtbaar is.

In de hoofdmodus een lijst woorden of uitdrukkingen die je wilt leren. Je hoeft ze niet eerst naar de woordenboekvorm om te zetten: kamishibai probeert je invoer te herkennen en stelt betekenissen voor waaruit je kunt kiezen. Voor elke gekozen betekenis maakt het een aparte kaart met een zin.

Past een zin niet, dan kun je beschrijven wat je wilt veranderen en de zin opnieuw laten maken. Heb je al teksten voor je kaarten, dan kun je die aanleveren in het formaat cards JSON. Daarover staat verderop een apart antwoord.

Kamishibai bereidt het materiaal voor: het maakt zinnen, uitleg, audio en illustraties en bundelt ze in een .apkg-bestand, een stapel kaarten die je in Anki kunt openen.

Anki organiseert de herhalingen: het toont kaarten, bewaart je beoordelingen en plant de volgende herhaling.

Kamishibai maakt ook een PDF voor papieren kaarten. Je kunt die afdrukken en de kaarten uitknippen als je zonder scherm wilt leren.

Nee. Na de installatie start je kamishibai in de terminal, een venster met een tekstinterface. Daarna leidt het programma je door de stappen: woorden toevoegen, betekenissen kiezen, kaarten controleren en de stapel krijgen. Daar hoef je geen code voor te schrijven.

Voor automatisering zijn er aparte opdrachten die antwoorden in JSON teruggeven. Scripts en AI-agenten kunnen ze gebruiken, maar bij normaal gebruik heb je ze niet nodig.

Jij kiest de woorden en betekenissen. AI-modellen maken het materiaal volgens de regels die in kamishibai zijn vastgelegd. Die bepalen de opbouw van de kaart en de eisen aan de zin, de uitleg, de audio en de illustratie.

Voordat je de kaarten laat maken, kun je de moeilijkheid en het soort zinnen kiezen: mededelingen, vragen, dialogen of een mix. Daarna kun je het resultaat controleren en met jouw aanwijzingen opnieuw laten maken.

Er worden 22 talen ondersteund: Engels, Chinees, Spaans, Japans, Frans, Duits, Koreaans, Russisch, Italiaans, Portugees, Hindi, Arabisch, Turks, Pools, Oekraïens, Indonesisch, Vietnamees, Thais, Grieks, Hebreeuws, Nederlands en Tsjechisch.

Voor elke stapel kies je één talenpaar: de taal die je leert en de taal voor vertalingen en uitleg. Je kunt elke combinatie van twee talen uit de lijst gebruiken. De kwaliteit van het materiaal hangt af van hoe goed de modellen met dat talenpaar omgaan.

Heb je een andere taal nodig, dien dan een verzoek in op GitHub. Dan kijken we wat mogelijk is.

Om kaarten te maken heb je het volgende nodig:

• Een computer met macOS, Linux of Windows.
• Een internetverbinding: tekst, audio en illustraties worden via de Gemini API gemaakt.
• Je eigen Gemini-API-sleutel. Een sleutel aanmaken in Google AI Studio →

Installeer voor het herhalen Anki →

Als de gekozen taal een lokale controle op tekst in afbeeldingen vereist, downloadt het programma bij de eerste illustraties ook modellen voor tekstherkenning (OCR).

Er zijn kant-en-klare versies voor macOS, Linux en Windows.

• macOS en Linux: installeren via Homebrew of het installatiescript.
• Windows: het installatiescript draait in Git Bash, MSYS of Cygwin.

De opdrachten en de link naar het script vind je bij de installatie-instructies.

Kamishibai is gratis en de broncode is openbaar. Je betaalt apart voor de aanvragen aan Gemini via je eigen API-sleutel.

Reken als richtlijn op ongeveer 15 dollar voor 100 kaarten met tekst, audio en illustraties. Dat is een schatting: het totaal hangt af van de hoeveelheid materiaal, nieuwe pogingen en de tarieven van de modellen. De modellen zijn al in het programma gekozen. Je hoeft ze niet in te stellen om te beginnen.

Met vier nieuwe kaarten per dag heb je aan een stapel van honderd kaarten genoeg voor 25 dagen. De geleerde zinnen blijf je daarna herhalen. Daarom kies ik woorden die ik echt wil gebruiken en vind ik de kwaliteit van de kaarten belangrijker dan zo laag mogelijke kosten voor het maken ervan.

Je werk wordt op je computer opgeslagen: instellingen, sessies, cache en voltooide bestanden. Kamishibai heeft geen eigen server voor het maken van kaarten.

Om het materiaal te maken en te controleren, stuurt het programma woorden, zinnen en de te beoordelen illustraties naar Gemini met je API-sleutel. Als je via Anki synchroniseert, worden de voltooide stapel en de mediabestanden ook naar AnkiWeb verstuurd.

Een opgeslagen sleutel staat in een lokaal instellingenbestand, niet in de wachtwoordopslag van je besturingssysteem. Deel dat bestand niet met anderen en zet het niet in een openbare repository.

Ja, fouten komen voor. Maar in mijn ervaring levert de huidige generatie modellen al vrij consistente resultaten op, en ik besteed veel aandacht aan de kwaliteit van de uiteindelijke kaarten.

De audio is op dit moment het betrouwbaarst en klinkt bijna als natuurlijke spraak. Bij de moeilijkheid van zinnen zijn de modellen minder nauwkeurig: ze houden rekening met het gekozen niveau, maar maken soms een zin die eenvoudiger of moeilijker is.

De meeste fouten zitten in de illustraties: AI kan iemand nog steeds een derde arm geven. Daarom gebruikt het programma aparte AI-modellen om de gemaakte afbeeldingen te beoordelen. Komt een afbeelding niet door de controle, dan maakt het programma een nieuwe.

De automatische controle garandeert niet dat al het materiaal klopt. Bij twijfel over een zin kun je beter een woordenboek of docent raadplegen en de kaart zo nodig opnieuw laten maken.

Een AI-agent, zoals Claude Code, kan kamishibai gebruiken. Jij beschrijft de taak en de agent voert die uit via de opdrachten van het programma. Je kunt hem bijvoorbeeld vragen om:

• Woorden te kiezen over een onderwerp of uit jouw tekst.
• De juiste betekenissen te kiezen en kaarten te maken.
• Het resultaat te controleren en minder geslaagde kaarten opnieuw te maken voordat ze in Anki worden geïmporteerd.

Daarvoor is er een JSON CLI: opdrachten die gegevens in JSON teruggeven en geen vraag-en-antwoordgesprek in de terminal vereisen. De agent kan kaarten op de achtergrond laten maken en meerdere sessies tegelijk beheren.

Geef de agent de link naar llms.txt. Daar staat hoe je kamishibai installeert of bijwerkt en de ingebouwde instructies voor de geïnstalleerde versie opvraagt. Het gebruik van de agent zelf en extra pogingen om kaarten te maken kunnen de kosten verhogen.

Als je bestaande formuleringen wilt behouden, bijvoorbeeld zinnen uit een les of korte dialogen. In plaats van een woordenlijst lever je de kaartinhoud aan in een cards-JSON-bestand, een tekstbestand met een vaste structuur.

Het bestand moet alle verplichte kaartvelden bevatten, niet alleen de zin. Je kunt het zelf maken of een AI-agent inschakelen. De formuleringen uit het bestand worden zonder herschrijven overgenomen. Kamishibai voegt audio en illustraties toe en maakt daarna een Anki-stapel in APKG-formaat en een PDF om af te drukken.

Schema, verplichte velden en voorbeelden in cards-json.md →

Ja. Kamishibai maakt de kaarten op je computer en je kunt ze herhalen in de mobiele Anki-app.

• Open het voltooide .apkg-bestand in Anki op de computer. Start dubbelklikken de import niet, kies dan Bestand → Importeren.
• Synchroniseer je collectie via AnkiWeb.
• Meld je in de mobiele app aan met hetzelfde account en start de synchronisatie om de kaarten, afbeeldingen en audio te downloaden.

Om zonder scherm te leren kun je de PDF afdrukken en de kaarten uitknippen en vouwen. Op papier heb je geen audio en geen automatisch herhaalschema.

De tekst, audio en illustraties worden gemaakt door modellen uit de Gemini-familie. Kamishibai geeft de instructies, controleert een deel van het resultaat en voegt het materiaal samen tot kaarten.

De audio wordt door een model gegenereerd en niet door een stemacteur ingesproken. Controleer die samen met de rest van de inhoud voordat je gaat leren.

Weet je de betekenis van de zin of het sleutelwoord niet meer, druk dan op ‘Opnieuw’. Anki laat de kaart eerder terugkomen. Dat geldt voor een nieuwe kaart én voor een kaart die je al maanden kende.

Hoe streng je beoordeelt, hangt af van wat je oefent. In het begin accepteer ik een kleine fout in een lidwoord of voorzetsel als ik de betekenis en de belangrijkste woorden nog weet. Zodra de zinnen vertrouwd worden, verwacht ik van mezelf ook op die details meer nauwkeurigheid.

Blijft een kaart lastig, bekijk dan de zin zelf: is de situatie duidelijk en bevat de zin niet te veel onbekends? Soms helpt het meer om het voorbeeld te vereenvoudigen of te vervangen dan het nogmaals in dezelfde vorm uit je hoofd te proberen te leren.

Daar staat geen vaste termijn voor. Het resultaat hangt af van je beginniveau, de gekozen zinnen, hoe regelmatig je herhaalt en of je de taal ook buiten Anki gebruikt.

Na de eerste 50 goed geleerde zinnen kun je de balans opmaken: herinner je je bekende uitdrukkingen makkelijker, herken je ze in nieuwe teksten en lukt het om ze in een gesprek te gebruiken? Dat aantal is geen grens waarna vanzelf ‘taalgevoel’ ontstaat. Kijk naar wat je beter afgaat, niet alleen naar het aantal kaarten.