インストール

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

CLI

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

curl -fsSL https://vifu.dev/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 SDK

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

npm

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

npm install @vifu/sdk@alpha

import { createVifuSDK } from "@vifu/sdk";

CDN

jsDelivr からブラウザー用 build を読み込めます。デプロイするゲームでは SDK の正確なバージョンを使ってください。

<script src="https://cdn.jsdelivr.net/npm/@vifu/[email protected]/dist/browser/vifu-sdk.js"></script>
<script>
  const vifu = window.vifu;
</script>

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

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

vifu login

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

vifu deploy

次のステップ

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