教科書作成関連プログラム インストール方法

想定環境

 以下の環境で開発していますが、CLIのpythonプログラムはLinux, macOSでも動くと思います。


プログラムの入手方法

http://d2mate.mdxes.iir.isct.ac.jp/D2MatE/textbook/textbook_programs.html 
から個別にダウンロードしたりコピペできます。

まとめて入手する場合は以下の手順:
注: メインテナンスの都合上、教科書作成に関係のないプログラムも入っていますが、ご容赦ください

  1. pythonと、shutil, requests ライブラリをインストール (次項参照)
    > pip install shutil requests
  2. http://d2mate.mdxes.iir.isct.ac.jp/download/tkProg/tkProg_textbook
    から、update.py と update_textbook.bat を適当なフォルダーにダウンロード
  3. update_textbook.batを実行。
    > update_textbook.bat
      tkprog_textbook/ai
      tkprog_textbook/converter
      tkprog_textbook/multimedia
    フォルダに、プログラム及びプログラムの説明を書いたMarkdownファイル .mdが保存されます。

python関係のインストール

Pythonのインストール: https://www.python.org/ から python (3.10以上推奨) をインストール

必要なライブラリを一括インストール:

  1. プログラムファイルのダウンロードに必要:
    > pip install requests bs4
  2. > pip install -r requirements-textbook.txt
  3. transcribe_simple.pyを使う場合:
    FFmpegをインストール:
    > winget install --id=Gyan.FFmpeg -e

以下は、一括インストールする場合は不要です

個別インストール:

  1. > python -m pip install --upgrade pip
  2. > pip install wheel update.py
  3. プログラムファイルのダウンロードに必要:
    > pip install requests bs4
  4. to_audio.py (動画ファイルを音声ファイルに変換) に必要:
    > pip install pydub transcribe_simple.py
  5. (OpenAI whisper local版を使った読み起こしプログラム) に必要:
    > pip install git+https://github.com/openai/whisper.git
    FFmpegをインストール
    > winget install --id=Gyan.FFmpeg -e
  6. bin フォルダのパスを環境変数 PATH に追加
  7. pptx2md.py (PowerPointファイルをMarkdownに変換) に必要:
    > pip install python-pptx
  8. make_textbook.py (教科書作成支援プログラム) に必要:
    > pip install google-generativeai openai python-dotenv

pythonで生成AIを使う場合 (make_textbook5.py)

プログラムから生成AIを使う場合は、それぞれの API (Application Program Interface) を使う必要があります。
本システムでは Google Gemini 2.5Flash を使うことをお薦めします。
注: Gemini APIではサブスクリプションをしなくても、無料枠を試せます (https://ai.google.dev/gemini-api/docs/pricing?hl=ja)。

  1. Google AI Studio (https://ai.google.dev/aistudio?hl=ja) から Google API Key を取得する
  2. 環境変数 GOOGLE_API_KEY に Google API Key を設定する

OpenAI APIを使う場合は、環境変数 OPENAI_API_KEY に API Keyを設定してください


GUI (tkProg:Launcher) で教科書作成関係のプログラムを使う場合:

  1. update_textbook.batを launcher オプションで実行。
    > update_textbook.bat launcher
      tklib
      tkprog_textbook/config
      tkprog_textbook/editor
      tkprog_textbook/Launcher
    フォルダに、プログラムが保存されます。
  2. Launcherの設定:
    > python setup.py
  3. Launcherを起動