広聴AI / kouchou-ai¶
デジタル民主主義 2030 プロジェクトにおいて、ブロードリスニングを実現するためのソフトウェア「広聴 AI」のドキュメントサイトです。
このプロジェクトは、AI Objectives Institute が開発した Talk to the Cityを参考に、日本の自治体や政治家の実務に合わせた機能改善を進めています。
主な機能¶
- CSV アップロード: 開発者以外でも扱いやすいインターフェース
- 濃いクラスタ抽出: 重要な意見グループの自動識別
- 階層的クラスタリング: 大量のコメントを構造的に整理
- パブリックコメント用分析機能（予定）
- 多数派攻撃に対する防御機能（予定）
クイックスタート¶
一般ユーザー向け¶
お使いの OS に合わせたセットアップガイドをご覧ください：
-
:fontawesome-brands-windows: Windows
-
:fontawesome-brands-apple: macOS
-
:fontawesome-brands-linux: Linux
開発者向け¶
# リポジトリをクローン
git clone https://github.com/digitaldemocracy2030/kouchou-ai.git
cd kouchou-ai
# 環境設定
cp .env.example .env
# .env ファイルを編集して API キーなどを設定
# 起動
docker compose up
- レポート一覧: http://localhost:3000
- 管理画面: http://localhost:4000
- API: http://localhost:8000
アーキテクチャ¶
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ public-viewer │ │ admin │ │ api │
│ (Port 3000) │ │ (Port 4000) │ │ (Port 8000) │
│ │ │ │ │ │
│ レポート閲覧 │ │ レポート作成 │────▶│ バックエンド │
│ データ可視化 │────▶│ 設定管理 │ │ パイプライン │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
└───────────────────────┴───────────────────────┘
│
┌───────────▼───────────┐
│ OpenAI API / │
│ Local LLM │
└───────────────────────┘
| サービス | ポート | 役割 |
|---|---|---|
| public-viewer | 3000 | レポート表示用フロントエンド |
| admin | 4000 | 管理用フロントエンド |
| api | 8000 | バックエンド API サービス |
| ollama | 11434 | ローカル LLM（オプション） |
ドキュメント構成¶
- はじめに: セットアップと基本的な使い方
- ユーザーガイド: 詳細な操作方法
- 開発者向け: コントリビューション方法、プラグイン開発
- デプロイ: Azure、GitHub Pages へのデプロイ方法
- 技術解説資料: プロジェクトの技術的背景と設計思想（外部リンク）
免責事項¶
大規模言語モデル（LLM）にはバイアスがあり、信頼性の低い結果を生成することが知られています。私たちはこれらの問題を軽減する方法に積極的に取り組んでいますが、現段階ではいかなる保証も提供することはできません。特に重要な決定を下す際は、本アプリの出力結果のみに依存せず、必ず内容を検証してください。
クレジット¶
このプロジェクトは、AI Objectives Institute が開発した Talk to the Cityを参考に開発されており、ライセンスに基づいてソースコードを一部活用し、機能追加や改善を実施しています。ここに原作者の貢献に感謝の意を表します。