Domande prima dell’installazione

A chi vuole imparare una lingua partendo dal proprio materiale ed è disposto a riprenderlo per mesi o anni. Scegli le parole da libri, sottotitoli, lezioni o conversazioni, e kamishibai le trasforma in carte. Il programma non sostituisce un corso: non sceglie per te gli argomenti né l’ordine in cui studiarli.

Dei ripassi si occupa Anki. Il suo calendario si basa sulla ripetizione dilazionata: le carte che ricordi tornano a intervalli sempre più lunghi, quelle dimenticate tornano prima. Il numero di nuove carte e i limiti giornalieri si impostano in Anki.

Credo che, grazie alla nuova generazione di agenti di IA, possiamo creare software con un’impronta personale con la stessa facilità con cui un tempo scrivevamo blog: condividere la nostra esperienza attraverso approcci che altri possono mettere facilmente in pratica. Kamishibai è il mio modo di mettere alla prova questa idea. È prima di tutto uno strumento che uso io stesso ogni giorno e che sviluppo a partire da questa pratica.

Un mangaka unisce personalmente storia, disegno e personalità dei personaggi in un’opera coerente. Mi riconosco in questo approccio d’autore. Da qui nasce anche il linguaggio visivo di kamishibai: mi piace che un progetto abbia un proprio punto di vista, riconoscibile sia nell’idea che nell’aspetto.

Nella modalità principale, un elenco di parole o espressioni che vuoi imparare. Non devi per forza riportarle alla forma del dizionario: kamishibai prova a riconoscere ciò che inserisci e propone dei significati tra cui scegliere. Per ogni significato scelto crea una carta distinta con una frase.

Se la frase non va bene, puoi descrivere cosa cambiare e avviare una nuova generazione. Se invece hai già i testi delle carte, puoi fornirli in formato cards JSON. Più sotto trovi una risposta dedicata a questa possibilità.

Kamishibai prepara il materiale: crea frasi, spiegazioni, audio e illustrazioni, poi li raccoglie in un file .apkg, un mazzo che puoi aprire in Anki.

Anki organizza i ripassi: mostra le carte, salva le tue valutazioni e stabilisce la data del prossimo ripasso.

Kamishibai crea anche un PDF con le carte da stampare. Puoi ritagliarle e studiare senza schermo.

No. Dopo l’installazione avvii kamishibai nel terminale, una finestra con un’interfaccia testuale. Da lì il programma ti guida: aggiungere parole, scegliere i significati, controllare le carte e ottenere il mazzo. Non serve scrivere codice.

Per automatizzare il lavoro ci sono comandi appositi che restituiscono risposte in JSON. Possono usarli script e agenti di IA, ma non ti servono per l’uso normale.

Tu scegli le parole e i significati, e i modelli di IA creano il materiale seguendo le regole di kamishibai. Queste definiscono la struttura della carta e i requisiti per la frase, la spiegazione, l’audio e l’illustrazione.

Prima della generazione puoi scegliere difficoltà e tipo di frase: affermazioni, domande, dialoghi o un misto. Puoi poi controllare il risultato e farlo generare di nuovo indicando le modifiche che desideri.

Sono supportate 22 lingue: inglese, cinese, spagnolo, giapponese, francese, tedesco, coreano, russo, italiano, portoghese, hindi, arabo, turco, polacco, ucraino, indonesiano, vietnamita, thailandese, greco, ebraico, neerlandese e ceco.

Ogni mazzo usa una coppia: la lingua che studi e quella delle traduzioni e delle spiegazioni. Puoi abbinare due lingue qualsiasi dell’elenco. La qualità del materiale dipende da quanto bene i modelli lavorano con la coppia scelta.

Se ti serve un’altra lingua, apri una richiesta su GitHub e vedremo cosa si può fare.

Per creare le carte ti servono:

• Un computer con macOS, Linux o Windows.
• Una connessione a Internet: testo, audio e illustrazioni vengono creati tramite l’API Gemini.
• Una tua chiave API Gemini. Crea una chiave in Google AI Studio →

Per ripassare, installa Anki →

Se la lingua scelta richiede un controllo locale del testo nelle immagini, alla prima creazione di illustrazioni il programma scaricherà anche i modelli di riconoscimento del testo (OCR).

Ci sono versioni pronte da installare per macOS, Linux e Windows.

• macOS e Linux: installazione tramite Homebrew o lo script di installazione.
• Windows: lo script di installazione si esegue con Git Bash, MSYS o Cygwin.

Trovi i comandi e il link allo script nella sezione dedicata all’installazione.

Kamishibai è gratuito e il suo codice sorgente è aperto. Le richieste a Gemini effettuate con la tua chiave API si pagano a parte.

Come riferimento, considera circa 15 dollari per 100 carte con testo, audio e illustrazioni. È una stima: il totale dipende dalla quantità di materiale, dalle rigenerazioni e dalle tariffe dei modelli. I modelli sono già scelti nel programma, quindi non devi configurarli per iniziare.

Con quattro nuove carte al giorno, un mazzo di cento carte dura 25 giorni. Le frasi già imparate vanno ripassate anche dopo. Per questo scelgo parole che voglio davvero usare e do più peso alla qualità delle carte che al costo minimo di generazione.

Il tuo lavoro viene salvato sul computer: impostazioni, sessioni, cache e file pronti. Kamishibai non ha un proprio server per creare le carte.

Per generare e controllare il materiale, il programma invia a Gemini le parole, le frasi e le illustrazioni da valutare, usando la tua chiave API. Se sincronizzi con Anki, anche il mazzo pronto e i file multimediali vengono inviati ad AnkiWeb.

La chiave salvata si trova in un file locale delle impostazioni, non nel gestore di password del sistema. Non condividere questo file con altre persone e non aggiungerlo a un repository pubblico.

Sì, gli errori capitano. Ma nella mia esperienza l’attuale generazione di modelli dà già risultati abbastanza costanti, e dedico molto lavoro alla qualità delle carte prodotte.

L’audio è al momento la parte più affidabile e si avvicina al parlato naturale. I modelli sono meno precisi sulla difficoltà delle frasi: si orientano sul livello scelto, ma a volte producono una frase più semplice o più difficile.

La maggior parte degli errori riguarda le illustrazioni: l’IA può ancora disegnare una persona con un terzo braccio. Per questo il programma usa altri modelli di IA per valutare le immagini create. Se un’immagine non supera il controllo, viene generata di nuovo.

Il controllo automatico non garantisce la correttezza di tutto il materiale. Se una frase ti lascia dubbi, è meglio verificarla con un dizionario o un insegnante e, se necessario, creare di nuovo la carta.

Un agente di IA, come Claude Code, può usare kamishibai. Tu descrivi il compito e l’agente lo svolge attraverso i comandi del programma. Per esempio, puoi chiedergli di:

• Scegliere parole su un argomento o dal tuo testo.
• Selezionare i significati utili e creare le carte.
• Controllare il risultato e rifare le carte non riuscite prima dell’importazione in Anki.

A questo serve la JSON CLI: comandi che restituiscono dati in formato JSON e non richiedono un dialogo nel terminale. L’agente può avviare la generazione in background e gestire più sessioni contemporaneamente.

Passa all’agente il link a llms.txt. Spiega come installare o aggiornare kamishibai e accedere alle istruzioni integrate per la versione installata. L’uso dell’agente e le generazioni aggiuntive di carte possono aumentare i costi.

Quando vuoi conservare formulazioni già pronte, per esempio frasi di una lezione o brevi dialoghi. Al posto di un elenco di parole, fornisci il contenuto delle carte in un file cards JSON, un file di testo con una struttura definita.

Il file deve contenere tutti i campi obbligatori della carta, non solo la frase. Puoi prepararlo tu o affidarlo a un agente di IA. Le formulazioni del file vengono mantenute senza riscriverle. Kamishibai aggiunge audio e illustrazioni, poi crea un mazzo Anki in formato APKG e un PDF da stampare.

Schema, campi obbligatori ed esempi in cards-json.md →

Sì. Kamishibai crea le carte sul computer e puoi ripassarle nell’app mobile di Anki.

• Apri il file .apkg in Anki sul computer. Se il doppio clic non avvia l’importazione, scegli File → Importa.
• Sincronizza la collezione tramite AnkiWeb.
• Accedi con lo stesso account nell’app mobile e avvia la sincronizzazione per scaricare carte, immagini e audio.

Per studiare senza schermo puoi stampare il PDF, ritagliare e piegare le carte. Su carta non avrai l’audio né un calendario automatico dei ripassi.

Testo, audio e illustrazioni sono generati da modelli della famiglia Gemini. Kamishibai dà loro le istruzioni, controlla parte del risultato e raccoglie il materiale nelle carte.

L’audio è sintetizzato da un modello, non registrato da uno speaker. Va controllato insieme al resto del contenuto prima di iniziare a studiare.

Se non ricordi il senso della frase o la parola chiave, premi «Ripeti». Anki ti mostrerà di nuovo la carta prima. Vale sia per una carta nuova sia per una che conoscevi da mesi.

Quanto essere severi dipende da ciò che stai esercitando. All’inizio ammetto un piccolo errore di articolo o preposizione se ricordo il senso e le parole chiave. Quando le frasi diventano familiari, comincio a esigere da me stesso precisione anche in questi dettagli.

Se una carta continua a metterti in difficoltà, controlla la frase: la situazione è chiara? Ci sono troppi elementi sconosciuti? A volte è più utile semplificare o sostituire l’esempio che tentare ancora di memorizzarlo così com’è.

Non c’è un termine preciso. Il risultato dipende dal livello iniziale, dalle frasi scelte, dalla regolarità dei ripassi e dall’uso della lingua fuori da Anki.

Le prime 50 frasi ben imparate possono essere un’occasione per fare il punto: ricordi più facilmente le espressioni note? Le riconosci in testi nuovi? Riesci a usarle in conversazione? Non è una soglia oltre la quale compare necessariamente il «senso della lingua». Guarda cosa riesci a fare meglio, non solo il contatore delle carte.