Les questions qui peuvent se poser avant l'installation
À qui s'adresse kamishibai ?
À qui est prêt à pratiquer la répétition espacée régulièrement et longtemps — des mois, pas deux ou trois soirées. kamishibai n'est pas un cours. Il ne choisit pas de thèmes et ne suit aucun programme : tu apportes les mots croisés par hasard dans un livre, des sous-titres ou une conversation, et kamishibai les transforme en cartes.
Ensuite, c'est Anki qui travaille : elle décide seule combien de cartes montrer aujourd'hui et empêche la session quotidienne de gonfler. Les intervalles entre révisions s'allongent peu à peu — de quelques jours à des semaines et des mois.
Que peut-on lui donner en entrée ?
La voie principale, c'est une liste de mots : tu choisis les sens qu'il te faut, et kamishibai écrit une phrase nouvelle pour chacun. Si le contenu des cartes est déjà prêt, passe-le au format cards JSON : les champs peuvent contenir n'importe quoi tant que le schéma est respecté — l'audio et les images, kamishibai les ajoute lui-même.
Que fait Anki, et que fait kamishibai ?
kamishibai prépare les cartes et les assemble en un fichier .apkg — le format d'import d'Anki. Anki planifie les révisions et conserve les notes de tes réponses. S'il te faut des cartes physiques, kamishibai crée aussi un PDF : tu peux l'imprimer et le découper.
Faut-il savoir programmer ?
Non. Le mode principal est une TUI pas à pas dans le terminal : tu colles des mots, tu choisis des sens, tu vérifies des cartes et tu reçois ton paquet. La CLI JSON ne sert qu'aux scripts et aux agents externes.
Qui décide de ce qui figure sur une carte ?
Toi. Dans le terminal, tu travailles avec tes propres mots : tu choisis les sens et tu décides quelles cartes garder. Ce même travail peut être confié à un agent, mais la vérification du résultat te revient toujours.
Quelles langues sont prises en charge ?
EN, ZH, ES, JA, FR, DE, RU, IT, PT, EL et NL — dans n'importe quelle paire. Une exécution travaille avec une seule paire. Les modèles ne maîtrisent pas toutes les combinaisons aussi bien. S'il te faut une autre langue, ouvre une issue sur GitHub — on verra ce qu'on peut faire.
Que faut-il avant de se lancer ?
Un ordinateur, Internet pendant la génération et ta propre clé de l'API Gemini — tu peux la créer dans Google AI Studio → Pour les révisions, il faut Anki → À la première génération d'illustrations, kamishibai téléchargera en plus ses modèles d'OCR.
Sur quels systèmes ça tourne ?
Des binaires prêts à l'emploi existent pour macOS, Linux et Windows. Homebrew fonctionne sur macOS et Linux. L'installateur shell se lance aussi dans Git Bash, MSYS ou Cygwin sous Windows.
Combien ça coûte ?
kamishibai lui-même est gratuit et ouvert, mais les requêtes vers Gemini sont facturées sur ta clé. Générer 100 cartes revient à environ $15. C'est une estimation grossière : le total dépend du nombre de cartes à régénérer. Pas besoin de choisir les modèles, ils sont déjà configurés : je tâche de garder des modèles récents mais relativement abordables, et je place la qualité des cartes au-dessus de la dépense minimale de tokens.
Cent cartes, ce sont 100 phrases complètes et plusieurs centaines de mots en contexte — de quoi étudier un mois ou deux, d'ordinaire. Mieux vaut donc réserver kamishibai aux mots qu'il t'importe vraiment de retenir.
Où partent les mots et la clé ?
Les sessions, le cache et les fichiers finis restent sur ton disque. kamishibai n'a pas de serveur à lui. La génération passe par Gemini avec ta clé, donc les mots et les phrases quittent bien l'ordinateur. La clé enregistrée se trouve dans un fichier de configuration local, pas dans le trousseau du système.
Le matériel généré peut-il être fautif ?
Oui. Le modèle peut choisir la mauvaise nuance de sens, se tromper dans l'API phonétique, et l'audio peut sonner faux. La qualité et le style des illustrations, kamishibai les vérifie lui-même et retente les ratées — jusqu'à trois nouvelles tentatives sont prévues, d'où parfois un surplus de tokens. Dans de rares cas, un mot peut épuiser toutes les tentatives et rester sans carte. Vérifie le paquet avant de commencer à réviser.
Que veut dire exactement Agent Ready ?
Cela veut dire que l'outil peut servir non seulement à un humain, mais aussi à un agent comme Claude Code. Les commandes de la CLI JSON — new, select ou exclude, generate, status, result — n'exigent aucune saisie interactive et renvoient une réponse lisible par machine : un agent peut donc les appeler de façon asynchrone et mener plusieurs sessions en parallèle. L'usage des commandes est décrit dans llms.txt — il suffit de montrer ce fichier à l'agent.
On peut confier à un agent :
- composer une liste de mots pour une tâche précise,
- choisir les sens,
- vérifier les cartes finies avant l'import.
C'est pratique pour les gros volumes, mais les vérifications et régénérations superflues augmentent la dépense de tokens et le coût.
À quoi sert son propre JSON ?
Ton propre cards JSON est utile quand les formulations doivent être entièrement à toi : des phrases toutes prêtes, des mini-dialogues, des tournures d'un cours. Passe le contenu — kamishibai ajoutera l'audio et les illustrations, puis assemblera l'APKG et le PDF. Le schéma strict est dans cards-json.md →
Peut-on réviser sur le téléphone ?
La génération se lance sur un ordinateur. Ensuite, un double-clic sur le fichier .apkg suffit d'ordinaire : Anki s'ouvre et démarre l'import (sinon, choisis Fichier → Importer). La synchronisation du paquet avec le téléphone, c'est Anki qui s'en charge.
Le PDF n'a pas de calendrier, mais il donne de vraies cartes en papier : imprime, découpe, plie. Les phrases les plus importantes ou les plus coriaces peuvent rester sur le bureau — sans le son, il est vrai.
Qui crée le texte, l'audio et les illustrations ?
Le texte, l'audio et les illustrations sont générés par des modèles de la famille Gemini.
Que faire si une carte ne revient vraiment pas ?
Appuie sur « À revoir » et continue. Ajuste la sévérité de la note à ton niveau. Au début, tu peux accepter une réponse avec une erreur d'article ou de préposition, si tu te souviens du sens de la phrase et des mots clés. Quand les 50 premières phrases seront bien acquises, relève tes exigences.
Si, des mois plus tard, une carte familière t'échappe soudain, appuie sur « À revoir » : c'est souvent juste après une telle erreur que la phrase se grave pour de bon.
Quand attendre un résultat ?
Après les 50 premières phrases bien apprises, l'effet se remarque déjà : les constructions familières reviennent plus facilement, et peu à peu le sens de la langue apparaît — au moins dans le domaine d'où elles sont venues.