Kawaii Agent V2 マニュアル

目次

はじめに

セットアップ (詳細)

基本操作

主要機能

詳細設定

高度な連携

サポート

Kawaii Agent V2 とは

Kawaii Agent V2 は、あなたの PC のデスクトップに 3D キャラクター (VRM / MMD) が現れ、ローカル LLM (LM Studio や Ollama) を頭脳としてリアルタイムに会話・表情変化・モーション再生を行う、買い切りのデスクトップ AI コンパニオンです。

主な特徴

用意するもの: Kawaii Agent ライセンス (BOOTH または synaptic-ai.net で購入) / LM Studio (無料) / macOS 12 以上 or Windows 10 以上 / RAM 16GB 以上推奨

起動までの流れ (5 分)

初めての方はこの順に進めれば動くところまで行けます。各ステップの詳細は下のセクションにリンクしています。

ステップ 1: Kawaii Agent の入手

ステップ 2: インストール

ステップ 3: ライセンス認証

初回起動時にライセンスキー入力画面が表示されます。ステップ 1 で届いたキー (BOOTH DM または メール) を入力し、「ライセンスを認証」を押してください。認証には初回のみインターネット接続が必要です。

すぐ試したい方は「3 日間無料で試す」でトライアル開始も可能です (クレジットカード不要)。

ステップ 4: LM Studio を準備

  1. lmstudio.ai から LM Studio (無料) をダウンロード・インストール
  2. LM Studio でモデルをダウンロード (推奨: Qwen 3.5 9B / Gemma 4 26B-A4B など、PC の VRAM に合わせる)
  3. モデルを Load してから Local Server を起動

▶ LM Studio セットアップの詳細手順

ステップ 5: Kawaii Agent 側で AI を起動

  1. Kawaii Agent を起動 (アリシアが標準で表示されます)
  2. 設定画面 (キーボード 1) → 「AI」タブ
  3. プロバイダー選択で LM Studio を選ぶ (通常は自動検出)
  4. 「AI を起動」 ボタンを押す

ステップ 6: 会話開始

下部の入力欄にメッセージを入力して Enter、またはマイクボタンで音声会話。「ねえアリシア」などのウェイクワードを話しかけて連続会話モードも使えます。

Kawaii Agent V2 UI

ステップ 7 (任意): Synaptic Code 連携 — 高度機能を追加

Kawaii Agent + Synaptic Code セットを購入された方、または ファイル操作 / bash / Web 検索 / Unity・Blender ブリッジ をキャラ経由で使いたい方向けの追加ステップです。単体で会話するだけなら不要 (スキップ可)。
  1. Synaptic Code を入手 — BOOTH または synaptic-ai.net から ZIP DL、解凍
    ライセンスキーは Kawaii と別に届きます。 Kawaii = KAW1-XXXX-XXXX-XXXX、Synaptic Code = SYN1-XXXX-XXXX-XXXX。BOOTH DM or メール本文で 2 つ届くので取り違え注意。
  2. インストーラ実行 — macOS: install-mac.command / Windows: install-win.bat を 管理者として実行
  3. 確認 — 新しいターミナル / PowerShell で synaptic --version がバージョン表示すれば OK (PATH キャッシュ回避のため必ず新規タブで)
  4. 初回起動 & ライセンス認証 — ターミナルで synaptic を実行:
    • 「⚠ ライセンス無効」表示の後 [Y/t/b/n] プロンプトが出る
    • Enter (または y) → License key: の後に SYN1-XXXX-XXXX-XXXX を入力
    • ✓ Activated と出れば認証成功
    • とりあえず試すだけなら t で 3 日間無料トライアル 開始 (登録不要)
  5. Kawaii 側で連携 — 設定画面 → 「連携」タブ →「Synaptic Code 連携」の 「Synaptic Code を検出」 ボタン → 「Synaptic Code 連携中 ✓」表示になれば完了
  6. これでチャット越しに Synaptic Code のツール群 (ファイル操作 / Web / Unity / Blender 等) が使えるようになります

▶ Synaptic Code 連携の詳細・トラブルシューティング

ここまでで詰まったら Synaptic Discord サーバー で質問してください。サポート Bot が 24 時間即答、開発者もエスカレーションで直接対応します。

Kawaii Agent のインストール

macOS

Windows

Windows 11 の Smart App Control (SAC) 対応: 買ってすぐの新規 Win11 PC ではインストールがブロックされることがあります (SmartScreen とは別レイヤー、アプリ単体の Unblock 不可)。
  • 2026 年 4 月以降 (KB5083769+): 設定 → プライバシーとセキュリティ → Windows セキュリティ → アプリとブラウザーコントロール → スマート アプリ コントロールの設定 → 一時的にオフ → インストール → オンに戻す
  • それ以前のビルド: 一度オフにすると再有効化に Windows 再インストールが必要 (超破壊的なので推奨せず、Discord サポートに相談してください)
アップデートについて: Kawaii Agent には自動更新はありません。新版が出たら BOOTH または synaptic-ai.net から再ダウンロード → 上書きインストールしてください。

推奨スペック

インストールで詰まったら Synaptic Discord サーバー へ。Bot が 24 時間対応します。
モデルのロード失敗、Server 起動しない等は Discord へ。Bot が VRAM 別モデル推奨や設定リセット手順を即答します。

3D モデルの読み込み

対応形式

PMX / PMD は必ず ZIP にまとめてください。 PMX 本体だけを選んでも動きますが、テクスチャファイル (.tga, .png, .spa, .sph 等) がロードされず、モデルが真っ白 or 崩れて表示されます。

正しい手順: .pmx + .tga 群 + 参照 .pmx や .vmd があれば全部まとめて 1 つの ZIP に圧縮 → その ZIP を選択。ZIP 内の相対パスから Kawaii Agent が自動でテクスチャを紐付けます。

読み込み方法

  1. フッターの「モデルファイル選択」ボタンをクリック
  2. 「モデル読み込み」モーダルで ローカルファイル を選択
  3. VRM 単体 or ZIP (PMX の場合) を選ぶ
  4. 自動的にモデルタイプを判定して読み込みます

VRoid Hub 連携

「モデル読み込み」モーダルの VRoid Hub ボタンから、VRoid Hub 上のキャラクターを直接読み込めます (ダウンロード許可されたモデルのみ)。

同梱モデル

デフォルトで アリシア・ソリッド (ニコニ立体ちゃん) が同梱されています。何もインポートしなくてもすぐ会話開始できます。

モデルが真っ白 / 崩れる / 表示されない等は Discord で ZIP 構造チェックしてもらえます。Bot 24 時間対応。

UI ガイド (アイコン一覧)

Kawaii Agent のウィンドウにあるアイコンボタン一覧です。ホバーで日本語のツールチップが出ます。

チャット

テキストチャット

記憶システム

会話の内容は自動的に記憶されます。長い会話は自動で要約され、次回起動時も覚えています。設定画面から会話履歴のクリアや全データリセットが可能です。

音声会話

操作

ローカル音声認識

ローカル Whisper を使用してオフラインで音声認識が可能です。初期セットアップ手順は ローカル音声認識セットアップ を参照。

ウェイクワード

設定画面の音声タブで起動ワードを設定できます (例: 「アリシア」「ねえアリシア」)。キャラクターの名前を呼ぶと連続会話モードが開始されます。

声紋認証 (オプション)

声紋を登録すると、周囲の音声 (YouTube 等) を無視して本人の声だけに反応します。登録しなくても音声認識は動作します。

マイクが認識されない / Whisper 初期化失敗などは Discord へ。Bot が OS 別の権限設定手順を案内します。

インタラクション (タップ・撫でる)

キーボード Q でお触りモードを切り替えます。

操作方法

部位 (頭・肩・腕・スカート等) と親密度に応じて反応が変わります。AI が状況に合わせた表情とセリフを自動生成します。各部位のプロンプトはカスタマイズ可能:

常駐モード

常駐モードへの入り方

通常モードのヘッダー右端にある ピンアイコン () をクリック、または キーボード 3 で切り替えます。もう一度押すと通常モードに戻ります。

常駐モード中の見た目と挙動

背景の Finder ウィンドウ / Dock は説明用の疑似デスクトップ。実際は自分のデスクトップの上にキャラだけが浮きます。

ショートカットキー

親密度システム

7 段階の親密度が、会話やスキンシップで自然に変化します。

7 段階

  1. 初対面 (0-25) - よそよそしく、距離感がある
  2. 顔見知り (25-40) - 少し打ち解けてきた
  3. 友達 (40-55) - 気軽に接する
  4. 仲良し (55-70) - 素の自分を見せる
  5. 親友 (70-82) - 何でも話せる
  6. 大切な人 (82-92) - 深い感情を見せる
  7. 運命の人 (92-100) - 全ての感情をさらけ出す

モード

AI が会話の流れから親密度の変化を自動判定します。キャラクターの個性 (口調・性格) は親密度に関わらず保たれます。

表情・モーション

リアルタイム表情変化

AI が会話やインタラクションの内容に合わせて、モデルの表情モーフをリアルタイムで選択します。喜び、照れ、怒り、驚きなど、モデルが持つ全ての表情に対応。

VMD モーション

AI が会話に合わせてモーションを自動選択します。VRM / MMD どちらのモデルでも同じ VMD モーションが再生されます (IK ソルバー搭載)。

同梱モーション

モーション: むつごろう様

照れの表情 怒りの表情

音声合成 (TTS)

VOICEVOX (推奨)

  1. VOICEVOX 公式サイトからダウンロード
  2. VOICEVOX を起動した状態で Kawaii Agent を使用
  3. 設定 → 音声タブでキャラクターを選択

30 種類以上のキャラクターボイスに対応しています。話速・音高・抑揚の調整も可能です。

TTS Mod

コミュニティ製のカスタム音声 Mod にも対応しています。導入方法は Discord サーバーで案内しています。

VOICEVOX が繋がらない / TTS Mod 導入したい等は Discord へ。Bot 24 時間対応 + Mod カタログ案内。

モーションインポート

好きな VMD モーションを自由にインポートできます。

インポート方法

  1. モーション選択ボタン ( アイコン) をクリック
  2. 「インポート」ボタンから VMD または ZIP ファイルを選択
  3. ループ設定を選んで再生

インポートしたモーションは VRM / MMD 両方で再生されます。IndexedDB に保存されるため、再起動後も保持されます。

推奨モーション

音街ウナ公式モーション (商用利用可能) - インポート時に自動でカテゴリ振り分けされます。

着せ替え

VRM / MMD モデルを自由に切り替えられます。

AI プロバイダー設定

設定画面 (1) は 4 タブに分かれています。AI プロバイダーは「AI」タブで設定します。

ローカル AI (推奨)

クラウド / CLI AI

推奨モデル

Provider 選択 / API キー / モデル切替で詰まったら Discord へ。Bot が PC スペック別の最適設定を提案。

キャラクタープリセット

設定画面のプロンプト欄でキャラクターの性格や話し方をカスタマイズできます。

組み込みプリセット (7 種)

カスタムプリセットを名前付きで保存・読み込みすることもできます。

ローカル音声認識セットアップ

必要なもの

セットアップ手順

  1. 設定 → 音声タブ → 「セットアップ / 状態確認」ボタンをクリック
  2. PC のスペックに合ったモデルが自動選択されます
  3. 未インストールの場合、自動でインストールが開始されます

macOS: lightning-whisper-mlx / Windows: faster-whisper を使用。
LM Studio で使用中のモデルを自動検出し、残り RAM から最適な音声認識モデルを選択します。

Synaptic Code の検出失敗 / Unity・Blender ブリッジが動かない等は Discord へ。連携専門の技術サポートが即応。

トラブルシューティング

Windows 11 でインストーラーがブロックされる (Smart App Control)

モデルが表示されない

AI が応答しない

音声が出ない

ライセンスエラー

ここに載っていない問題は Synaptic Discord サーバー へ。Bot が 24 時間自動対応、必要に応じて開発者 (mizumaru) にエスカレーションされます。

お問い合わせ・サポート

質問、バグ報告、要望など、お気軽にどうぞ。

Kawaii Agent V2 © 2025-2026 miu-chang (miu sekiguchi). All rights reserved.