Вопросы перед установкой

Тем, кто хочет учить язык на своём материале и готов возвращаться к нему месяцами или годами. Ты выбираешь слова из книг, субтитров, уроков или разговоров, а 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 хорошо выученных фраз можно взять как ориентир для проверки: легче ли вспомнить знакомые обороты, узнаёшь ли их в новых текстах, удаётся ли использовать в разговоре? Это не порог, после которого обязательно появится «чувство языка». Смотри на то, что стало получаться, а не только на счётчик карточек.