🤖 AIキャラクターをすぐ試せる開発フレームワーク 音声＋Live2D / VTube Studio対応 👉 ダブルクリックだけで、AIキャラ開発フレームワークの基本動作を確認できます。 会話・音声・感情フロー・VTube Studio連携に加えて、外部アプリ連携向けの public API / SDK基盤も含む ready-to-run パッケージです。 v4.0.0では App Integration SDK Foundation として、外部アプリから使いやすい public API、app-safe な session metadata、限定的な interrupt boundary、app-facing event callbacks、SDK examples を追加・整理しました。 本商品は完成済みアプリではなく、AIキャラクターアプリや実験用ツールを作るための開発者向けフレームワークです。 --- 💡 このツールについて すぐに動作確認しやすいように構成された、AIキャラクター開発用のフレームワークです。 こんな用途に向いています。 ・AIキャラクター開発の土台を探している ・音声会話やLive2D連携をすぐ試したい ・自分用のAIキャラアプリを作りたい ・外部アプリからAIキャラ会話機能を使いたい ・preset / character / plugin ベースで拡張したい ・TTS / STT / LLM / VTS の流れをまとめて確認したい --- 🎮 できること ・AIキャラクターとの会話テスト ・音声入力 / 音声出力のテスト ・VTube Studio / Live2D 連携 ・感情タグ付き応答フロー ・characterごとの表情マッピング ・runtime conversation state の確認 ・TTS向けの読み上げやすい応答方針 ・public text chat facade による外部アプリ連携 ・app-safe session metadata の確認 ・app-facing event callbacks の確認 ・限定的な public interrupt boundary の確認 --- ⚠️ Live2D / VTube Studio連携について 現行版では以下に対応しています。 ・VTube Studioへの接続 ・presetによる ON / OFF 切替 ・感情タグの解析 ・characterごとの VTS hotkey mapping ・plugin 経由での表情切り替え VTube Studioが起動していない場合や、hotkey が未設定の場合でも、会話自体はそのまま継続されます。 --- 🚀 使い方 1. ダウンロードしてZIPを解凍 2. install.bat をダブルクリック（初回のみ） 3. .env に API キーを設定 4. run.bat をダブルクリック または scripts/run_*.bat を使って起動できます。 例： scripts/run_text_chat.bat scripts/run_text_vts.bat scripts/run_voice_vts.bat --- 💡 起動モード ・text_chat テキスト入力 / テキスト出力の安全な開発用モード ・text_vts テキスト入力 / テキスト出力 + VTube Studio連携 ・voice_vts 音声入力 + テキスト表示 + 音声出力 + VTube Studio連携の開発確認用モード ・bilingual_ja_en 日本語入力 + 英語出力 まずは text_chat から始めて、必要に応じて音声・VTS連携へ進める使い方がおすすめです。 --- 🔑 APIキーについて 本ツールは外部AIサービスを利用します。 APIキーは付属しません。 ご自身のAPIキーを使用してください。 対応構成例： ・Google Gemini ・OpenAI ・xAI / Grok ・ElevenLabs TTS API利用料金は自己負担です。 TTS機能を使う場合は、TTS provider 側のAPIキーや音声設定が必要です。 --- 🎙️ Voice Mode Notes voice_vts モードでは、STTで音声入力、TTSで音声出力を行います。 音声入力が検出されない場合、text fallback を使えます。 text fallback で exit または quit と入力すると通常終了できます。 強制終了したい場合は Ctrl+C を使えます。 v4.0.0 では、外部アプリ連携向けに限定的な public interrupt boundary を追加しています。 ただし、完全な同時音声割り込み会話機能ではありません。 provider-level の LLM hard cancellation、TTS queue cancellation、常時マイク入力による本格的な barge-in は今後の runtime 改善範囲です。 --- 🧩 App Integration SDK Foundation v4.0.0では、外部アプリからフレームワークを使いやすくするためのSDK基盤を強化しました。 外部アプリ側は、内部の runtime / provider / STT / TTS / VTS 実装へ直接依存せず、public な framework API から text chat session を扱えます。 現在の app-facing text session API 例： session.ask(text) session.ask_stream(text) session.reset() session.interrupt() session.on_event(callback) session.on_state_change(callback) session.info では、外部アプリ向けに安全な metadata / capability flags を確認できます。 例： api_version session_type supports_streaming supports_reset supports_interrupt supports_events supports_voice_input supports_voice_output supports_live2d 追加されたSDK向けexample： examples/app_session_info.py examples/app_state_events.py examples/app_interrupt_text_chat.py examples/app_streaming_text_chat.py examples/app_reset_text_chat.py --- 👤 こんな人におすすめ ・AIキャラクターアプリを開発したい人 ・VTuber / Live2D制作とAI連携を試したい人 ・音声 × 会話 × 表情制御の流れを試したい人 ・面倒な初期構築を減らしたい人 ・自分用のAIキャラ基盤を作りたい人 ・外部アプリからAIキャラ会話機能を使いたい人 --- 🎯 現行版でできること ・RuntimeConfig ベースの設定管理 ・presetによる起動モード切替 ・characterごとの profile / system prompt 対応 ・入力言語 / 出力言語の分離 ・STT / TTS を使った音声入出力の基本対応 ・感情タグの解析 ・characterごとの VTS hotkey mapping ・pluginベースの感情 / VTS連携 ・runtime conversation state tracking ・plugin向け state change event ・voice-friendly output policy ・public text chat facade による外部アプリ連携 ・app-safe TextChatSessionInfo metadata ・限定的な session.interrupt() boundary ・app-facing event callbacks ・SDK examples ・app SDK smoke checks ・モジュール型の拡張しやすい構成 --- 🔗 GitHub（オープンソース版） https://github.com/murayan1982/ai-character-framework 違い： ・GitHub版：オープンソースのベースフレームワーク ・本商品：すぐ試しやすい ready-to-run パッケージ版 --- 📜 利用について（ライセンス） 商用利用可能です。 許可されていること： ・本フレームワークを使ったアプリ・サービスの開発 ・より大きなアプリやサービスの一部として利用すること ・AIキャラクター作品・配信・コンテンツ制作への利用 ・本フレームワーク上で動く plugin / character / preset / add-on 等の販売 ※ただし、フレームワーク本体を再配布しない場合に限ります 禁止されていること： ・本フレームワーク自体の再配布・再販売 ・テンプレート、SDK、スターターキット、boilerplate、競合フレームワークとしての再販売 ・軽微改変版・再パッケージ版・実質的に類似した版の再配布・再販売 詳細は同梱の LICENSE.txt をご確認ください。 --- ⚠️ 注意事項 ・APIキーは付属しません ・Live2Dモデルは付属しません ・各APIの利用料金は自己負担です ・VTube Studio連携を使う場合は、VTube Studio側の起動と設定が必要です ・本商品は完成済みアプリではなく、開発者向けフレームワークです --- 💡 サポートについて このプロジェクトが役に立ったら、応援してもらえると開発継続の助けになります。 👉 ダブルクリックで、すぐに基本動作を確認できます。 👉 ready-to-run な土台から、自分向けに拡張していけます。