Vragen die kunnen opkomen vóór de installatie
Voor wie is kamishibai?
Voor wie bereid is gespreide herhaling regelmatig en lang vol te houden — op een horizon van maanden of jaren. kamishibai is geen cursus en niet het zoveelste preset met de top-100 woorden. Het kiest geen thema's en leidt je niet door een programma: jij brengt de woorden mee die je toevallig tegenkomt in boeken, ondertitels of gesprekken, en kamishibai maakt er kaarten van.
Daarna is Anki aan zet: het beslist zelf hoeveel kaarten het vandaag toont en laat de dagelijkse sessie niet uitdijen. De intervallen tussen herhalingen groeien geleidelijk — van een paar dagen naar weken en maanden.
Wat kun je invoeren?
Een lijst met woorden of zelfs zinsneden (kamishibai begrijpt vage formuleringen): je kiest de betekenissen die je nodig hebt, als een woord er meerdere heeft, en voor elk maakt kamishibai een zin. Bevalt de zin niet, dan kun je de AI in vrije vorm vragen hem opnieuw te maken. Is de inhoud van de kaarten al klaar, geef die dan door als cards JSON: in de velden mag van alles staan, zolang het schema klopt — de audio en de afbeeldingen voegt kamishibai zelf toe.
Wat doet Anki en wat doet kamishibai?
kamishibai bereidt de kaarten voor en bundelt ze in een .apkg-bestand — het importformaat van Anki. Anki plant de herhalingen en bewaart je antwoordbeoordelingen. Wil je fysieke kaarten, dan maakt kamishibai ook een PDF: printen en knippen.
Moet ik kunnen programmeren?
Nee. De hoofdmodus is een stapsgewijze TUI in de terminal: je plakt woorden, kiest betekenissen, controleert kaarten en krijgt je stapel. De JSON-CLI is er alleen voor scripts en externe agents.
Wie bepaalt wat er op een kaart komt?
De zinnen en de kaartinhoud worden gegenereerd door AI-modellen, maar volgens strikte regels, zodat het leren consistent blijft. De generatieregels kunnen per versie van het gereedschap veranderen.
Welke talen worden ondersteund?
EN, ZH, ES, JA, FR, DE, RU, IT, PT, EL en NL — in elke combinatie. Eén run werkt met één taalpaar. Niet elke combinatie kennen de modellen even goed. Heb je een andere taal nodig, open dan een issue op GitHub — dan kijken we wat er kan.
Wat heb ik nodig voor de eerste run?
Een computer, internet tijdens het genereren en je eigen Gemini-API-sleutel — die maak je aan in Google AI Studio → Voor het herhalen heb je Anki → nodig. Bij de eerste illustratierun downloadt kamishibai zijn OCR-modellen.
Op welke systemen draait het?
Kant-en-klare builds zijn er voor macOS, Linux en Windows. Homebrew werkt op macOS en Linux. De shell-installer draait ook in Git Bash, MSYS of Cygwin op Windows.
Wat kost het?
kamishibai zelf is gratis en open source, maar de Gemini-aanvragen worden via jouw sleutel afgerekend. 100 kaarten genereren komt neer op ongeveer $15. Dat is een ruwe schatting: het totaal hangt af van hoeveel kaarten opnieuw gegenereerd moeten worden. Modellen hoef je niet te kiezen, die staan al ingesteld: ik probeer ze actueel maar betaalbaar te houden, en ik stel de kwaliteit van de kaarten boven minimaal tokenverbruik.
Honderd kaarten betekent 100 volwaardige zinnen en enkele honderden woorden in context — daar doe je doorgaans een maand of twee over. Gebruik kamishibai dus vooral voor woorden die je echt wilt onthouden.
Waar gaan mijn woorden en mijn sleutel heen?
Sessies, cache en afgewerkte bestanden staan op jouw schijf. kamishibai heeft geen eigen server. Het genereren loopt via Gemini met jouw sleutel, dus woorden en zinnen verlaten je computer wél. De opgeslagen sleutel staat in een lokaal instellingenbestand, niet in de systeemsleutelhanger.
Kan het gegenereerde materiaal fouten bevatten?
Ja. Het model kan de verkeerde betekenisnuance kiezen of zich vergissen in de IPA, en de audio kan mislukken. De kwaliteit en stijl van de illustraties controleert kamishibai zelf en mislukte probeert het opnieuw — er zijn tot drie nieuwe pogingen ingebouwd, dus soms kost het meer tokens. In zeldzame gevallen kan een woord alle pogingen opgebruiken en zonder kaart blijven. Controleer de stapel voordat je gaat herhalen.
Wat betekent Agent Ready precies?
Het betekent dat niet alleen een mens het gereedschap kan bedienen, maar ook een agent zoals Claude Code. De JSON-CLI-commando's — new, select of exclude, generate, status, result — vragen geen interactieve invoer en geven machineleesbare output terug, dus een agent kan ze asynchroon aanroepen en meerdere sessies parallel draaien. Hoe je de commando's gebruikt staat in llms.txt — laat de agent gewoon dat bestand zien.
Een agent kun je laten:
- een woordenlijst opstellen voor een concreet doel,
- de betekenissen kiezen,
- de afgewerkte kaarten controleren vóór het importeren.
Dat is handig bij grote volumes, maar extra controles en hergeneraties verhogen het tokenverbruik en de kosten.
Waarom zou ik eigen JSON meebrengen?
Je eigen cards JSON is nuttig wanneer de formuleringen volledig van jou moeten zijn: kant-en-klare zinnen, minidialogen, zinnen uit een les. Geef de inhoud door — kamishibai voegt audio en illustraties toe en bouwt daarna de APKG en PDF. Het strikte schema staat in cards-json.md →
Kan ik herhalen op mijn telefoon?
Het genereren draait op een computer. Daarna is dubbelklikken op het .apkg-bestand meestal genoeg: Anki opent en begint met importeren (zo niet, kies Bestand → Importeren). De stapel met je telefoon synchroniseren doet Anki zelf.
De PDF heeft geen schema, maar levert echte papieren kaarten op: printen, knippen, vouwen. De belangrijkste of lastigste zinnen kunnen op je bureau liggen — zij het zonder geluid.
Wie maakt de tekst, audio en illustraties?
De tekst, audio en illustraties worden gegenereerd door modellen van de Gemini-familie.
Wat als een kaart maar niet terug wil komen?
Druk op "Opnieuw" en ga door. Stem de strengheid van je beoordeling af op je niveau. In het begin mag een antwoord met een fout lidwoord of voorzetsel tellen, zolang je de betekenis van de zin en de sleutelwoorden nog weet. Zitten de eerste 50 zinnen goed, leg de lat dan hoger.
Ontglipt een bekende kaart je maanden later ineens, druk dan op "Opnieuw": juist na zo'n misser blijft een zin vaak voorgoed hangen.
Wanneer mag ik resultaat verwachten?
Na de eerste 50 goed geleerde zinnen kun je het effect al merken: bekende constructies komen makkelijker terug, en gaandeweg ontstaat er taalgevoel — in elk geval in het domein waar die zinnen vandaan komen.