コンテンツにスキップ

広聴AI Documentation

direct_win

digitaldemocracy2030/kouchou-ai

Windows環境でのユーザーガイド（開発用にWindowsでDockerを使わずに実行する場合,非推奨）¶

本手順は、Windows環境で Docker を使用せずにローカル開発環境を構築するためのものです。簡易的な検証や開発用途を想定しており、本番環境や推奨構成ではありません。

前提条件¶

Windows 10/11
インターネット接続
OpenAI APIキー（取得方法）

セットアップ手順¶

1. リポジトリのクローン¶

git clone https://github.com/digitaldemocracy2030/kouchou-ai.git
cd kouchou-ai

2. .env ファイルの作成¶

copy .env.example .env

.env.example をベースに .env を作成し、OpenAI APIキー他、各種環境変数を設定します。

3. Node.js の確認（public-viewer / admin用）¶

node -v
pnpm -v

Node.jsが未インストールの場合は、Node.js LTS をインストールしてください。
pnpmが未インストールの場合は pnpm -v で確認し、未導入なら npm install -g pnpm もしくは pnpm インストールページから導入してください。

4. Python の確認（api用）¶

python --version

バージョンは 3.12 の使用を推奨します。（他のバージョンでも動作する可能性はありますが、本プロジェクトでの動作確認は行っていません）
未インストールの場合は、Python公式サイトよりインストールしてください。

5. public-viewer 側ライブラリのインストール¶

cd apps/public-viewer
pnpm install
cd ..

6. admin 側ライブラリのインストール¶

cd apps/admin
pnpm install
cd ..

7. api 側ライブラリのインストール（PDM + 仮想環境）¶

cd apps/api
pip install pdm
pdm install
cd ..

8. direct_start_win.bat を実行¶

Windows用のバッチスクリプト direct_start_win.bat をkouchou-ai配下にコピーしダブルクリックまたはコマンドラインで実行

copy experiments\direct_win\direct_start_win.bat .\
direct_start_win.bat

9. アクセス確認¶

http://localhost:3000 : レポート一覧画面（public-viewer）
http://localhost:4000 : 管理画面（admin）

⚠️ 注意：この構成は動作確認・検証用であり、Dockerを用いた本番環境構築を推奨します。