Domande che possono sorgere prima dell'installazione
A chi è adatto kamishibai?
A chi è pronto a praticare la ripetizione dilazionata con regolarità e a lungo — mesi, non un paio di serate. kamishibai non è un corso. Non sceglie argomenti e non ti guida lungo un programma: porti tu le parole incontrate per caso in un libro, nei sottotitoli o in una conversazione, e kamishibai le trasforma in carte.
Da lì in poi lavora Anki: decide da sola quante carte mostrarti oggi e non lascia che la sessione quotidiana si gonfi. Gli intervalli tra i ripassi crescono gradualmente — da un paio di giorni a settimane e mesi.
Cosa si può dare in ingresso?
La via principale è una lista di parole: scegli i significati che ti servono e per ciascuno kamishibai scrive una frase nuova. Se il contenuto delle carte è già pronto, passalo nel formato cards JSON: nei campi può esserci qualsiasi cosa, purché torni lo schema — audio e immagini li aggiunge kamishibai da solo.
Cosa fa Anki e cosa fa kamishibai?
kamishibai prepara le carte e le raccoglie in un file .apkg — il formato di import di Anki. Anki pianifica i ripassi e conserva i voti delle risposte. Se servono carte fisiche, kamishibai crea anche un PDF: si può stampare e ritagliare.
Serve saper programmare?
No. La modalità principale è una TUI passo dopo passo nel terminale: incolli le parole, scegli i significati, controlli le carte e ricevi il mazzo. La CLI JSON serve solo a script e agenti esterni.
Chi decide cosa finisce sulla carta?
Tu. Nel terminale lavori con le tue parole: scegli i significati e decidi quali carte tenere. Lo stesso lavoro si può affidare a un agente, ma il controllo del risultato resta comunque a te.
Quali lingue sono supportate?
EN, ZH, ES, JA, FR, DE, RU, IT, PT, EL e NL — in qualsiasi coppia. Un'esecuzione lavora con una coppia sola. Non tutte le combinazioni i modelli le conoscono ugualmente bene. Se ti serve un'altra lingua, apri una issue su GitHub — vediamo cosa si può fare.
Cosa serve prima di partire?
Un computer, internet durante la generazione e una tua chiave dell'API Gemini — puoi crearla in Google AI Studio → Per i ripassi serve Anki → Alla prima generazione di illustrazioni kamishibai scaricherà anche i modelli OCR.
Su quali sistemi funziona?
Ci sono build pronte per macOS, Linux e Windows. Homebrew funziona su macOS e Linux. L'installer shell si può lanciare anche in Git Bash, MSYS o Cygwin su Windows.
Quanto costa?
kamishibai in sé è gratuito e open source, ma le richieste a Gemini si pagano con la tua chiave. Generare 100 carte costa circa $15. È una stima grossolana: il totale dipende da quante carte andranno rigenerate. I modelli non devi sceglierli, sono già configurati: cerco di tenerli aggiornati ma relativamente economici, e metto la qualità delle carte sopra il minimo consumo di token.
Cento carte sono 100 frasi complete e diverse centinaia di parole in contesto, che di solito richiedono uno o due mesi di studio. Perciò kamishibai conviene usarlo per le parole che davvero ti importa ricordare.
Dove vanno le parole e la chiave?
Sessioni, cache e file pronti stanno sul tuo disco. kamishibai non ha un server proprio. La generazione passa per Gemini con la tua chiave, quindi parole e frasi lasciano il computer. La chiave salvata sta in un file locale di impostazioni, non nel portachiavi di sistema.
Il materiale generato può essere sbagliato?
Sì. Il modello può scegliere la sfumatura sbagliata di significato o sbagliare l'IPA, e l'audio può riuscire male. Qualità e stile delle illustrazioni li controlla kamishibai stesso e ritenta quelle riuscite male — sono previsti fino a tre nuovi tentativi, perciò a volte i token spesi sono di più. In rari casi una parola può esaurire tutti i tentativi e restare senza carta. Controlla il mazzo prima di cominciare a ripassare.
Cosa significa esattamente Agent Ready?
Significa che lo strumento può usarlo non solo una persona, ma anche un agente come Claude Code. I comandi della CLI JSON — new, select o exclude, generate, status, result — non richiedono input interattivo e restituiscono una risposta leggibile dalla macchina, quindi un agente può chiamarli in modo asincrono e condurre più sessioni in parallelo. Come usare i comandi è descritto in llms.txt — basta mostrare quel file all'agente.
A un agente si può affidare:
- comporre una lista di parole per un compito preciso,
- scegliere i significati,
- controllare le carte pronte prima dell'import.
È comodo per i grandi volumi, ma controlli e rigenerazioni superflui aumentano il consumo di token e il costo.
A cosa serve un JSON proprio?
Il tuo cards JSON torna utile quando le formulazioni devono essere interamente tue: frasi già pronte, mini-dialoghi, espressioni di una lezione. Passa il contenuto — kamishibai aggiungerà audio e illustrazioni, poi comporrà APKG e PDF. Lo schema rigoroso è in cards-json.md →
Si può ripassare sul telefono?
La generazione parte dal computer. Dopo, di solito basta un doppio clic sul file .apkg: Anki si apre e avvia l'import (altrimenti scegli File → Importa). A sincronizzare il mazzo col telefono ci pensa Anki stessa.
Nel PDF non c'è calendario, ma ne escono carte di carta vere: stampa, ritaglia, piega. Le frasi più importanti o più ostiche possono restare sulla scrivania — senza suono, però.
Chi crea testo, audio e illustrazioni?
Testo, audio e illustrazioni li generano modelli della famiglia Gemini.
Che fare se una carta proprio non torna in mente?
Premi «Ripeti» e vai avanti. La severità del voto regolala sul tuo livello. All'inizio puoi dare per buona una risposta con un errore nell'articolo o nella preposizione, se ricordi il senso della frase e le parole chiave. Quando le prime 50 frasi saranno ben salde, alza l'asticella.
Se dopo qualche mese all'improvviso non ricordi una carta familiare, premi «Ripeti»: spesso è proprio dopo un errore così che la frase si fissa per sempre.
Quando aspettarsi un risultato?
Dopo le prime 50 frasi ben imparate l'effetto si nota già: le costruzioni familiari tornano in mente più facilmente, e a poco a poco compare il senso della lingua — almeno nell'ambito da cui sono venute.