Вопросы, которые могут возникнуть перед установкой
Кому подходит kamishibai?
Тем, кто готов заниматься интервальными повторениями регулярно и долго — месяцы, а не пару вечеров. kamishibai — не курс. Он не выбирает темы и не ведёт по программе: ты приносишь слова, которые случайно встретил в книге, субтитрах или разговоре, а kamishibai превращает их в карточки.
Дальше работает Anki: она сама решает, сколько карточек показать сегодня, и не даёт дневной сессии разрастись. Интервалы между повторами постепенно растут — от пары дней до недель и месяцев.
Что можно дать на вход?
Основной путь — список слов: выбираешь нужные значения, и для каждого kamishibai пишет новую фразу. Если содержание карточек уже готово, передай его в формате cards JSON: внутри полей может быть что угодно, лишь бы сходилась схема, — озвучку и картинки kamishibai добавит сам.
Что делает Anki, а что kamishibai?
kamishibai готовит карточки и собирает их в файл .apkg — формат для импорта в Anki. Anki планирует повторения и хранит оценки ответов. Если нужны физические карточки, kamishibai также создаёт PDF: его можно распечатать и разрезать.
Нужно уметь программировать?
Нет. Основной режим — пошаговый TUI в терминале: вставляешь слова, выбираешь значения, проверяешь карточки и получаешь колоду. JSON CLI нужен только скриптам и внешним агентам.
Кто решает, что попадёт на карточку?
Ты. В терминале ты работаешь со своими словами: выбираешь значения и решаешь, какие карточки оставить. Ту же работу можно поручить агенту, но проверка результата всё равно остаётся за тобой.
Какие языки поддерживаются?
EN, ZH, ES, JA, FR, DE, RU, IT, PT, EL и NL — в любой паре. Один запуск работает с одной парой. Не все сочетания модели знают одинаково хорошо. Если нужен другой язык, открой issue на GitHub — посмотрим, что можно сделать.
Что понадобится перед запуском?
Компьютер, интернет во время генерации и свой ключ Gemini API — создать его можно в Google AI Studio → Для повторений нужен Anki → При первой генерации иллюстраций kamishibai докачает OCR-модели.
На каких системах это работает?
Готовые сборки есть для macOS, Linux и Windows. Homebrew работает на macOS и Linux. Shell installer также можно запустить в Git Bash, MSYS или Cygwin на Windows.
Сколько это стоит?
Сам kamishibai бесплатен и открыт, но запросы к Gemini оплачиваются по твоему ключу. Генерация 100 карточек обходится примерно в $15. Это грубая оценка: итог зависит от того, сколько карточек придётся перегенерировать. Модели выбирать не нужно, они уже настроены: я стараюсь держать актуальные, но относительно недорогие, и ставлю качество карточек выше минимального расхода токенов.
Сто карточек — это 100 полноценных фраз и несколько сотен слов в контексте, на изучение которых обычно уходит месяц или два. Поэтому kamishibai лучше использовать для слов, которые тебе действительно важно запомнить.
Куда уходят слова и ключ?
Сессии, кэш и готовые файлы лежат на твоём диске. Собственного сервера у kamishibai нет. Генерация идёт через Gemini по твоему ключу, поэтому слова и фразы покидают компьютер. Сохранённый ключ лежит в локальном файле настроек, не в системном хранилище секретов.
Сгенерированный материал может быть ошибочным?
Да. Модель может выбрать не тот оттенок смысла, ошибиться в IPA, а озвучка — прозвучать неудачно. Качество и стиль иллюстраций kamishibai проверяет сам и неудачные пробует заново — заложено до трёх повторных попыток, поэтому токенов иногда уходит больше. В редких случаях слово может исчерпать все попытки и остаться без карточки. Проверяй колоду до того, как начнёшь повторять.
Что именно означает Agent Ready?
Это значит, что утилитой может пользоваться не только человек, но и агент вроде Claude Code. Команды JSON CLI — new, select или exclude, generate, status, result — не требуют интерактивного ввода и возвращают машиночитаемый ответ, поэтому агент может вызывать их асинхронно и вести несколько сессий параллельно. Как пользоваться командами, описано в llms.txt — достаточно показать агенту этот файл.
Агенту можно поручить:
- сформировать список слов под конкретную задачу,
- выбрать значения,
- проверить готовые карточки перед импортом.
Это удобно для больших объёмов, но лишние проверки и перегенерации увеличивают расход токенов и стоимость.
Зачем нужен свой JSON?
Свой cards JSON пригодится, когда формулировки должны быть полностью твоими: готовые предложения, мини-диалоги, фразы из урока. Передай содержание — kamishibai добавит озвучку и иллюстрации, затем соберёт APKG и PDF. Строгая схема — в cards-json.md →
Можно повторять на телефоне?
Генерация запускается на компьютере. Дальше обычно достаточно дважды кликнуть по файлу .apkg: Anki откроется и начнёт импорт (если нет — выбери Файл → Импорт). Колоду с телефоном синхронизирует сама Anki.
В PDF расписания нет, зато из него получаются бумажные карточки: распечатай, разрежь и сложи. Самые важные или трудные фразы можно держать на столе — правда, без звучания.
Кто создаёт текст, озвучку и иллюстрации?
Текст, озвучку и иллюстрации генерируют модели семейства Gemini.
Что делать, если карточка вообще не вспоминается?
Нажми «Снова» и продолжай. Строгость оценки подстраивай под свой уровень. В начале можно засчитать ответ с ошибкой в артикле или предлоге, если помнишь смысл фразы и ключевые слова. Когда хорошо выучишь первые 50 фраз, повышай требования к ответам.
Если через несколько месяцев вдруг не вспомнишь знакомую карточку, нажми «Снова»: часто именно после такой ошибки фраза запоминается навсегда.
Когда можно ждать результата?
После первых 50 хорошо выученных фраз уже можно заметить эффект: знакомые конструкции вспоминаются легче, и постепенно появляется чувство языка хотя бы в той области, из которой они пришли.