Skip to content

Files

windows-setup.md

Latest commit

nishionishio
Address CodeRabbit review on Windows setup
May 23, 2026
4b01bce · May 23, 2026

History

History
98 lines (61 loc) · 5.89 KB

windows-setup.md

File metadata and controls

98 lines (61 loc) · 5.89 KB

Windows環境でのユーザーガイド

このドキュメントでは、開発者でない人がWindows環境で広聴AI（kouchou-ai）を使うための手順を説明します。 ソフトウェア開発に必要な要素を取り除いて最小限にしたものです。

前提条件

セットアップ手順

1. Docker Desktopのインストール

  1. Docker Desktop for Windowsをダウンロードしてインストールします。
  2. インストール後、コンピューターを再起動してください（Dockerコマンドのパスを正しく設定するために必要です）。
  3. 再起動後、Docker Desktopを明示的に起動します（自動起動の設定をしていない場合は毎回必要です）。
  4. タスクバーのDockerアイコンが実行中（緑色）になっていることを確認します。

2. 広聴AIのダウンロード

  1. 広聴AI安定版リリースから最新の安定版をダウンロードします。
  2. ダウンロードしたzipファイルを任意の場所に展開します。

3. APIキーの準備

  1. OpenAI APIにアクセスし、OpenAI APIキーを取得します（OpenAIモデルを使用する場合）。
  2. Google AI Studioにアクセスし、Gemini APIキーを取得します（Geminiモデルを使用する場合）。
  3. APIキーをコピーして、メモ帳などに一時的に保存しておくと便利です。
  4. 重要: APIキーは正確にコピーしてください。入力ミスがあると、後の処理でエラーが発生します。

4. セットアップの実行

  1. 展開したフォルダ内のsetup_win.batファイルをダブルクリックします。
  2. setup_win.ps1 の入力ダイアログが開いたら、OpenAI APIキーとGemini APIキーを入力します（どちらか一方でも可）。
    • setup_win.ps1 は Prompt-Value で GUI の InputBox を表示し、形式確認が必要な場合は Confirm-Message の確認ダイアログを表示します。
    • 注意: 入力欄でCtrl+Vの貼り付けができない場合は、右クリックして「貼り付け」を選択してください。
  3. セットアップが自動的に進行し、APIキーの有効性確認後にDockerコンテナが起動します。

5. アプリケーションへのアクセス

セットアップが完了すると、以下のURLでアプリケーションにアクセスできます：

6. アプリケーションのアクセス・運用と再起動の手順

セットアップ後は、次回以降の起動や停止を以下のように行ってください。

通常の起動・停止

  • アプリケーションの起動:
    フォルダ内の start_win.bat をダブルクリックします（または Docker デスクトップから操作）

  • アプリケーションの停止:
    stop_win.bat をダブルクリックします（または Docker デスクトップから操作）

APIキーを変更したい場合

OpenAI APIキーやGemini APIキーを再設定したい場合は、再度 setup_win.bat を実行してください。

  1. 既存のアプリケーションが起動中の場合は stop_win.bat で停止してください。
  2. setup_win.bat を実行し、新しい APIキーを入力します。
  3. 自動的に再ビルドと起動が行われます。

※ setup_win.bat の再実行では、既存の .env ファイルが上書きされます。

トラブルシューティング

!!! note "Windows 実機での検証を行う開発者・AI エージェント向け" setup_win.bat と Docker Desktop (Linux containers) の実機検証観点は、Windows 実機セットアップ検証手順 にまとめています。

Docker Desktopが起動していない場合

エラーメッセージ「Docker Desktop が起動していません」が表示された場合は、Docker Desktopを起動してから再度setup_win.batを実行してください。Docker Desktopは自動起動設定をしていない限り、毎回手動で起動する必要があります。

Dockerコマンドが認識されない場合

Dockerをインストールした直後は、コマンドのパスが通っていない場合があります。コンピューターを再起動してから再度試してください。

APIキーの入力に関する問題

  • 貼り付けができない場合: setup_win.ps1 の入力ダイアログ内で Ctrl+V が機能しないことがあります。入力欄を右クリックして「貼り付け」を選択してください。 APIキーが正しく動作しない場合: APIキーが正確にコピーされているか確認してください。OpenAI APIキーは「sk-」で始まります。Gemini APIキーは「AIza」で始まります。入力ミスがあると、後の処理でエラーが発生します。

WSL2の有効化が必要な場合

Docker Desktopの初回起動時にWSL2の有効化を求められた場合は、指示に従ってWSL2を有効化してください。詳細はMicrosoft公式ドキュメントを参照してください。

メモリ不足エラーが発生する場合

Docker Desktopの設定からリソース割り当て（メモリ、CPU）を増やしてください。推奨設定：

  • メモリ: 4GB以上
  • CPU: 2コア以上