AI-Gamble：動的に生成されるインタラクティブ・フィクション・ゲーム

AI-Gambleは、Large Language Modelling (LLM)に基づいたインタラクティブなフィクションゲームプラットフォームです。AI技術により、プレイヤーが選択したストーリージャンル（東洋ファンタジー、西洋マジックなど）に基づき、ユニークなストーリーライン、キャラクター、視覚的なストーリーライン図をリアルタイムで生成します。プレイヤーは、没入感のある分岐する物語を体験し、簡単な選択によって複数のストーリーエンディングを探索することができます。このプロジェクトは、FastAPIバックエンド、Vanilla JavaScriptフロントエンド、Mermaid.jsを使用してストーリー構造マップをレンダリングし、Dockerデプロイをサポートしており、インタラクティブなストーリーテリングとAI技術が好きなユーザーに適しています。システム全体は効率的で簡単に操作できるように設計されており、クイックスタートに適しています。

機能一覧

• ダイナミックなストーリー生成 AIは、プレイヤーが選択したストーリーのタイプに応じて、オープニング、展開、マルチエンディングをリアルタイムで生成し、東洋ファンタジーや西洋マジックなど、さまざまな文体に対応する。
• 作家と作品のランダム化 新しいゲームをプレイするたびに、ストーリーのタイプに合った仮想の「著者」と「書名」がランダムに生成され、楽しさと没入感を高めます。
• 視覚的なストーリーライン図 ゲーム開始時に、Mermaid.jsによってストーリー構造マップが生成され、フロントエンドに表示されます。これにより、プレイヤーはストーリーの分岐や結末を直感的に理解することができます。
• 枝分かれした物語 プレイヤーの選択ひとつひとつがストーリーの方向性を変え、さまざまなプロットや結末を導き、インタラクティブ性を高める。
• ダイナミックな文体 : AI 古代やファンタジーなど、物語の種類に応じて語り口を調整し、没入感を高める。

ヘルプの使用

設置プロセス

AI-GambleはDockerベースのプロジェクトで、インストールが簡単でローカルでの実行に適している。以下はインストールと使用方法の詳細です：

前提条件

• DockerとDocker Composeをインストールします。
• AIストーリー生成サービスを呼び出すための有効なOpenAI APIキーを用意する。

設定環境

1. 環境変数ファイルの作成 ::
   • プロジェクト利用 .env ファイルを作成し、OpenAI API キーなどの機密情報を保存します。
   • プロジェクトのルート・ディレクトリに、提供されているサンプル・ファイルをコピーする：

     # Windows
     copy .env.example .env
     # macOS/Linux
     cp .env.example .env
     

2. コンパイラ .env 書類 ::
   • 見せる .env ファイルに、OpenAIのAPIキーを入力します。
   • データベースの接続情報やRedisの設定など、必要に応じてその他の設定を変更する。

プロジェクトの開始

1. サービスの立ち上げと運営 ::
   • プロジェクトのルート・ディレクトリで、以下のコマンドを実行する：

     docker-compose up --build
     

   • このコマンドは、必要なイメージをプルし、FastAPIバックエンド、Redis、その他のサービスをビルドして起動します。
2. フロントエンドのスタイルをコンパイルする（オプション） ::
   • TailwindのCSSスタイルを変更する必要がある場合は、新しいターミナルを開いて実行してください：

     npm run build
     

   • このコマンドはリアルタイムでフロントエンドのスタイルファイルをリッスンし、コンパイルする。 tailwind.css.
3. アプリケーションへのアクセス ::
   • ブラウザを開き、次のサイトにアクセスする。 http://localhost:1888.
   • ページがロードされると、ゲームのメイン画面が表示され、ストーリーの種類を選択してゲームを開始することができる。

サービスの中止

• プレス Ctrl+C Dockerコンテナを停止する。
• 容器を洗浄する必要があれば、走ってください：

  docker-compose down
  

使用方法

新しいゲームを始める

1. 見せる http://localhost:1888をクリックし、ゲームのメイン画面に入る。
2. ストーリーの種類を選ぶ（例：「東洋ファンタジー」や「西洋マジック」）。
3. Start "ボタンをクリックすると、システムがAIを呼び出し、最初のシーン、バーチャルライター、書名、ストーリーラインマップを生成する。
4. インターフェイスには、ストーリーの冒頭のコンテンツと、Mermaid.jsによってレンダリングされたストーリー構造が表示され、分岐やエンディングの可能性が示される。

プレー

1. 現在のシーンのテキスト説明を読む。
2. プロンプトに従って選択肢を選ぶ（「森に入る」や「謎の男と話す」など）。
3. 選択肢を送信すると、AIがあなたの決定に基づいて次のセクションのストーリーを生成し、インターフェイスが更新されて新しいシーンが表示される。
4. ストーリーラインマップでは、現在進行中のブランチが動的にハイライトされるため、ストーリーの進行状況を簡単に把握することができる。
5. 物語がある結末を迎えるまで、選択を続ける。

ストーリーラインマップを見る

• ゲームのインターフェイスでは、Mermaid.jsは、すべての可能な分岐と結末を示すストーリーライン図をレンダリングします。
• ダイアグラム内のノードをクリックすると、対応するシナリオの簡単な説明がプレビューされます（APIでサポートされている場合）。
• チャートによって、プレイヤーは選択がストーリーの方向性に与える影響を理解することができる。

ゲームセッションの管理

• 新しいゲームを作る スルー POST /api/v1/game 新規ゲームを作成し、最初のシーンとストーリーマップを入手する。
• セレクションの提出 使用 POST /api/v1/game/{game_id}/choice次のシーンの選択を提出する。
• ステータス表示 スルー GET /api/v1/game/{game_id} 現在のWesthaven AI-Gambleを入手：動的に生成されるインタラクティブ・フィクション・ゲーム