AITuber OnAirの起動手順｜アバター選択から音声設定まで

AI VTuberを自分のPCで動かすには、何から用意すればよいのか。まず決めたいのは、アプリを用意する方法と、使うアバターの形式だ。

AITuber OnAirは、会話・音声・アバターなどを組み合わせるオープンソースのTypeScript製ツールキット。公式READMEには、公開Webアプリ、スターター作成、サンプルのローカル実行、個別パッケージの組み込みという使い方がある。

ここでは、自作アプリの雛形を作る方法と、1枚絵のサンプルを動かす方法を扱う。npmコマンドを実行できる環境が前提で、サンプルの取得にはgitも使う。対象はローカルでの起動と会話・音声設定までで、配信プラットフォームとの接続手順は含めない。

スターターにはPNGTuber、VRM、Live2Dなどのテンプレートがある。会話モデルを設定する前に、キャラクターをどの形式で表示するか決めておく。公式READMEの各サンプル説明では、使う素材は次のように分かれる。

開発元は、これらのサンプルの口の動きは、実際の出力音声に連動すると説明している。

4枚の状態画像を使うPNGTuberと、1枚の画像全体を動かす後述のSingle Image Avatar Chatは別のサンプルだ。口や目の差分を用意するか、まず1枚絵の動きを試すかで選び分けられる。

自作アプリの雛形は、CLIのcreate-aituber-onairで生成する。以下は、プロジェクト名をmy-aituberとして先に渡す例だ。

npm create aituber-onair@latest my-aituber

CLIではテンプレートと、依存関係をインストールするかを選ぶ。この手順では依存関係もインストールし、完了後に作成したディレクトリへ移動して起動する。

cd my-aituber
npm run dev

プロジェクト名も対話形式で決めたい場合は、最初のコマンドをnpm create aituber-onair@latestにする。

次節のサンプル起動は別の方法なので、両方を実行する必要はない。スターターを起動できたら、最後のSettings設定へ進む。

PNGやJPGを1枚だけ使いたい場合は、Single Image Avatar Chatのサンプルを利用する。READMEでは、ローカルで実行できるサンプルアプリとして案内されている。

スターター作成コマンドではなく、リポジトリを取得して該当ディレクトリで起動する手順だ。

git clone https://github.com/shinshin86/aituber-onair.git
cd aituber-onair/packages/core/examples/react-single-image-avatar-app
npm install
npm run dev

起動後はhttp://localhost:5173を開く。開発元は、TTSの出力音量に反応する、跳ねるようなBounceと穏やかに揺れるPuppet Wobbleの2種類の動きを選べると説明している。

このサンプルには、APIキーなしで使えるモーションプレビューがある。画像の動きだけを試す段階と、会話・音声生成のためにプロバイダーを設定する段階を分けて進められる。

アプリが開いたら、SettingsでLLMとTTSのプロバイダーを設定する。LLMは会話、TTSは読み上げに使うもので、アバター形式の選択とは別の設定だ。ローカルサンプルでは、SettingsにAPIキーとプロバイダーのオプションを入力する。

READMEは、各サンプルが共通のSettings UIと幅広いLLM・TTS対応を持つと説明している。パッケージ一覧では、会話用の@aituber-onair/chatにOpenAI・Claude・Geminiなど、音声用の@aituber-onair/voiceにVOICEVOX・VoicePeak・OpenAI TTSなどを挙げている。

プロバイダー別の詳細設定は、各パッケージのREADMEへ案内されている。APIキーの取得手順やサービスごとの料金・無料枠は、このREADME本文の掲載範囲には含まれていない。