softjapan/polymind

PolyMind

OSS なマルチプロバイダー AI チャットクライアント — OpenAI / Gemini / Claude / Ollama を1つのRepositoryインターフェースで統一

Flutter Dart Riverpod LangChain License: MIT

📱 iOS 版が App Store で公開中です

無料でダウンロードいただけます。お好きなAIプロバイダーのAPIキーを入力するだけで、すぐにお使いいただけます。詳しくは紹介ページもご覧ください。

概要

Flutter × Riverpod × LangChain Dart で構築した、OSSのマルチプロバイダー AI チャットクライアントです。

OpenAI・Google Gemini・Anthropic Claude・Ollama（ローカル LLM）を LlmRepository という単一の抽象インターフェースの背後に実装として隠蔽しており、アプリ側のロジックは接続先プロバイダーの違いを一切意識しません。設定画面からプロバイダー・モデル・エンドポイントをいつでも切り替え可能です。

APIキーは flutter_secure_storage（iOS/macOS: Keychain、Android: EncryptedSharedPreferences）にのみ保存され、開発者のサーバーは存在しません。チャット履歴は端末内の SQLite に永続化され、外部に送信されることはありません。

デモ動画

https://github.com/user-attachments/assets/99b1e415-f99c-4001-9774-9311fdbc877a

スクリーンショット

プリインストール済みのAIエージェント一覧エージェントを使ったチャットコードのシンタックスハイライトダークモード

主な機能

機能	説明
マルチ LLM 対応	OpenAI / Gemini / Claude / Ollama（ローカル LLM）を設定画面から切り替え
リアルタイム・ストリーミング	LangChain の各 Chat モデルでトークン単位のストリーム描画。生成中はいつでも即座に中断可能
画像入力（Vision）	写真を添付してAIに質問可能。マルチモーダルコンテンツとしてプロバイダーへ送信
画像生成	`/image <prompt>` コマンドで OpenAI 画像生成 API を呼び出し、チャット内にサムネイル表示
フルスクリーン画像ビューア	ピンチズーム対応のプレビュー、ローカルへのダウンロード機能
チャット履歴の永続化	SQLite で会話・メッセージを保存、サイドドロワーから一覧・検索・リネーム・削除
応答の再生成・編集	直近の応答を再生成、送信済みメッセージの編集・削除に対応
セキュアな設定管理	API キーを `flutter_secure_storage` で暗号化保存（`.env` 不要）
シンタックスハイライト	AI 応答内のコードブロックを、ライト/ダーク双方に最適化した配色で自動カラーリング
Markdown レンダリング	`flutter_markdown` による見出し・リスト・コード・リンク等の表示
ダークモード	`ThemeExtension` ベースのカラーシステムでライト/ダークをシームレスに切り替え
クロスプラットフォーム	iOS / Android / macOS / Web に対応する単一コードベース

アーキテクチャ

lib/
├── main.dart                          # エントリポイント + UI ルート
├── constants.dart                     # ThemeExtension<AppColors>（ライト/ダーク配色）
├── model/
│   ├── chat_message.dart              # 不変メッセージモデル
│   ├── chatmodel.dart                 # ChangeNotifier（状態管理・生成ライフサイクル）
│   └── provider_config.dart           # LLM プロバイダー設定モデル
├── repository/
│   ├── llm_repository.dart            # LLM 抽象インターフェース（stream/generate/generateImage/listModels）
│   ├── openai_repository.dart         # OpenAI 実装（LangChain）
│   ├── ollama_repository.dart         # Ollama 実装（LangChain）
│   ├── gemini_repository.dart         # Gemini 実装（LangChain）
│   ├── claude_repository.dart         # Claude 実装（LangChain）
│   ├── secure_settings.dart           # flutter_secure_storage ラッパー
│   └── chat_database.dart             # SQLite チャット履歴（スキーママイグレーション対応）
└── widgets/
    ├── ai_message.dart                # AI バブル（Markdown + 画像 + アクション）
    ├── user_message.dart              # ユーザーバブル
    ├── user_input.dart                # 入力フィールド（画像添付・送信/停止トグル）
    ├── loading.dart                   # ローディングアニメーション
    ├── code_block.dart                # シンタックスハイライター（ライト/ダーク対応）
    ├── settings_screen.dart           # プロバイダー設定画面
    └── conversation_drawer.dart       # 会話一覧ドロワー（検索・リネーム）

レイヤー	役割
Presentation	Flutter Widgets + Material 3 + Markdown 表示。色は `context.colors` 経由で `ThemeExtension` から取得し、ハードコードしない
State	Riverpod（`ChangeNotifierProvider`）+ `ChatModel` によるメッセージ・設定・生成状態の一元管理
Repository	`LlmRepository` を実装する4つのプロバイダークラス、LangChain経由のLLM通信、SQLite永続化、セキュア設定

設計上のポイント

プロバイダー抽象化 — 新しいLLMプロバイダーの追加は「LlmProvider enumへの追加 → LlmRepository 実装クラスの追加 → ChatModel._buildRepository() のswitchに1行追加」のみで完結する設計。UI・状態管理層はプロバイダーの違いを意識しない。
信頼性の高い生成中断 — 応答停止 (stopGenerating()) は真偽値フラグのポーリングではなく、アクティブな StreamSubscription を直接キャンセルし、識別トークン (_generationToken) を無効化する方式を採用。フラグ方式はストリームのチャンク間でしかチェックされずスタックした接続を中断できないため、この設計により低速・停止気味の接続でも確実に中断できる。
block-native LangChain API — langchain_core 0.5系の破壊的変更（メッセージ内容が String から content block の List に変更）に対応し、chunk.output.contentAsString / ChatMessage.aiText() を使用。
無駄のない永続化 — 会話は「New Chat」タップ時点ではなく、最初のメッセージが送信された時点でのみ SQLite に挿入される。未使用の空チャットが履歴に残らない。

技術スタック

カテゴリ	パッケージ	用途
状態管理	`flutter_riverpod`	`ChangeNotifierProvider` によるアプリ全体の状態管理
LLM 連携	`langchain`, `langchain_openai`, `langchain_ollama`, `langchain_google`, `langchain_anthropic`	block-native API（v0.9系）でのストリーミング・マルチモーダル対応
UI / Markdown	`flutter_markdown`, `cached_network_image`	Markdownレンダリング、画像のキャッシュ・遅延ロード
シンタックスハイライト	`highlight`	コードブロックのライト/ダーク両対応トークンカラーリング
ストレージ	`sqflite`, `flutter_secure_storage`, `path_provider`	会話履歴のSQLite永続化、APIキーの暗号化保存
画像入力	`image_picker`	Vision入力用の画像選択・Base64エンコード
ネットワーク	`http`	プロバイダーAPIとの直接通信
ID生成	`uuid`	会話・メッセージの一意識別子

セットアップ

前提条件

Flutter 3.32 以上（Dart SDK 3.8.0 以上を同梱）— flutter --version で確認
（Ollama 使用時）Ollama がローカルで起動していること

インストール

git clone https://github.com/softjapan/polymind.git
cd polymind
flutter pub get
flutter run

初回設定

.env ファイルは不要です。アプリ起動後、設定画面からプロバイダーを選択してください。

項目	OpenAI	Gemini	Claude	Ollama
Endpoint	`https://api.openai.com/v1`	`https://generativelanguage.googleapis.com`	`https://api.anthropic.com`	`http://localhost:11434`
Model	`gpt-4o-mini-2024-07-18` 等	`gemini-2.5-flash` 等	`claude-sonnet-4-5` 等	`llama3.2` 等
Image Model	`gpt-image-1`（任意）	—	—	—
API Key	必須	必須	必須	不要

使い方

通常のメッセージを送信すると、AI の応答が Markdown としてリアルタイム描画されます
/image <プロンプト> または /img <プロンプト> で画像を生成（OpenAI のみ）
生成された画像はタップで全画面表示 → ピンチズーム → ダウンロード
サイドドロワーから過去の会話を検索・切り替え・リネーム・削除
送信済みメッセージの編集・応答の再生成にも対応
設定画面から LLM プロバイダーをいつでも変更可能

開発コマンド

用途	コマンド
依存関係の取得	`flutter pub get`
アプリ起動	`flutter run`
単一テストの実行	`flutter test test/widget_test.dart`
テスト全体の実行	`flutter test`
静的解析	`flutter analyze`
ビルド	`flutter build ios\|apk\|macos\|web`

コントリビューション

リポジトリを Fork
ブランチを作成: git checkout -b feature/awesome-feature
コミット: git commit -m "Add awesome feature"
Push & Pull Request: git push origin feature/awesome-feature

ライセンス

MIT License

Author

Twitter: システムエンジニア@JP
GitHub: softjapan/polymind