Kawaii Agent マニュアル

目次

各セクションをクリックすると、ページ内の詳細なマニュアルにジャンプします。

はじめに

基本的な使い方

主要機能

設定

トラブルシューティング

FAQ

クイックスタート（5分で始める）

ステップ1: ダウンロード（1分）

GitHub Releases または BOOTH からダウンロード

ステップ2: インストール（1分）

Windows: ダウンロードした .exe ファイルをダブルクリックしてインストール

macOS: .dmg ファイルをダブルクリックし、アプリをアプリケーションフォルダにドラッグ

ステップ3: 基本的な使い方

モデルの読み込み

対応モデル形式

読み込み方法

  1. 画面下部の「モデルファイル選択」ボタンをクリック
  2. モーダルが開くので「ローカルファイル」を選択
  3. VRMまたはPMX/PMDファイルを選択
  4. 自動的にモデルタイプを判定して読み込みます

VRoid Hubから選ぶ

  1. 画面下部の「モデルファイル選択」ボタンをクリック
  2. 「VRoid Hub」を選択
  3. 気に入ったモデルをクリック

※ VRoid Hub連携は現在審査中です

音声設定

Kawaii Agentは、VOICEVOX統合により33キャラクター・77種類の音声を使用できます。さらに、TTS Modにより独自の音声エンジンを追加することも可能です。

音声設定・TTS Mod画面

音声設定・TTS Mod画面

VOICEVOX音声設定

33キャラクター・77種類の音声から選択できます。

各キャラクターには複数のスタイル（ノーマル、あまあま、ツンツン等）があります。

設定方法
  1. 画面右上の 設定ボタンをクリック
  2. 「TTSエンジン」セクションを表示
  3. 「音声キャラクター」ドロップダウンから選択
  4. または、検索欄でキャラクター名を検索
人気の音声キャラクター

声質調整

声質調整ボタンをクリックすると、以下の設定が可能です：

話速（スピード） 0.5〜2.0（デフォルト: 1.0）
音高（ピッチ） -0.15〜0.15（デフォルト: 0.0）
抑揚（イントネーション） 0.0〜2.0（デフォルト: 2.0）

TTS Mod

独自の音声エンジンを追加できる機能です。

TTS Mod管理
  1. 設定パネルの TTS Mod 管理ボタンをクリック
  2. 「Mod (.zip) をインポート」ボタンをクリック
  3. zipファイルを選択してインポート

詳しくは TTS Mod セクションをご覧ください。

相槌フレーズ

AI応答前の待ち時間短縮のため、相槌を再生します。

デフォルト: なるほど、えーっとね、んーと、そうだね、ふむふむ

設定パネルの「相槌フレーズ」入力欄でカスタマイズ可能（スペース区切り）

常駐モード

常駐モードは、Kawaii Agentを画面上に常駐させる小窓モードです。他のアプリを使用しながら、キャラクターと会話できます。

起動方法

  1. 画面右上の 常駐モードボタン（ピン留めアイコン）をクリック
  2. キャラクターが小窓になります

または、ショートカットキー 3（デフォルト）でON/OFF

常駐モード時のボタン

ウェイクワード機能との連携

常駐モードでは、ウェイクワード機能が非常に便利です。

  1. ボイスプリント（声紋認証）を登録
  2. ウェイクワードを設定（例: 「ねえアリシア」）
  3. キャラクターに向かって「ねえアリシア」と呼びかける
  4. キャラクターが「はーい」と返答し、連続会話モードに入る
  5. そのまま会話を続ける

完全ハンズフリーで会話できます！

UIガイド - 各ボタンとアイコンの説明

Kawaii AgentのUIは、Font Awesomeアイコンで統一されています。

Kawaii Agent UI全体像

※ 右の画像を参考にしながら説明をお読みください

画面上部 - ヘッダーエリア

左側:

右側:

画面下部 - コントロールエリア

モデル選択エリア:

チャットエリア:

カメラ・インタラクション設定

詳細設定

ショートカットキー（カスタマイズ可能）

1 設定パネルを開く
2 コントロールパネルを開く
3 常駐モードON/OFF
Q お触りモードON/OFF
W カメラ自動追従ON/OFF

注意: 入力フィールドにフォーカスがある場合は無効です。
左手で操作しやすいように1,2,3,Q,Wがデフォルトに設定されています。

キーバインドのカスタマイズ方法

  1. 画面右上の 設定ボタンをクリック
  2. 下にスクロールして キーボードショートカット設定ボタンをクリック
  3. 各機能の入力欄に、割り当てたいキー（1文字）を入力
  4. 自動的に保存されます

ヒント: ゲーム配信中など、片手で操作したい場合に便利です。

リアルタイム表情変化（AI表情制御）

Kawaii Agentの最大の特徴の一つが、AIが会話内容に応じて適切な表情モーフをリアルタイムで選択し、表情を制御する高度な表情操作機能です。

⚡ 技術的優位性

単純な感情判定ではなく、GPT-4.1 miniがモデルの利用可能な表情モーフリストから、会話内容に最適なモーフを選択します。

従来: happy/sad/angryなど固定の感情に分類
Kawaii Agent: モデル固有の全表情モーフ（笑い、困る、ウィンク、照れ等）から最適なものをAIが選択

これにより、モデルごとに異なる表情モーフに柔軟に対応し、より豊かで自然な表情変化を実現しています。

照れの表情

照れの表情 - 頬を赤らめて目を細めている

怒りの表情

怒りの表情 - 眉を下げて少し怒った顔

高度な処理の流れ

  1. モデル読み込み時に利用可能な全表情モーフを取得
  2. ユーザーが話しかける
  3. AIが返答を生成
  4. GPT-4.1 miniに利用可能な表情モーフリストと会話内容を送信
  5. GPT-4.1 miniが最適な表情モーフを選択（例: 楽しい会話→「笑い」を選択）
  6. 選択された表情モーフを適用（リアルタイムでアニメーション）

AIが選択する表情の例

「ありがとう！嬉しいな」 → 「笑い」または「joy」を選択
「えっと...困ったな」 → 「困る」または「sorrow」を選択
「なんでそんなこと言うの！」 → 「怒り」または「angry」を選択
「え、えへへ...」 → 「照れ」または「relaxed」を選択
「え！？本当に！？」 → 「驚き」または「surprised」を選択

自動的に動作します

モデルごとの対応

VRMモデル:

MMDモデル:

画期的な理由

VMDモーションインポート

⚡ 技術的優位性

多くのデスクトップマスコットアプリが「技術的に難しい」として実装を断念したVMDモーションの自由なインポート機能を、Kawaii Agentは実現しています。

モーションインポート画面

モーション選択・インポート画面

対応フォーマット

収録モーション: 64種類のVRMAアニメーション + 4種類のMMDモーション

インポート方法

  1. 画面下部のモーション選択エリアを開く
  2. 「モーションをインポート」ボタンをクリック
  3. VMDファイルを選択
  4. 自動的にカテゴリが判定され追加されます

推奨VMDモーション（外部）

音街ウナモーション: https://otomachiuna.jp/

アイドルモーション、ダンス、ポーズなど豊富なVMDモーションが配布されています（要ダウンロード）

TTS Mod（カスタム音声）

コミュニティが制作したカスタム音声を追加できます。

インストール方法

  1. 設定パネルを開く
  2. 「音声合成」タブを選択
  3. 「TTSモッドをインポート」ボタンをクリック
  4. ZIPファイルを選択

将来の展望

声優やVTuberとの正式契約により、公式TTSを提供予定です。

ボイスプリント（声紋認証）

ボイスプリント機能は、あなたの声のみをウェイクワードに反応させることができるセキュリティ機能です。

なぜ必要なのか？

ウェイクワード機能を使う場合、通常は誰の声でも反応してしまいます。しかし、ボイスプリント（声紋認証）を設定すると：

声紋の登録方法

  1. 画面右上の 設定ボタン（歯車アイコン）をクリック
  2. 下にスクロールして「声紋認証設定」セクションを表示
  3. 「音声を登録」ボタンをクリック
  4. モーダルが開き、登録手順が表示されます
  5. 「開始」をクリック
  6. 5秒間、好きな言葉を話す（例: 「こんにちは、私の声を登録します」）
  7. 自動的に録音が終了し、次のステップへ進みます
  8. これを3回繰り返します

重要: 毎回異なる言葉を話してください。同じ言葉を繰り返すと、精度が下がる可能性があります。

推奨サンプル数

技術的な仕組み

音声から17次元の特徴量（MFCC、ZCR、スペクトル重心等）を抽出し、コサイン類似度で比較します。

判定基準: 平均類似度92%以上、かつ最小類似度80%以上で本人と判定

ウェイクワード検出

Kawaii Agentは、任意の言葉をウェイクワードとして設定し、ハンズフリーで連続会話モードを開始できます。

⚠️ 重要: ボイスプリント（声紋認証）が必要

ウェイクワード機能を使うには、ボイスプリント（声紋認証）の登録が必須です。

ウェイクワード設定・声紋認証設定画面

ウェイクワード設定・声紋認証設定画面

ウェイクワードの設定方法

  1. 画面右上の 設定ボタンをクリック
  2. 下にスクロールして「ウェイクワード設定」セクションを表示
  3. 「起動ワード」入力欄に、好きな言葉を入力
    • 例: ねえアリシア アリシア ヘイアリシア
    • 複数設定する場合は、スペース区切りで入力
  4. 入力欄からフォーカスを外すと、自動的に保存されます

使い方

  1. ボイスプリントを3回以上登録
  2. ウェイクワードを設定（例: 「ねえアリシア」）
  3. 設定したウェイクワードを言う
  4. キャラクターが「はーい」と返答（ランダムな応答）
  5. 連続会話モードに自動的に入ります
  6. そのまま会話を続けることができます
  7. 終了ワードを言う（例: 「おっけー」）か、マイクボタンをクリックして終了

連続会話モードの例

あなた: ねえアリシア
アリシア: はーい
あなた: 今日の天気は？
アリシア: 東京の天気は晴れです。最高気温は25度です。
あなた: ありがとう、タイマー5分セットして
アリシア: 5分のタイマーをセットしました。
あなた: おっけー（終了ワード）
（連続会話モード終了）

技術的な詳細

音声認識エンジン:

キャラクタープロンプト設定

キャラクタープロンプト（システムプロンプト）を変更することで、キャラクターの性格や話し方を自由にカスタマイズできます。

キャラクタープロンプト設定画面

キャラクタープロンプト設定画面

設定方法

  1. 画面右上の 設定ボタンをクリック
  2. 「キャラクター設定」セクションを表示
  3. プリセットボタン（ずんだもん、四国めたん等）をクリック、またはテキストエリアに直接入力
  4. テキストエリアからフォーカスを外すと、自動的に保存されます

プリセットキャラクター

ずんだもん 一人称「ボク」、語尾「〜のだ」、明るく元気
四国めたん 一人称「わたくし」、ツンデレ、高飛車な口調
春日部つむぎ 一人称「あーし」、明るく人懐っこい埼玉ギャル
東北きりたん 一人称「私」、二人称「にいさま」、敬語
九州そら 明るく前向き、ポジティブ、励ましの口調
アリシア 14歳、真面目で優しい（デフォルト）

プロンプトの書き方のコツ

💡 ヒント: ユーザーの呼び名を指定すると、より親密な会話になります

「あなた」「きみ」「マスター」「にいさま」「太郎くん」など、キャラクターに合った呼び方を指定してください。

タップインタラクションプロンプト設定

お触りモードで、キャラクターの各部位をタップした時の反応をカスタマイズできます。

タップインタラクションプロンプト設定画面

タップインタラクションプロンプト設定画面

設定方法

  1. 画面右上の 設定ボタンをクリック
  2. 「タップインタラクションを有効にする」をON
  3. 「▶ プロンプト設定」ボタンをクリック
  4. 各部位のテキストエリアに任意のプロンプトを入力

設定可能な部位

スカート 驚いたり、恥ずかしがって反応
髪 嬉しそうに反応
頭 照れて嬉しそうに反応
肩・腕・手 嬉しそうに反応
胸・腰・太もも 恥ずかしがったり、少し怒ったり
撫でる（長押し） 嬉しそうに反応
その他 フォールバック

詳細設定

モデルの表示サイズ、明るさ、自動話しかけなど、多数の詳細設定があります。

自動話しかけ設定画面

自動話しかけ設定画面

モデル表示設定

物理演算設定

自動話しかけ機能

2分間放置すると自動的に話しかけます。

その他の設定

よくある問題と解決方法

Q: モデルが表示されない

解決方法:

  1. 「モデル再読み込み」ボタンを押す（最も効果的）
  2. ファイル形式を確認（VRM, PMX, PMD のみ対応）
  3. 別のモデルで試す

Q: AI会話ができない

解決方法:

  1. ライセンスキーが正しく入力されているか確認
  2. インターネット接続を確認
  3. アプリを再起動

Q: 音声が出ない

解決方法:

  1. VOICEVOXをインストール: https://voicevox.hiroshiba.jp/
  2. VOICEVOXを起動
  3. システムの音量設定を確認

よくある質問

Q: Kawaii Agentは無料ですか？

基本ソフトウェアは無料です。AI機能を使うには月額ライセンス（¥680〜）が必要です。

Q: 自分のVRM/MMDモデルを使えますか？

はい、使えます。VRM 0.x/1.0、PMX、PMDに対応しています。

Q: モーションを追加できますか？

はい、VMDモーションを自由に追加できます。これはKawaii Agentの強みです。

Q: トークン上限とは？

AI会話で使用できる月間トークン数の上限です。

サポート

質問やサポートが必要な場合は、以下の方法でお問い合わせください：