インストール

まず CLI をインストールします。ゲームコードで Vifu API を使う場合だけ Vifu Hub SDK を追加します。

CLI

CLI は AI ネイティブゲームの作成、実行、テスト、ビルド、生成、公開に使います。

curl -fsSL https://docs.vifu.ai/cli | bash
vifu --help

インストーラーは macOS、Linux、または Windows shell 向けのネイティブ vifu バイナリをダウンロードします。Agent skill は別にインストールします。詳しくは Vifu Agent Skill を参照してください。ネイティブインストールが使えない場合は npm を使います。

npm install -g @vifu/cli@alpha
vifu --help

プロジェクト内の CLI として使う場合：

npm install --save-dev @vifu/cli@alpha
npx vifu --help

プロジェクトを作成する

npm create @vifu/vifu my-game -- --template vanilla --no-interactive
cd my-game
vifu deploy --yes

npm create @vifu/vifu がサポート対象のプロジェクト初期化コマンドです。公開 CLI コマンドとして vifu create や vifu new は提供していません。

既存のブラウザーゲームでは、次のように始めます。

cd path/to/your-game
vifu deploy --yes

deploy も、プロジェクト設定がない場合は自動で設定フローを開始します。CI では vifu deploy --yes で検出された既定値を使えます。

Vifu Hub SDK

Vifu Hub SDK はブラウザーゲームの中で使い、安全なセッションコンテキスト、イベント、ゲームが所有するアクションを Vifu に公開します。

npm

バンドラーやビルド手順があるゲームでは npm でインストールします。

npm install @vifu/hub@alpha

import * as hub from "@vifu/hub";

デプロイ用にログインする

vifu.ai でアカウントを作成してから実行します。

vifu login

ゲームディレクトリからデプロイします。

vifu deploy

次のステップ

• クイックスタート は最小のブラウザー連携です。
• Vifu Agent Skill は coding agent にワークフローを追加する方法を説明します。
• Vifu Hub SDK はブラウザー API を説明します。
• デプロイポリシー は実行成果物の検証ルールを説明します。