AITuberKitをローカルで起動する手順と前提

AIキャラ用のWebアプリを、自分のPCで動かすには何から始めればよいのでしょうか。AITuberKitの公式READMEでは、コードを取得してパッケージを導入し、開発モードで起動する手順が案内されています。この記事の到達点は、ブラウザーでローカルのアプリを開くところまでです。

開発環境として挙げられているのは、Node.js 24.xとnpm ^11.6.2。リポジトリの取得にはgit cloneを使うため、Gitコマンドを使える環境も必要です。

AITuberKitは、AIキャラクターとのチャット用Webアプリを構築するツールキットです。会話には各種LLMのAPIキーを使う構成が案内されています。LLMや音声合成、キャラクターモデルの詳しい設定は、今回の起動手順とは切り分けます。

まず、ターミナルで次の3つを順番に実行します。コードを取得し、作成されたaituber-kitフォルダへ移動して、パッケージをインストールする流れです。

git clone https://github.com/tegnike/aituber-kit.git
cd aituber-kit
npm install

次に、必要に応じて環境設定用の.envファイルを作成します。READMEでは、この工程は任意として記載されています。作成する場合は、同じフォルダで次のコマンドを実行します。

cp .env.example .env

準備ができたら、開発モードでアプリケーションを起動します。

npm run dev

その後、ブラウザーでhttp://localhost:3000を開きます。ここまでがREADMEに記載されたクイックスタートです。これは手元の環境でアプリを起動する手順であり、Web上へデプロイする操作ではありません。

初回セットアップが完了した後は、起動スクリプトをダブルクリックする方法も用意されています。WindowsではLAUNCH.bat、macOSではLAUNCH.commandを使います。

macOSで実行権限がない場合は、次のコマンドで権限を付けてから起動します。

chmod +x LAUNCH.command

ダブルクリックでの起動は、あくまでセットアップ完了後の操作です。初回のリポジトリ取得やパッケージ導入を省く手順ではありません。

Docker Composeが使える環境には、別の起動手順もあります。npmでの起動の代わりに、取得したリポジトリのフォルダで次のコマンドを順番に実行します。

cp .env.example .env
docker compose up -d

起動後に開くURLは、こちらもhttp://localhost:3000です。npmのクイックスタートでは.env作成が「必要に応じて」とされている一方、Dockerの手順では最初の工程として記載されています。

停止するときは、次のコマンドを使います。

docker compose down

Docker版についてREADMEが案内しているのは、.envの作成、Composeでの起動、URLへのアクセス、停止までです。Docker自体の導入手順は、この案内には含まれていません。

Web公開へ進む際は、APIキーの管理が追加の論点になります。READMEは、AIや音声合成サービスのAPIをバックエンドサーバー経由で呼び出す仕様として、適切なキー管理を求めています。

特に、OPENAI_API_KEYやCUSTOM_API_*などのサーバー側秘匿値、ログ保存、サーバー側TTS URLなどを公開APIから使う場合は、AITUBERKIT_SERVER_SECRET_ACCESS_MODEの設定が必須 です。未設定の場合、一部APIは403で拒否されます。この条件は、アプリの起動コマンドとは別に押さえる必要があります。

本番環境向けには、サーバー側でのAPIキー管理、利用者が自身のキーを使う場合の注意点の説明、必要に応じた認証・認可の実装が推奨されています。ローカルで画面が開いたことを、そのまま公開準備の完了とは扱わないのが重要です。

また、v2.0.0以降はカスタムライセンスです。商用目的の利用については、公式README内の利用規約を参照するよう案内されています。