教科書作成関連プログラム インストール方法
想定環境
以下の環境で開発していますが、CLIのpythonプログラムはLinux,
macOSでも動くと思います。
- OS: Windows 11
- ターミナルアプリ: cmd.exe
- テキストエディタ:
・ Microsoft Visual Studio Code (VSC)
・ Markdown Preview Enhanced拡張機能
- pytyon 3.10-12 (pydubがpypthon3.13以降に対応していません) および各種ライブラリ
- 生成AI API
・ Gemini 2.5Flashを薦めますが、OpenAI (ChatGPT4,
GPT5など) も使えます
Gemini 3.0系には未対応です
プログラムバージョン
以下の2バージョンを並行公開しています。
- Ver 1. 2025/9,
2025/11のチュートリアルで説明したバージョンです。
マニュアルは、チュートリアル動画・資料をご覧ください。
Ver. 2との違い:
・ VOICEVOX Engineを使用できません (VOICEVOXアプリでの音声生成は可能)
・ 講義動画では独話のみに対応
- Ver 2. Ver. 1に以下の機能を追加しました。マニュアルが未整備のため、下記の機能が不要の場合は
Ver. 1 をご利用ください
Ver. 1との違い:
・ VOICEVOX Engineに対応。
VOICEVOX EngineをインストールすればVOICEVOXアプリを使わずに音声生成が可能。
・ 講義動画で対話型解説に対応
Ver. 2プログラムの入手方法
Ver. 1プログラムの入手方法
参考: http://d2mate.mdxes.iir.isct.ac.jp/D2MatE/textbook/textbook_programs.html
から個別にダウンロードしたりコピペできます。
- copy ボタンを押してコピー、テキストエディタに張り付けて保存
- download リンクで「名前を付けて保存」
インストール方法:
python関係のインストール
Pythonのインストール: https://www.python.org/ から python
(3.10以上推奨) をインストール
必要なライブラリを一括インストール:
- プログラムファイルのダウンロードに必要:
> pip install requests bs4
- > pip install -r requirements-textbook.txt
- transcribe_simple.pyを使う場合:
FFmpegをインストール:
> winget install --id=Gyan.FFmpeg -e
以下は、一括インストールする場合は不要です
個別インストール:
- > python -m pip install --upgrade pip
- > pip install wheel update.py
- プログラムファイルのダウンロードに必要:
> pip install requests bs4
- to_audio.py (動画ファイルを音声ファイルに変換) に必要:
> pip install pydub transcribe_simple.py
- (OpenAI whisper local版を使った読み起こしプログラム)
に必要:
> pip install git+https://github.com/openai/whisper.git
FFmpegをインストール
> winget install --id=Gyan.FFmpeg -e
- bin フォルダのパスを環境変数 PATH に追加
- pptx2md.py (PowerPointファイルをMarkdownに変換) に必要:
> pip install python-pptx
- 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)。
- Google AI Studio (https://ai.google.dev/aistudio?hl=ja)
から Google API Key を取得する
- 環境変数 GOOGLE_API_KEY に Google API Key を設定する
OpenAI APIを使う場合は、環境変数 OPENAI_API_KEY に API
Keyを設定してください
GUI (tkProg:Launcher)
で教科書作成関係のプログラムを使う場合:
- update_textbook.batを launcher オプションで実行。
> update_textbook.bat launcher
tklib
tkprog_textbook/config
tkprog_textbook/editor
tkprog_textbook/Launcher
フォルダに、プログラムが保存されます。
- Launcherの設定:
> python setup.py
- Launcherを起動
関連プログラム
ファイル変換
- pandoc (Markdown => MS-Word, PowerPoint変換。PowerPoint変換ではmarpを推奨)
- marp (Markdown => PowerPoint変換)
(先にnpmをインストール)
> npm install -g @marp-team/marp-cli
Text-To-Speech
- VOICEVOX Engine (使用する場合)
- AquesTalkPlayer
- Windowsの言語パッケージのインストール
特に、英語を使う場合は英語(米国)、英語(英国)など
英語で対話の読み上げを行う場合、複数の言語パッケージをインストールする必要があります