Preguntas antes de instalar

Para quien quiere aprender un idioma con su propio material y está dispuesto a repasarlo durante meses o años. Tú eliges palabras de libros, subtítulos, clases o conversaciones, y kamishibai crea tarjetas con ellas. El programa no sustituye a un curso: no elige por ti los temas ni el orden en que los estudias.

Anki se encarga de los repasos. Su planificación se basa en la repetición espaciada: las tarjetas que recuerdas aparecen a intervalos cada vez mayores, y las que olvidas vuelven antes. El número de tarjetas nuevas y los límites diarios se configuran en Anki.

Creo que, gracias a la nueva generación de agentes de IA, podemos crear software con una voz propia con la misma facilidad con la que antes escribíamos blogs: compartir nuestra experiencia a través de enfoques que otras personas puedan poner en práctica con facilidad. Kamishibai es mi forma de poner a prueba esa idea. Ante todo, es una herramienta que yo mismo uso a diario y desarrollo a partir de esa práctica.

Un mangaka une personalmente la historia, el dibujo y la personalidad de los personajes en una obra coherente. Me siento cercano a esa forma de crear. De ahí viene el lenguaje visual de kamishibai: me gusta que un proyecto tenga una mirada propia, reconocible tanto en su concepto como en su aspecto.

En el modo principal, una lista de palabras o expresiones que quieras aprender. No hace falta buscar su forma de diccionario: kamishibai intenta reconocer lo que introduces y te propone significados para elegir. Por cada significado seleccionado crea una tarjeta independiente con una frase.

Si la frase no encaja, puedes explicar qué quieres cambiar y volver a generarla. Y si ya tienes redactado el contenido de tus tarjetas, puedes entregarlo en formato cards JSON. Hay una respuesta más abajo sobre esta opción.

Kamishibai prepara el material: crea las frases, las explicaciones, el audio y las ilustraciones, y los reúne en un archivo .apkg, un mazo que puedes abrir en Anki.

Anki organiza los repasos: muestra las tarjetas, guarda tus valoraciones y programa la fecha del siguiente repaso.

Kamishibai también crea un PDF para tarjetas de papel. Puedes imprimirlo y recortarlas si prefieres estudiar sin pantalla.

No. Tras instalarlo, ejecutas kamishibai en el terminal, una ventana con una interfaz de texto. A partir de ahí, el programa te guía: añadir palabras, elegir significados, revisar las tarjetas y obtener el mazo. No necesitas escribir código.

Para automatizar el trabajo hay comandos específicos que devuelven respuestas en JSON. Pueden usarlos scripts y agentes de IA, pero no los necesitas para el uso habitual.

Tú eliges las palabras y los significados, y los modelos de IA crean el material siguiendo las reglas de kamishibai. Estas reglas definen la estructura de la tarjeta y los requisitos de la frase, la explicación, el audio y la ilustración.

Antes de generar las tarjetas, puedes elegir la dificultad y el tipo de frases: afirmaciones, preguntas, diálogos o una mezcla. Después puedes revisar el resultado y pedir una nueva versión indicando los cambios que quieres.

Se admiten 22 idiomas: inglés, chino, español, japonés, francés, alemán, coreano, ruso, italiano, portugués, hindi, árabe, turco, polaco, ucraniano, indonesio, vietnamita, tailandés, griego, hebreo, neerlandés y checo.

Cada mazo usa una pareja: el idioma que estudias y el de las traducciones y explicaciones. Puedes combinar dos idiomas cualesquiera de la lista. La calidad del material depende de cómo trabajen los modelos con la pareja elegida.

Si necesitas otro idioma, solicítalo en GitHub y veremos qué se puede hacer.

Para crear tarjetas necesitas:

• Un ordenador con macOS, Linux o Windows.
• Conexión a Internet: el texto, el audio y las ilustraciones se crean mediante la API de Gemini.
• Tu propia clave de la API de Gemini. Crear una clave en Google AI Studio →

Para repasar, instala Anki →

Si el idioma elegido requiere comprobar localmente si hay texto en las imágenes, el programa también descargará modelos de reconocimiento de texto (OCR) la primera vez que genere ilustraciones.

Hay versiones listas para instalar en macOS, Linux y Windows.

• macOS y Linux: instalación mediante Homebrew o el script de instalación.
• Windows: el script de instalación se ejecuta en Git Bash, MSYS o Cygwin.

Encontrarás los comandos y el enlace al script en la sección de instalación.

Kamishibai es gratuito y su código fuente es abierto. Las solicitudes a Gemini realizadas con tu clave de API se pagan por separado.

Como orientación, calcula unos 15 USD por 100 tarjetas con texto, audio e ilustraciones. Es una estimación: el importe depende del volumen de material, de las veces que se vuelva a generar y de las tarifas de los modelos. Los modelos ya están elegidos en el programa, así que no tienes que configurarlos para empezar.

A cuatro tarjetas nuevas al día, un mazo de cien tarjetas da para 25 días. Después tendrás que seguir repasando las frases aprendidas. Por eso elijo palabras que de verdad quiero usar y doy prioridad a la calidad de las tarjetas sobre el menor coste posible de generación.

Tu trabajo se guarda en tu ordenador: ajustes, sesiones, caché y archivos terminados. Kamishibai no tiene un servidor propio para crear tarjetas.

Para generar y comprobar el material, el programa envía a Gemini las palabras, las frases y las ilustraciones que hay que evaluar, usando tu clave de API. Si sincronizas a través de Anki, el mazo terminado y los archivos multimedia también se envían a AnkiWeb.

La clave guardada está en un archivo local de configuración, no en el gestor de contraseñas del sistema. No compartas ese archivo con otras personas ni lo añadas a un repositorio público.

Sí, puede haber errores. Pero, según mi experiencia, la generación actual de modelos ya ofrece resultados bastante consistentes, y dedico mucho trabajo a la calidad de las tarjetas.

El audio es actualmente la parte más fiable y se acerca al habla natural. Los modelos son menos precisos con la dificultad de las frases: se guían por el nivel elegido, pero a veces producen una frase más sencilla o más difícil.

La mayoría de los errores aparecen en las ilustraciones: la IA todavía puede dibujar a una persona con un tercer brazo. Por eso la aplicación utiliza otros modelos de IA para evaluar las imágenes terminadas. Si una imagen no supera la comprobación, el programa la genera de nuevo.

La comprobación automática no garantiza que todo el contenido sea correcto. Si una frase te hace dudar, es mejor contrastarla con un diccionario o un profesor y volver a crear la tarjeta si hace falta.

Un agente de IA, como Claude Code, puede usar kamishibai. Tú describes la tarea y el agente la realiza mediante los comandos del programa. Por ejemplo, puedes pedirle que:

• Seleccione palabras sobre un tema o a partir de tu texto.
• Elija los significados que necesitas y cree las tarjetas.
• Revise el resultado y vuelva a crear las tarjetas que no hayan quedado bien antes de importarlas en Anki.

Para ello existe una interfaz de línea de comandos, JSON CLI. Sus comandos devuelven datos en JSON y no requieren responder preguntas en el terminal. El agente puede iniciar la generación en segundo plano y trabajar con varias sesiones a la vez.

Pasa al agente el enlace a llms.txt. Allí se explica cómo instalar o actualizar kamishibai y acceder a las instrucciones integradas de la versión instalada. El uso del propio agente y las generaciones adicionales de tarjetas pueden aumentar el gasto.

Cuando quieres conservar una redacción concreta, como las frases de una clase o unos diálogos cortos. En lugar de una lista de palabras, entregas el contenido de las tarjetas en un archivo cards JSON, un archivo de texto con una estructura definida.

El archivo debe incluir todos los campos obligatorios de la tarjeta, no solo la frase. Puedes prepararlo tú o encargárselo a un agente de IA. La redacción del archivo se conserva sin reescribirla. Kamishibai añade el audio y las ilustraciones, y después crea el mazo de Anki en formato APKG y un PDF para imprimir.

Esquema, campos obligatorios y ejemplos en cards-json.md →

Sí. Kamishibai crea las tarjetas en el ordenador y puedes repasarlas en la aplicación móvil de Anki.

• Abre el archivo .apkg en Anki en el ordenador. Si el doble clic no inicia la importación, elige Archivo → Importar.
• Sincroniza la colección a través de AnkiWeb.
• Inicia sesión con la misma cuenta en la aplicación móvil y sincroniza para descargar las tarjetas, las imágenes y el audio.

Para estudiar sin pantalla, puedes imprimir el PDF, recortar las tarjetas y doblarlas. En papel no tendrás audio ni un calendario automático de repasos.

El texto, el audio y las ilustraciones los generan modelos de la familia Gemini. Kamishibai les da instrucciones, comprueba parte del resultado y reúne el material en tarjetas.

El audio lo sintetiza un modelo, no lo graba un locutor. Debes revisarlo junto con el resto del contenido antes de empezar a estudiar.

Si no recuerdas el sentido de la frase o la palabra clave, pulsa «Otra vez». Anki volverá a mostrarte la tarjeta antes. Esto se aplica tanto a una tarjeta nueva como a una que llevabas meses sabiendo.

La exigencia al evaluar depende de lo que estés practicando. Al principio admito un pequeño error de artículo o preposición si he recordado el sentido y las palabras clave. Cuando las frases se vuelven familiares, empiezo a exigirme precisión también en esos detalles.

Si una tarjeta te cuesta una y otra vez, revisa la frase: ¿se entiende la situación?, ¿hay demasiados elementos desconocidos? A veces es más útil simplificar o cambiar el ejemplo que volver a intentar memorizarlo tal como está.

No hay un plazo exacto. El resultado depende de tu nivel inicial, de las frases elegidas, de la regularidad de los repasos y de si usas el idioma fuera de Anki.

Las primeras 50 frases bien aprendidas pueden servirte para hacer balance: ¿recuerdas con más facilidad las expresiones conocidas?, ¿las reconoces en textos nuevos?, ¿consigues usarlas al hablar? No es un umbral a partir del cual vayas a adquirir necesariamente «intuición para el idioma». Fíjate en lo que ya te sale mejor, no solo en el contador de tarjetas.