Запитання перед установленням

Тим, хто хоче вивчати мову на власному матеріалі й готовий повертатися до нього місяцями або роками. Ти вибираєш слова з книжок, субтитрів, уроків чи розмов, а kamishibai створює з ними картки. Програма не замінює курс: вона не вибирає за тебе теми та послідовність їх вивчення.

Повтореннями займається Anki. В основі її розкладу — інтервальні повторення: знайомі картки з’являються через дедалі довші проміжки часу, а забуті — раніше. Кількість нових карток і денні обмеження налаштовуються в Anki.

Я вірю, що завдяки новому поколінню AI-агентів ми можемо створювати авторські програми так само легко, як колись вели блоги: ділитися своїм досвідом через підходи, які інші можуть легко застосовувати. Kamishibai — мій спосіб перевірити цю ідею. Передусім це інструмент, яким я сам користуюся щодня і який розвиваю на основі цієї практики.

Манґака, автор манги, особисто поєднує історію, малюнок і характери героїв у цілісний твір. Мені близький такий авторський підхід. Звідси й вибір візуальної мови kamishibai: мені подобається, коли проєкт має власний погляд, помітний і в задумі, і в оформленні.

В основному режимі — список слів або висловів, які хочеш вивчити. Необов’язково приводити їх до словникової форми: kamishibai спробує розпізнати введений текст і запропонує значення на вибір. Для кожного вибраного значення створюється окрема картка з реченням.

Якщо речення не підходить, можна описати, що треба змінити, і запустити генерацію знову. А якщо тексти карток уже готові, їх можна передати у форматі cards JSON — про це є окрема відповідь нижче.

Kamishibai готує матеріал: створює речення, пояснення, озвучення та ілюстрації, а потім збирає їх у файл .apkg — колоду, яку можна відкрити в Anki.

Anki організовує повторення: показує картки, зберігає твої оцінки й призначає дату наступного повторення.

Kamishibai також створює PDF для паперових карток. Його можна роздрукувати й розрізати, якщо хочеться займатися без екрана.

Ні. Після встановлення ти запускаєш kamishibai в терміналі — вікні з текстовим інтерфейсом. Далі програма веде крок за кроком: додати слова, вибрати значення, перевірити картки й отримати колоду. Писати код для цього не потрібно.

Для автоматизації є окремі команди, які повертають відповіді у форматі JSON. Ними можуть користуватися скрипти й AI-агенти, але для звичайної роботи вони не знадобляться.

Ти вибираєш слова й значення, а AI-моделі створюють матеріал за правилами, закладеними в kamishibai. Ці правила визначають структуру картки та вимоги до речення, пояснення, озвучення й ілюстрації.

Перед генерацією можна вибрати складність і тип речень: розповідні, питальні, діалоги або їх поєднання. Готовий результат можна перевірити й надіслати на повторну генерацію з побажаннями.

Підтримуються 22 мови: англійська, китайська, іспанська, японська, французька, німецька, корейська, російська, італійська, португальська, гінді, арабська, турецька, польська, українська, індонезійська, в’єтнамська, тайська, грецька, іврит, нідерландська та чеська.

Для колоди вибирається одна пара: мова, яку вивчаєш, і мова перекладу та пояснень. Можна поєднати будь-які дві мови зі списку. Якість матеріалу залежить від того, наскільки добре моделі працюють із вибраною парою.

Якщо потрібна інша мова, створи запит на GitHub — подивимося, що можна зробити.

Для створення карток потрібні:

• Комп’ютер із macOS, Linux або Windows.
• Інтернет: текст, озвучення й ілюстрації створюються через Gemini API.
• Власний ключ Gemini API. Створити ключ у Google AI Studio →

Для повторень установи Anki →

Якщо вибрана мова потребує локальної перевірки тексту на зображеннях, під час першого створення ілюстрацій програма також завантажить моделі розпізнавання тексту (OCR).

Готові версії є для macOS, Linux і Windows.

• macOS і Linux: установлення через Homebrew або інсталяційний скрипт.
• Windows: інсталяційний скрипт запускається через Git Bash, MSYS або Cygwin.

Команди й посилання на скрипт знайдеш у розділі встановлення.

Kamishibai безплатний, його вихідний код відкритий. Окремо оплачуються запити до Gemini за твоїм API-ключем.

Орієнтир — близько $15 за 100 карток із текстом, озвученням та ілюстраціями. Це приблизна оцінка: підсумок залежить від обсягу матеріалу, повторних генерацій і тарифів моделей. Моделі вже вибрані в програмі, налаштовувати їх для початку роботи не потрібно.

За чотирьох нових карток на день колоди зі ста карток вистачить на 25 днів. Повторювати вивчені речення потрібно й далі. Тому я вибираю слова, які справді хочу використовувати, і ставлю якість карток вище за мінімальну вартість генерації.

Робота зберігається на твоєму комп’ютері: налаштування, сесії, кеш і готові файли. Власного сервера для створення карток у kamishibai немає.

Для генерації та перевірки матеріалів програма надсилає до Gemini слова, речення й ілюстрації, які перевіряє, використовуючи твій API-ключ. Під час синхронізації через Anki готова колода й медіафайли також передаються до AnkiWeb.

Збережений ключ міститься в локальному файлі налаштувань, а не в системному сховищі паролів. Не передавай цей файл іншим людям і не додавай його до публічного репозиторію.

Так, помилки трапляються. Але з мого досвіду нинішнє покоління моделей уже дає доволі стабільний результат, і я багато працюю над якістю готових карток.

Найстабільніше зараз виходить озвучення, близьке до природного мовлення. Зі складністю речень моделі справляються менш точно: орієнтуються на вибраний рівень, але іноді пропонують речення простіше або складніше.

Найбільше помилок буває в ілюстраціях: AI досі може намалювати людині третю руку. Тому в застосунку є окремі AI-моделі, які оцінюють готові зображення. Якщо зображення не проходить перевірку, програма створює його знову.

Автоматична перевірка не гарантує правильності всього матеріалу. Сумнівне речення краще перевірити за словником або з викладачем і за потреби створити картку заново.

Із kamishibai може працювати AI-агент, наприклад Claude Code. Ти описуєш завдання, а агент виконує його через команди програми. Наприклад, йому можна доручити:

• Дібрати слова за темою або з твого тексту.
• Вибрати потрібні значення й створити картки.
• Перевірити результат і повторно створити невдалі картки перед імпортом в Anki.

Для цього є JSON CLI — команди, які повертають дані у форматі JSON і не потребують діалогу в терміналі. Агент може запускати генерацію у фоні й вести кілька сесій одночасно.

Передай агенту посилання на llms.txt. Там описано, як установити або оновити kamishibai й отримати вбудовані інструкції для встановленої версії. Робота самого агента й додаткові генерації карток можуть збільшити витрати.

Коли важливо зберегти готові формулювання: наприклад, речення з уроку або короткі діалоги. Замість списку слів ти передаєш вміст карток у файлі cards JSON — текстовому файлі із заданою структурою.

Файл має містити всі обов’язкові поля картки, а не лише речення. Його можна підготувати самостійно або доручити це AI-агенту. Формулювання з файлу зберігаються без переписування. Kamishibai додасть озвучення й ілюстрації, а потім збере колоду Anki у форматі APKG та PDF для друку.

Схема, обов’язкові поля та приклади — у cards-json.md →

Так. Kamishibai створює картки на комп’ютері, а повторювати їх можна в мобільному застосунку Anki.

• Відкрий готовий файл .apkg в Anki на комп’ютері. Якщо подвійне клацання не запускає імпорт, вибери Файл → Імпорт.
• Синхронізуй колекцію через AnkiWeb.
• Увійди в той самий обліковий запис у мобільному застосунку й запусти синхронізацію, щоб завантажити картки, зображення та звук.

Для занять без екрана можна роздрукувати PDF, розрізати аркуші й скласти картки. На папері не буде озвучення та автоматичного розкладу повторень.

Текст, озвучення й ілюстрації генерують моделі сімейства Gemini. Kamishibai дає їм інструкції, перевіряє частину результату й збирає матеріали в картки.

Озвучення синтезує модель, а не записує диктор. Його потрібно перевірити разом з рештою вмісту до початку занять.

Якщо не згадується зміст речення або ключове слово, натисни «Знову». Anki поверне картку на повторення раніше. Це стосується і нової картки, і тієї, яку ти знав кілька місяців.

Суворість оцінки залежить від того, що ти зараз тренуєш. На початку я допускаю дрібну помилку в артиклі або прийменнику, якщо згадав зміст і ключові слова. Коли речення стають знайомими, починаю вимагати від себе точності й у цих деталях.

Якщо одна картка постійно завдає труднощів, перевір саме речення: чи зрозуміла ситуація, чи не забагато в ньому незнайомого? Іноді корисніше спростити або замінити приклад, ніж знову намагатися запам’ятати його без змін.

Точного строку немає. Результат залежить від початкового рівня, вибраних речень, регулярності повторень і того, чи використовуєш ти мову поза Anki.

Перші 50 добре вивчених речень можна взяти за орієнтир для перевірки: чи легше згадувати знайомі звороти, чи впізнаєш їх у нових текстах, чи вдається використовувати в розмові? Це не поріг, після якого обов’язково з’явиться «відчуття мови». Зважай на те, що вже вдається, а не лише на лічильник карток.