Preguntas que pueden surgir antes de instalar
¿Para quién es kamishibai?
Para quien esté dispuesto a practicar la repetición espaciada con regularidad y durante mucho tiempo: meses, no un par de tardes. kamishibai no es un curso. No elige temas ni te lleva por un programa: tú traes las palabras que te encontraste por casualidad en un libro, en subtítulos o en una conversación, y kamishibai las convierte en tarjetas.
A partir de ahí trabaja Anki: decide por sí sola cuántas tarjetas mostrarte hoy y no deja que la sesión diaria se desborde. Los intervalos entre repasos crecen poco a poco, de un par de días a semanas y meses.
¿Qué se le puede dar de entrada?
La vía principal es una lista de palabras: eliges los significados que necesitas y kamishibai escribe una frase nueva para cada uno. Si el contenido de las tarjetas ya está listo, pásalo en formato cards JSON: dentro de los campos puede ir cualquier cosa mientras cuadre el esquema; el audio y las imágenes los añade kamishibai por su cuenta.
¿Qué hace Anki y qué hace kamishibai?
kamishibai prepara las tarjetas y las reúne en un archivo .apkg, el formato de importación de Anki. Anki planifica los repasos y guarda las calificaciones de tus respuestas. Si quieres tarjetas físicas, kamishibai también crea un PDF: puedes imprimirlo y recortarlo.
¿Hace falta saber programar?
No. El modo principal es una TUI paso a paso en el terminal: pegas palabras, eliges significados, revisas tarjetas y recibes el mazo. La CLI de JSON solo la necesitan los scripts y los agentes externos.
¿Quién decide qué acaba en la tarjeta?
Tú. En el terminal trabajas con tus propias palabras: eliges los significados y decides qué tarjetas conservar. Ese mismo trabajo se puede delegar a un agente, pero revisar el resultado sigue siendo cosa tuya.
¿Qué idiomas se admiten?
EN, ZH, ES, JA, FR, DE, RU, IT, PT, EL y NL, en cualquier par. Cada ejecución trabaja con un solo par. No todas las combinaciones las dominan los modelos por igual. Si necesitas otro idioma, abre un issue en GitHub y vemos qué se puede hacer.
¿Qué hará falta antes de arrancar?
Un ordenador, internet durante la generación y tu propia clave de la API de Gemini — puedes crearla en Google AI Studio → Para los repasos hace falta Anki → En la primera generación de ilustraciones kamishibai descargará además los modelos de OCR.
¿En qué sistemas funciona?
Hay compilaciones listas para macOS, Linux y Windows. Homebrew funciona en macOS y Linux. El instalador de shell también puede ejecutarse en Git Bash, MSYS o Cygwin en Windows.
¿Cuánto cuesta?
kamishibai en sí es gratuito y abierto, pero las peticiones a Gemini se facturan a tu clave. Generar 100 tarjetas sale por unos $15. Es una estimación gruesa: el total depende de cuántas tarjetas haya que regenerar. No tienes que elegir modelos, ya vienen configurados: procuro mantener modelos actuales pero relativamente asequibles, y antepongo la calidad de las tarjetas al gasto mínimo de tokens.
Cien tarjetas son 100 frases completas y varios cientos de palabras en contexto, cuyo estudio suele llevar un mes o dos. Por eso conviene reservar kamishibai para las palabras que de verdad te importa recordar.
¿A dónde van las palabras y la clave?
Las sesiones, la caché y los archivos terminados quedan en tu disco. kamishibai no tiene servidor propio. La generación pasa por Gemini con tu clave, así que las palabras y frases sí salen de tu ordenador. La clave guardada está en un archivo local de configuración, no en el almacén de secretos del sistema.
¿El material generado puede contener errores?
Sí. El modelo puede elegir un matiz equivocado del significado o fallar en el IPA, y el audio puede sonar mal. La calidad y el estilo de las ilustraciones los comprueba el propio kamishibai y reintenta las fallidas: lleva previstos hasta tres reintentos, por lo que a veces se gastan más tokens. En casos raros una palabra puede agotar todos los intentos y quedarse sin tarjeta. Revisa el mazo antes de empezar a repasar.
¿Qué significa exactamente Agent Ready?
Significa que la utilidad puede usarla no solo una persona, sino también un agente como Claude Code. Los comandos de la CLI de JSON — new, select o exclude, generate, status, result — no requieren entrada interactiva y devuelven una respuesta legible por máquina, así que un agente puede invocarlos de forma asíncrona y llevar varias sesiones en paralelo. Cómo usar los comandos está descrito en llms.txt: basta con mostrarle ese archivo al agente.
A un agente se le puede encargar:
- armar una lista de palabras para una tarea concreta,
- elegir los significados,
- revisar las tarjetas terminadas antes de importar.
Resulta cómodo para grandes volúmenes, pero las comprobaciones y regeneraciones de más aumentan el gasto de tokens y el coste.
¿Para qué sirve traer mi propio JSON?
Tu propio cards JSON viene bien cuando las formulaciones deben ser enteramente tuyas: oraciones ya hechas, minidiálogos, frases de una lección. Pasa el contenido y kamishibai añadirá el audio y las ilustraciones, y luego armará el APKG y el PDF. El esquema estricto está en cards-json.md →
¿Se puede repasar en el teléfono?
La generación se lanza en el ordenador. Después suele bastar con hacer doble clic en el archivo .apkg: Anki se abrirá y empezará la importación (si no, elige Archivo → Importar). La sincronización del mazo con el teléfono la hace la propia Anki.
El PDF no lleva calendario, pero de él salen tarjetas de papel: imprime, recorta y dobla. Las frases más importantes o más difíciles pueden quedarse sobre la mesa, aunque sin sonido.
¿Quién crea el texto, el audio y las ilustraciones?
El texto, el audio y las ilustraciones los generan modelos de la familia Gemini.
¿Qué hago si una tarjeta no me sale de ninguna manera?
Pulsa «Otra vez» y sigue adelante. Ajusta la severidad de la calificación a tu nivel. Al principio puedes dar por buena una respuesta con un error en el artículo o la preposición, si recuerdas el sentido de la frase y las palabras clave. Cuando tengas bien aprendidas las primeras 50 frases, sube el listón.
Si al cabo de unos meses de pronto no recuerdas una tarjeta conocida, pulsa «Otra vez»: a menudo es justo tras un fallo así cuando la frase se queda grabada para siempre.
¿Cuándo se puede esperar resultado?
Tras las primeras 50 frases bien aprendidas ya se puede notar el efecto: las construcciones conocidas vuelven con más facilidad y poco a poco aparece la intuición del idioma, al menos en el terreno del que vinieron.