インストール前の質問
kamishibai はどんな人に向いていますか？
自分で選んだ素材で語学を学び、数か月、あるいは数年かけて続けたい人に向いています。本や字幕、授業、会話から単語を選ぶと、kamishibai がカードにします。講座の代わりではないので、学ぶテーマや順番は自分で決めます。
復習は Anki が担当します。間隔反復をもとに、よく覚えているカードは間隔を広げ、忘れたカードは早めに出題します。新しいカードの枚数や 1 日の上限は Anki で設定できます。
なぜ漫画なのですか？
新世代の AI エージェントの力を借りれば、かつてブログを書いていたのと同じくらい気軽に、自分らしいソフトウェアを作れると私は考えています。自分の経験を、ほかの人も気軽に取り入れられる方法という形で伝える。Kamishibai は、その考えを実際に試すためのプロジェクトです。何よりも、私自身が毎日使う道具です。その日々の経験をもとに育てています。
漫画家は物語、絵、登場人物の個性を自らひとつの作品にまとめます。私は、その作家としての姿勢にひかれます。Kamishibai の見た目に漫画を選んだのもそのためです。コンセプトにもビジュアルにも、作り手の視点が表れているプロジェクトが好きなのです。
kamishibai には何を追加できますか？
基本のモードでは、覚えたい単語や表現のリストを入力します。辞書に載っている形に直す必要はありません。Kamishibai が入力を読み取り、意味の候補を出します。選んだ意味ごとに、例文の入ったカードを 1 枚作ります。
例文が合わなければ、変えたい点を伝えて作り直せます。カードの文面がすでにある場合は、cards JSON 形式で渡すこともできます。詳しくは後の項目で説明しています。
Anki と kamishibai の役割は何ですか？
Kamishibai は教材を作ります。例文、説明、音声、イラストを生成し、Anki で開けるデッキとして .apkg ファイルにまとめます。
Anki は復習を管理します。カードを表示し、自分で付けた評価を記録して、次の復習日を決めます。
Kamishibai は紙のカード用の PDF も作ります。画面を使わずに学びたいときは、印刷して切り分けられます。
プログラミングの知識は必要ですか？
いいえ。インストール後、文字で操作するウィンドウであるターミナルで kamishibai を起動します。あとは単語の追加、意味の選択、カードの確認、デッキの作成まで順番に案内します。コードを書く必要はありません。
自動化用には、JSON 形式で結果を返すコマンドもあります。スクリプトや AI エージェント向けのもので、通常の使い方では必要ありません。
カードの内容は誰が決めますか？
単語と意味は自分で選び、AI モデルが kamishibai に組み込まれたルールに従って教材を作ります。ルールではカードの構造と、例文、説明、音声、イラストに求める条件を定めています。
生成前には、難易度と文の種類を選べます。平叙文、疑問文、会話、またはそれらの組み合わせです。できあがった内容を確認し、希望を伝えて作り直すこともできます。
どの言語に対応していますか？
対応言語は 22 言語です。英語、中国語、スペイン語、日本語、フランス語、ドイツ語、韓国語、ロシア語、イタリア語、ポルトガル語、ヒンディー語、アラビア語、トルコ語、ポーランド語、ウクライナ語、インドネシア語、ベトナム語、タイ語、ギリシャ語、ヘブライ語、オランダ語、チェコ語に対応しています。
デッキごとに、学ぶ言語と翻訳・説明に使う言語を 1 組選びます。リスト内のどの 2 言語でも組み合わせられます。教材の質は、モデルがその組み合わせをどれだけうまく扱えるかによって変わります。
ほかの言語が必要なら、GitHub で要望を送ってください。対応できるか検討します。
始める前に何を用意すればよいですか？
カード作成には、次のものが必要です。
- macOS、Linux、Windows のいずれかが動くコンピュータ。
- インターネット接続。文章、音声、イラストは Gemini API 経由で生成します。
- 自分の Gemini API キー。Google AI Studio でキーを作成 →
復習用には Anki をインストールしてください →
選んだ言語で画像内の文字をローカルで検査する必要がある場合、初めてイラストを作るときに文字認識（OCR）モデルもダウンロードします。
kamishibai はどの OS で動きますか？
macOS、Linux、Windows 向けに、すぐ使えるプログラムを用意しています。
- macOS と Linux：Homebrew またはインストール用スクリプトを使います。
- Windows：Git Bash、MSYS、Cygwin のいずれかでインストール用スクリプトを実行します。
コマンドとスクリプトへのリンクは、インストールの項目にあります。
費用はどのくらいかかりますか？
Kamishibai は無料で、ソースコードも公開しています。自分の API キーで利用する Gemini の料金は別途かかります。
文章、音声、イラスト付きのカード 100 枚で約 15 米ドルが目安です。実際の費用は、教材の量、作り直しの回数、モデルの料金によって変わります。モデルはプログラム側で選んであるため、使い始める際に設定する必要はありません。
新しいカードを 1 日 4 枚学ぶなら、100 枚で 25 日分です。覚えた文も、その後引き続き復習します。だから私は、本当に使いたい単語を選び、生成費用を最小限に抑えることよりカードの質を大切にしています。
単語はどこへ送られ、キーはどこに保存されますか？
設定、セッション、キャッシュ、完成したファイルは自分のコンピュータに保存されます。Kamishibai はカード作成用の独自サーバーを持っていません。
教材の生成と確認のために、プログラムはユーザーの API キーを使い、単語、文、確認対象のイラストを Gemini に送ります。Anki で同期する場合は、完成したデッキとメディアも AnkiWeb に送信されます。
保存したキーはローカルの設定ファイルにあり、OS のパスワード保管機能には保存されません。このファイルを人に渡したり、公開リポジトリに追加したりしないでください。
カードに間違いが含まれることはありますか？
あります。ただ、私が使っている範囲では、現在の世代のモデルはかなり安定した結果を出しています。完成したカードの質を高めるためにも、継続して取り組んでいます。
今いちばん安定しているのは音声で、自然な話し方に近いものになっています。文の難易度の調整はそれほど正確ではなく、選んだレベルに合わせようとはしますが、簡単すぎたり難しすぎたりすることがあります。
最も間違いが起きやすいのはイラストです。AI は今でも、人に 3 本目の腕を描いてしまうことがあります。そのため、できあがった画像を評価する別の AI モデルを組み込んでいます。検査に通らない画像は作り直します。
自動検査で、すべての教材の正しさを保証できるわけではありません。疑問のある文は辞書や先生に確認し、必要ならカードを作り直してください。
Agent Ready とは具体的にどういう意味ですか？
Claude Code などの AI エージェントが kamishibai を操作できる、という意味です。やりたいことを伝えると、エージェントがプログラムのコマンドを使って実行します。たとえば、次のようなことを任せられます。
- テーマに沿って、または手元の文章から単語を選ぶ。
- 必要な意味を選び、カードを作る。
- 結果を確認し、Anki に取り込む前に出来の悪いカードを作り直す。
このために JSON CLI を用意しています。ターミナルでの対話を必要とせず、JSON 形式でデータを返すコマンドです。エージェントはバックグラウンドで生成を進め、複数のセッションを同時に扱えます。
エージェントに llms.txt のリンクを渡してください。Kamishibai のインストールや更新の方法と、インストール済みのバージョンに組み込まれた説明を取得する方法が書かれています。エージェント自体の利用とカードの追加生成で、費用が増える場合があります。
自分のカードを JSON で渡すと便利なのは、どんなときですか？
授業で使った文や短い会話など、できあがった表現をそのまま使いたいときです。単語リストの代わりに、カードの内容を cards JSON ファイルで渡します。これは、決められた構造に従って書くテキストファイルです。
例文だけでなく、カードに必要な項目をすべて含める必要があります。自分で用意しても、AI エージェントに任せてもかまいません。ファイル内の表現は書き換えずに使います。Kamishibai が音声とイラストを加え、APKG 形式の Anki デッキと印刷用 PDF にまとめます。
スマートフォンでカードを復習できますか？
はい。カードはコンピュータ上の kamishibai で作り、復習には Anki のモバイルアプリを使えます。
- 完成した
.apkgファイルをコンピュータの Anki で開きます。ダブルクリックで取り込みが始まらない場合は、ファイル → 読み込むを選びます。 - AnkiWeb を使ってコレクションを同期します。
- モバイルアプリで同じアカウントにログインし、同期してカード、画像、音声をダウンロードします。
画面を使わずに学びたい場合は、PDF を印刷して切り分け、折りたたんでカードにできます。紙のカードには音声も、自動で復習時期を決める機能もありません。
文章、音声、イラストは誰が作っていますか？
文章、音声、イラストは Gemini ファミリーのモデルが生成します。Kamishibai はモデルに指示を出し、結果の一部を確認して、教材をカードにまとめます。
音声はモデルが合成したもので、ナレーターの録音ではありません。学習を始める前に、ほかの内容と一緒に確認してください。
答えを思い出せないときはどうすればよいですか？
文の意味や大事な単語が思い出せないときは、「もう一度」を押してください。Anki がそのカードの復習を早めに設定します。新しいカードでも、数か月覚えていたカードでも同じです。
どこまで厳しく評価するかは、今何を練習しているかによります。私は最初のうちは、意味と大事な単語が思い出せれば、冠詞や前置詞の小さな間違いは許容しています。文になじんできたら、そうした細部の正確さも求めるようにしています。
同じカードで何度もつまずくなら、例文自体を見直してください。場面が分かりにくくないか、知らないことが多すぎないか。元の文を何度も覚えようとするより、簡単にしたり別の例に変えたりするほうが役立つ場合もあります。
いつ頃から効果が期待できますか？
決まった期間はありません。現在のレベル、選んだ例文、復習の習慣、Anki の外でもその言語を使っているかどうかによって変わります。
最初の 50 文をしっかり覚えたら、ひとつの振り返りの目安にできます。見慣れた表現を思い出しやすくなったか、新しい文章の中でも分かるか、会話で使えるかを確かめてみてください。50 文を超えれば必ず「語感」が身につく、という境目ではありません。カードの枚数だけでなく、できるようになったことに目を向けてください。