Poké-Battle

ポケモンバトル

FastAPI と Python で構築されたポケモンゲームです。Anthropic の Claude AI を活用して、創造的なバトル描写や攻撃のおすすめを提供し、捕まえたポケモンに個性的な性格を付与します。

技術スタック

• バックエンド: FastAPI、Uvicorn（ASGI サーバー）
• AI 統合: Anthropic の Claude API、カスタム AI サーバー（ai_server.py）およびクライアント（ai_client.py）
• 外部 API: PokeAPI
• フロントエンド: HTML、CSS、JavaScript（FastAPI によって配信）
• 依存関係: python-dotenv、httpx、websockets、Jinja2

セットアップ手順

1. リポジトリをクローンします:

   git clone <repository_url>
   cd <repository_directory>
   

2. 仮想環境を作成します:

   python -m venv .venv
   

3. 仮想環境を有効化します:

   • Windows の場合:

     .venv\Scripts\activate
     

   • macOS および Linux の場合:

     source .venv/bin/activate
     

4. 依存関係をインストールします:

   pip install -r requirements.txt
   

5. Anthropic API キーを設定します:

   • ルートディレクトリに .env という名前のファイルを作成します。
   • 次の形式で Anthropic API キーを追加します:

     ANTHROPIC_API_KEY=your_api_key_here
     

   注: セキュリティのため、特に本番環境では、.env ファイルに保存するのではなく、ホスティング環境が提供する環境変数を使って API キーを管理することをおすすめします。

6. AI サーバーを起動します: プロジェクトのルートディレクトリでターミナルを開き、次のコマンドを実行します:

   uvicorn ai_server:app --reload --port 8000
   

7. メインゲームサーバーを起動します: プロジェクトのルートディレクトリで新しいターミナルを開き（必要に応じて仮想環境を有効化し）、次のコマンドを実行します:

   uvicorn server:app --reload --port 8080
   

8. ブラウザーでゲームを開きます: http://localhost:8080 にアクセスします。

プロジェクト構成

• server.py: ゲームロジックを処理し、フロントエンドを配信するメインの FastAPI アプリケーションです。
• ai_server.py: Anthropic API との通信を処理する FastAPI アプリケーションです。
• ai_client.py: server.py が ai_server.py と通信するために使用する Python クライアントライブラリです。
• index.html: メインのフロントエンド HTML ファイルです。
• static/: 静的アセット（CSS、JavaScript、画像）用のディレクトリです（現在はディレクトリのみ存在します）。
• requirements.txt: Python の依存関係を記載しています。
• api.env: API キーを読み込む環境ファイルです（.gitignore に追加してください）。
• .gitignore: Git が無視する、意図的に追跡対象外とするファイルを指定します。

機能

• ポケモン捕獲: ランダムなポケモンを捕まえてチームを編成します。
• ポケモンバトル: ランダムな相手ポケモンとのターン制バトルです。
• AI バトル描写: Anthropic の Claude が生成する、バトル中のアクションに対する創造的な実況です。
• AI 攻撃のおすすめ: バトルで使う最適な技について、AI の提案を得られます。
• AI ポケモンの性格: 捕まえたポケモンには、それぞれ AI が生成した個性的な性格や背景設定が付与されます。
• リアルタイム更新: WebSocket 経由でゲームの状態やメッセージが更新されます。
• レスポンシブ UI: 捕まえたポケモンをより見やすく表示するための基本的な UI 調整が含まれています。